udo

Name

udo - convert files from UDO into different formats

Synopsis

udo [-adDghHilmnpqrstvwWxy] source file
udo [-adDghHilmnpqrstvwWxy] -o destination file source file

Description

UDO converts files from the UDO format into Apple-QuickView, ASCII, HTML, Texinfo, Linuxdoc-SGML, Manualpage, Pure-C-Help, Rich Text Format, ST-Guide, LaTeX, Turbo Vision Help or Windows Help.

Using the first method UDO prints the destination format to the standard output (STDOUT) and error messages to the standard error output (STDERR). Using the second method UDO writes the destination format to the destination file and error messages to a log file with the suffix .ul?.

You have to pass single options to UDO: -al isn't the same as -a -l!

The name of the source file has to be the last option.

Options

-a, --ascii

The source file will be converted to ASCII.

-D symbol

Set the symbol `symbol' which can be tested in the source file with !ifset.

-g, --helptag

The source file will be converted to HP Helptag SGML.

-h, --html

The source file will be converted to HTML.

-H, --hold

You have to press a key before UDO finishes.

-i, --texinfo

The source file will be converted to GNU Texinfo.

--lyx

The source file will be converted to LyX.

-l, --no-logfile

When using the Option -o UDO doesn't save a log file.

-m, --man

The source file will be converted to a manualpage.

-n, --nroff

The source file will be converted to Nroff.

-o F, --outfile F

UDO writes the output into the file named "F".

-p, --pchelp

The source file will be converted to Pure C Help.

-q, --quiet

UDO won't print anything to STDOUT or STDERR.

-r, --rtf

The source file will be converted to RTF.

-s, --stg

The source file will be converted to ST-Guide.

-t, --tex

The source file will be converted to LaTeX.

-v, --vision

The source file will be converted to Turbo Vision Help.

-w, --win

The source file will be converted to Windows Help.

-W, --no-warnings

Warnings will be suppressed. Error messages will still be printed.

-x, --linuxdoc

The source file will be converted to Linuxdoc-SGML.

-y, --no-hypfile

UDO doesn't save a file with syllabification hints when using the option -o.

--help

Outputs a help page and quits.

--test

When using this option UDO won't save a destination file.

--tree

When using this option UDO will save a file with the suffix .ut?. In this file you will see a tree with all files your source file includes.

--verbose

UDO will print some status information wile converting the source file.

--version

Outputs version information and quits UDO.

Examples

udo file.u

Convert the source file `file.u' to ASCII (default) and print the output to the standard output and error messages to the standard error output.

udo --tex -o output.tex file.u

Convert the source file `file.u' to LaTeX and write the output to the file named `output.tex'. Warnings, error messages and additional information will be written to the log file named `output.ult'.

udo -s -y -l -o ! file.u

Convert the source file `file.u' to ST-Guide and write the output to `file.stg'. UDO won't save a log file or a file with syllabification patterns.

Environment

HOME

UDO looks for the file udo.ini in your home directory if UDOPATH doesn't exist.

LANG

Sets the language UDO shall use for error messages if neither LC_ALL nor LC_MESSAGES exists.

LC_ALL

If this is set to `german' UDO prints German messages. If this variable doesn't exist LC_MESSAGES it tested instead.

LC_MESSAGES

See LC_ALL. If this variable doesn't exist, too, LANG is tested instead.

UDOPATH

UDO looks for the file udo.ini in the directory defined by this variable. If UDOPATH doesn't exist HOME is tested instead.

Exit Status

0

Everything was OK.

>0

An error has appeared.