HomeMiscellaneousTesting the operating systemUDO in practice
User Manual UDO > The UDO syntax > Miscellaneous Index

Format-specific commands

UDO offers you the !raw command and the raw environment to insert special commands for a specific format. So you are able to insert small passages or huge blocks written in the destination format (like special tables for LaTeX or HTML).

You have to use abbreviations of the destination formates if you want to use the !raw command:

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)

The next example shows how to insert a line that will only be printed for the ASCII format:

!raw [asc] This line will only appear when converting to ASCII

The next example shows how to insert a line that appears in all formats except ASCII:

!ifndest [asc]
!raw [all] This line will not appear when convertign to ASCII
!endif

The contents of the line will be printed without the command and without converting the text of the line. These commands split up text into different paragraphs like all the other UDO commands. So these commands aren't useful to insert a line into a paragraph!

You can use these commands to insert special commands like parts of the preamble for LaTeX:

!no_preamble [tex]
!raw [tex] \documentstyle[11pt,makeidx]{article}
!raw [tex] \makeindex
[...]
!raw [tex] \printindex
The raw environment
But it happens that you want to insert large passages only for one format with special commands. You could add one of the upper commands at the beginning of each line, sure. But to make it easier for you to insert these passages UDO has a special environment for this case: the raw environment.
Together with the possibility to check the current destination format you can e.g. insert complex tables for LaTeX or forms for HTML with the raw environment. The following example shows how to enter HTML forms to your source code:
!ifdest [html]
!begin_raw

Name:

!end_raw !else The HTML version will display a form here. !endif
To say it once more: Text that is part of a raw environment is printed as is. That means that it is not converted and not indented. If you will insert the upper form source code into a verbatim environment you will see the source code in an HTML browser. But if you insert it inside a raw environment you will see the form!
Another choice you have is to use the command !rinclude.
The comment environment

If you want to write larger blocks in the output file as comments, it would be troublesome to start each line with a command.
Therefore UDO offers the "comment environment". It will be started with the command !begin_comment and ends with the command !end_comment.
As with the text of lines that start with the !comment command, UDO will write text inside this environment as comment to the destination file without converting special chars.
Another choice you have is to use the command !cinclude.

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

HomeMiscellaneousTesting the operating systemUDO in practice