Home Introduction Preface Do you need UDO?
 The guide of UDO
 Introduction

What UDO can('t) do for you

UDO has been originally developed to make it easier for you to write software documentations or other kinds of text files that have to be available in more than one format.

UDO can be a great help if you want to make a single destination format, too. A beginner will have less problems when learning the UDO syntax instead of learning LaTeX or HTML. So if you want to make LaTeX or HTML files it should be easier to get to know how to make them using UDO instead of writing them on your own. When writing LaTeX or HTML files you have to keep attention not to use any of their special command characters. In comparison to that UDO will convert these special characters for you when converting the source file to LaTeX or HTML. But this is not the only thing UDO can do for you.

UDO is a multilingual program. You can make texts in different languages. UDO knows how "Table of contents", "Appendix", "Figure" or "Table" is called in the other supported languages. The date is also printed out in the right way depended of the selected language.

The syntax of UDO is easy to learn. To make some small documentations you just have to learn about ten to fifteen commands; as many as you have to learn when you try to learn LaTeX or HTML.

Having written an UDO source file, you can convert it into the following formats:

amg AmigaGuide
hypertext system, used for documentation of Amiga programs
Commodore Amiga
 
aqv Apple QuickView
old hypertext format for Mac OS
Apple
 
asc ASCII
"Plain" Text
all
 
drc David's Readme Compiler
DOS program for creating menu-driven ReadMe's as EXE-programs
MS-DOS
 
hah HTML Apple Help

 
helptag HP-Helptag-SGML
SGML-based hypertext helpsystem for commercial Unices (HP-UX, Sun Solaris, IBM AIX)
Unix
 
html HTML (Hypertext Markup Language)
page description language – for websites, documentations and more
platform-independent
 
hh HTMLHelp
HTML-related format, for creation of HTML-Help files under windows
Win32
 
tex LaTeX 2.09, LaTeX2e
typesetting system, especially for scientific publications
many platforms
 
ipf OS/2 IPF
SGML-based text format for creating help files (INF, HLP) under OS/2
OS/2
 
linuxdoc Linuxdoc-SGML
Linuxdoc-SGML (recently: SGMLtools) is – like UDO – a multiformat converter which converts its own format to LaTeX, Manualpage, RTF, HTML, Texinfo...
Unix/Linux
 
lyx LyX
a LaTeX-related document processor
Unix/Linux
 
man Manualpage
Unix-/Linux-help pages for commandline programs
Unix/Linux
 
nroff NROFF
Unix-/Linux-help pages for commandline programs
Unix/Linux
 
pdflatex PDFLaTeX
for producing PDF files from LaTeX
diverse
 
ps PostScript
device-independent page description language, e.g. for printers; can also be used for producing PDF files (Ghostscript, Adobe Distiller)
several
 
pchelp Pure-C-Help
help system for the Pure C compiler
Atari ST
 
rtf RTF (Rich Text Format)
for exchanging text between different programs and platforms
several
 
c, pascal Sourcecode (C und Pascal)
the UDO source file will be converted to sourcecode, meaning normal text becomes comment, the content of the sourcecode environment becomes C-/Pascal-sourcecode.
several
 
stg ST-Guide
a hypertext system
Atari ST
 
info GNU Texinfo
for making online documentations, started with info 'command'
Linux, MiNTNet
 
v Turbo-Vision-Help
creating online helpfiles for DOS programs written with Borland's Turbo Vision-Library
MS-DOS
 
udo UDO
merges all UDO input files into one big file
all platforms with UDO-support
 
win, wh4 Windows-Help, WinHelp4
RTF-derived format for producing WinHelp files under Windows
Windows (Win16, Win32)
 

In most cases UDO doesn't make files that are ready to use because have to run a further software to view, print or convert the document. E.g. you have to convert the Windows Help source file (saved by UDO) with the Microsoft Help Compiler HC.EXE into a Windows Help file. Or you have to import the RTF file into a text processor to print it.


UDO tries to help the author of a documentation as much as possible. Next to the conversion into the destination format UDO offers you the following features:


UDO is not the perfect program for all purposes. The conversion to ASCII-text, ST-Guide, HTML, LaTeX and Windows Help is nearly perfect. Some formats (like Linuxdoc-SGML and LyX) are quite young and haven't been tested enough. You will surely find some aspects that have to be changed in the future.

There are some points that UDO can't manage yet but will be found on the wishlist: an automatically generated index, list of figures and list of tables.


To make complex files like newspapers is impossible with UDO because it can't wrap text around images and it can't generate files with two or more text columns. These functions are part of desktop publishing and not of a software like UDO.

UDO doesn't support an automatic syllabification. You have to tell UDO explicitely where it is allowed to split up words.

UDO is just a "one way" converter which converts it's own format into the formats listed above. UDO can't convert them into its own format.


Copyright © www.udo-open-source.org
Last updated on November 5, 2006

Home Introduction Preface Do you need UDO?