---
name: "yodl2html-post"
section: "1"
platform: "linux"
package: "yodl"
version: "1.31.18-7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/yodlconverters"
---

# yodl2html-post(1)

miscellaneous Yodl converters

Part of [yodlconverters(1)](/yodlconverters/1.md).

## NAME

yodl2... - miscellaneous Yodl converters

## SYNOPSIS

**yodl2...** \[OPTION\]... FILE

## DESCRIPTION

This manual page describes the various shell scripts that convert documents in the Yodl language to other formats. The basic converters are:

-

  - yodl2html:

  converts to HTML, writes a file with the extension **.html**.

-

  - yodl2man:

  converts to nroff \`man' format, writes **.man**. Can be further processed with e.g. **nroff -Tascii -man** *file***.man**.

-

  - yodl2ms:

  converts to nroff \`ms' format, writes **.ms**. Can be further processed with e.g. **nroff -T***format* **-mgs**  *file***.ms**; *format* being e.g., **ascii** or **ps**.

-

  - yodl2sgml:

  converts to SGML, writes **.sgml**. Implemented for backward compatibility at our site, producing output for our \`hacked  Linuxdoc-SGML mutant'.

-

  - yodl2tex:

  converts to LaTeX output, writes **.tex**. Can be further processed with, e.g., **latex** *file***.tex** and **xdvi** *file***.dvi**. This is the most complete Yodl converter.

-

  - yodl2texinfo:

  converts to texinfo, the GNU document standard.  writes **.texinfo**.

-

  - yodl2txt:

  converts to plain ASCII, writes **.txt**. This is a very rudimentary converter, a last-resort.

-

  The following second-stage converters are also implemented:

-

  - yodl2dvi:

  runs **yodl2tex**, and LaTeX-es the output file. When appropriate, re-runs LaTeX to solve labels; the LaTeX job is run up to  three times.

-

  - yodl2manless:

  runs **yodl2man**, and nroff's the output, piping  into a \`less'-like pager.

-

  - yodl2msless:

  runs **yodl2ms**, and nroff's the output into a  \`less'-like pager.

-

  Appropriate converters for given output formats, with examples, are:

-

  - For plain ASCII output:

  For manual pages: **yodl2manless** *file* **\>outfile**, \
   or gzipped: **yodl2manless** *file* **\| gzip -c \>outfile.gz**. \
   For other document types: **yodl2msless** *file* **\>outfile**. \
   Optionally, you can pipe the `yodl2..less` output through `striproff` to strip ASCII control characters such as underline or boldface.

-

  - For LaTeX and **.dvi** output:

  **yodl2tex** *file* to write *file***.tex**, or \
   **yodl2dvi** *file* to write *file***.tex** and *file***.dvi**.

-

  - For PostScript output:

  **yodl2msps** *file*, or \
   **yodl2dvi** *file* followed by **dvips -o***file***.ps** *file***.dvi**.)

-

  ## OPTIONS

The options are identical to those of the **yodl** program, which is the first-phase converter. Options may be:

- \-D, --define=NAME

      define NAME as symbol, same as

  ```
  DEFINESYMBOL(NAME)
  ```

- \-h, --help

  this message

- \-I, --include=DIR

  use directory **DIR** for system-wide includes files.

- \-l, --live-data=NR

  set

  live data

  policy to NR \[0\]:\
   allow live data:

- 0:

  never (the default)

- 1:

  only when confirmed

- 2:

  issuing warning

- 3:

  always

- \-o, --output=FILE

  send output to **FILE** instead of \<stdout\>

- \-P, --preload=CMD

      preload

  ```
  CMD
  ```

- \-p, --max-pass=NR

  set the maximum number of parsing passes to NR.

- \-t, --trace

  trace generated output to \<stderr\> for each parsing pass

- \-v, --verbose

  increase verbosity (-vv...)

- \-W, --warranty

  show warranty and copyright (It comes with **NO WARRANTY**!)

- \-w, --warn

  warn about redefinitions

## FILES

Each **yodl2***format* converter requires a file *format***.yo** in the standard include directory **/home/fred/usr/share/yodl**. This file is  auto-loaded to make the conversion to *format* possible.

Each *format***.yo** file in the standard include directory expects  other files; e.g., **shared.yo**, **aux-macros.yo**.

The output then goes to a file with an extension *.format*.

Some converters require post-processors, which are located in the standard  include directory and named **yodl2***format***-post**.

## SEE ALSO

-

  - o

  **[yodl(1)](/yodl/1.md)**: the first step converter.

-

  - o

  **[yodlmacros(7)](/yodlmacros/7.md)**: short description of the macros of the  converters.

-

  - o

  **yodlmanpage(1)**: description of the **manpage** document type.

-

  - o

  **[striproff(1)](/striproff/1.md)**: description of the `striproff` program.

-

  ## DIAGNOSTICS

Warnings and errors are too many to enumerate, but all errors are printed to *stderr* after which the converters exit with a non-zero status.

## BUGS

There may be bugs in the **yodl** program, but that's not very likely. More likely you'll encounter bugs or omissions in the macro package itself.

Send bug reports and fixes to the Yodl list: yodl@icce.rug.nl

## AUTHOR

Please consult the documentation file **AUTHORS.txt** for more detailed information, and small contributions.

- o

  Karel Kubat \<karel@icce.rug.nl\> http://www.icce.rug.nl/karel/karel.html

- o

  Jan Nieuwenhuizen \<janneke@gnu.org\> http://www.xs4all.nl/~jantien