HomeIntroductionHow to read this manual bestDo you need UDO?
User Manual UDO > Introduction Index

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 platforms
c Sourcecode (C format)
The UDO source file will be converted to sourcecode, i.e. normal text becomes comment, the content of the sourcecode environment becomes C sourcecode.
several
drc David's Readme Compiler
DOS program for creating menu-driven ReadMe files as EXE-programs
MS-DOS
hah HTML format for Apple Help Books
Mac OS X
helptag HP-Helptag-SGML
SGML-based hypertext help system for commercial Unices (HP-UX, Sun Solaris, IBM AIX)
Unix
hh HTMLHelp
HTML-related format, for creation of HTML help files under windows
Win32
html HTML (Hypertext Markup Language)
page description language – for websites, documentations and more
platform-independent
info GNU Texinfo
for making online documentations, started with info 'command'
Linux, MiNTNet
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, etc.
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
pascal Sourcecode (Pascal format)
the UDO source file will be converted to sourcecode, i.e. normal text becomes comment, the content of the sourcecode environment becomes Pascal sourcecode.
several
pchelp Pure C Help
help system for the Pure C compiler
Atari TOS
pdflatex PDFLaTeX
for producing PDF files from LaTeX
several
ps PostScript
device-independent page description language, e.g. for printers; can also be used for producing PDF files (Ghostscript, Adobe Distiller)
several
rtf RTF (Rich Text Format)
for exchanging text between different programs and platforms
several
stg ST-Guide
a hypertext system
Atari TOS
tex LaTeX 2.09, LaTeX2e
typesetting system, especially for scientific publications
many platforms
udo UDO
merges all UDO input files into one big file
all platforms with UDO support
v Turbo-Vision-Help
creating online helpfiles for DOS programs written with Borland's Turbo Vision Library
MS-DOS
win, wh4 Windows-Help, WinHelp4
RTF-derived format for producing WinHelp files under Windows
Windows (Win16, Win32)

As you can see some formats are just interesting for specific systems/platforms, but you can also see that the list contains come formats that can be used on nearly any existing system/platform.

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 cannot 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 cannot wrap text around images and it cannot 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 Hyphenation. You have to tell UDO explicitely where it is allowed to split up words.

UDO is just a one way converter which converts it is own format into the formats listed above. UDO cannot convert them into its own format.


Copyright © www.udo-open-source.org (Contact)
Last updated on May 19, 2014

HomeIntroductionHow to read this manual bestDo you need UDO?