This is DebianDoc-SGML, an SGML-based documentation formatting package used
for the Debian manuals.

To install it on a non-Debian system edit the Makefile and then run
`make', `make install'.

The changelog is in the debian subdirectory.

Ardo van Rangelrooij <ardo@debian.org>
Ian Jackson <ijackson@gnu.ai.mit.edu>

The `tools/bin/template' is parsed by `tools/bin/mkconversions' to create
all the debiandoc2* commands.  For debug purpose, `make diff' will create
`diff -u' for all the debiandoc2* commands against the current installed
version.  This functionality is added to help developer understand
implication of the `tools/bin/template' file.  

The default fixlatex script is a given way to override its behavior through 
-s option for some debiandoc2* commands. This is provided mostly for 
quicker debugging and not for the general use by the normal user.

Package requirements:

A few notes about required packages (especially for LaTeX processing (PS,
PDF formats)) to parse specific languages:

zh_TW (Traditional Chinese) uses kai font, Bg5 encoding,
  package tfm-arphic-bkai00mp
zh_CN (Simplified Chinese) uses kai font, GB encoding,
  package tfm-arphic-gkai00mp

Both tfm (Tex Font Metrics) depend on ttf packages (True Type Font).
cjk-latex package is required for these as well.
Apart from the kai font others (ming for zh_TW and sung for zh_CN) exist
but are NOT used by debiandoc-sgml (uses hardcoded fonts).

ko (Korean): package hlatex, hlatex-fonts-base and maybe for HTML (view
only, no build) ttf-baekmuk
cjk-latex is AFAIK not required (funny, since cjk stands for Chinese,
Japanese, Korean).

Please note that a ghostscript interpreter such as gs-gpl, gs-esp should
(not must) be installed too (required for PDF thumbnail generation).

Conversion functions back to normalized SGML and XML formats are 
available.  It is mostly working but may require some manual action.

Osamu Aoki <osamu@debian.org>

