.TH "yodlconverters" "1" "1996\-2017" "yodl_4\&.01\&.00\&.tar\&.gz" "Your Own Document Language"

.PP 
.SH "NAME"
yodl2\&.\&.\&. \- miscellaneous Yodl converters
.PP 
.SH "SYNOPSIS"

.PP 
\fByodl2\&.\&.\&.\fP [OPTION]\&.\&.\&. FILE
.PP 
.SH "DESCRIPTION"

.PP 
This manual page describes the various shell scripts that convert
documents in the Yodl language to other formats\&. The basic converters
are:
.IP o 
\fByodl2html\fP(1): converts to HTML, writes a file with the extension
\fB\&.html\fP\&.
.IP o 
\fByodl2man\fP(1): converts to nroff `man\(cq\& format, writes \fB\&.man\fP\&. Can
be further processed with e\&.g\&. \fBnroff \-Tascii \-man\fP
\fIfile\fP\fB\&.man\fP\&.
.IP o 
\fByodl2latex\fP(1): converts to LaTeX output, writes \fB\&.latex\fP\&. Can
be further processed with, e\&.g\&., \fBlatex\fP \fIfile\fP\fB\&.latex\fP\&.
.IP o 
\fByodl2txt\fP(1): converts to plain ASCII, writes \fB\&.txt\fP\&. This is a
very rudimentary converter, a last\-resort\&.

.PP 
\fBNOTE:\fP Starting with Yodl version 3\&.00\&.0 Yodl\(cq\&s default file inclusion
behavior has changed\&. The current working directory no longer remains fixed at
the directory in which Yodl is called, but is volatile, changing to the
directory in which a yodl\-file is located\&. This has the advantage that Yodl\(cq\&s
file inclusion behavior now matches the way \fBC\fP\(cq\&s \f(CW#include\fP directive
operates; it has the disadvantage that it may break some current
documents\&. Conversion, however is simple but can be avoided altogether if the
\f(CW\-L\fP (\f(CW\-\-legacy\-include\fP) option is used (see below)\&.
.PP 
.SH "OPTIONS"

.PP 
The options are identical to those of the \fByodl\fP(1) program\&.
.PP 
Additionally, the following options are available:
.IP o 
\f(CW\-\-no\-warnings\fP:
.br 
By default the converters call \fByodl\fP(1) using the \f(CW\-w\fP flag\&. The
option \f(CW\-\-no\-warnings\fP suppresses this flag\&.
.IP o 
\f(CW\-\-intermediate=<filename>\fP:
.br 
By default, files used for the communication between yodl and yodlpost
are removed following the conversion\&. The
\f(CW\-\-intermediate=<filename>\fP option may be provided to retain these
files, called \f(CW<filename>\fP and \f(CW<filename>\&.idx\fP\&.

.PP 
.SH "FILES"

.PP 
Each \fByodl2\fP\fIformat\fP converter requires a file \fIformat\&.yo\fP in Yodl\(cq\&s
include path (e\&.g\&., \f(CWtmp/wip/macros\fP)\&. This file is auto\-loaded before
\f(CWFILE\fP (see the synopsis) is loaded, to make the conversion to
\fIformat\fP possible\&.
.PP 
The output is written to one or more files having the extension
\fI\&.format\fP\&.
.PP 
.SH "SEE ALSO"

.PP 
\fByodlstriproff\fP(1), 
\fByodl\fP(1), 
\fByodlbuiltins\fP(7), 
\fByodlletter\fP(7), 
\fByodlmacros\fP(7), 
\fByodlmanpage\fP(7),
\fByodlpost\fP(1), 
\fByodlverbinsert\fP(1)\&.
.PP 
.SH "BUGS"

.PP 
\-
.PP 
.SH "AUTHOR"

.PP 
Frank B\&. Brokken (f\&.b\&.brokken@rug\&.nl),