]> granicus.if.org Git - docbook-dsssl/commit
This change closes bug 2013441 and makes man-page output generally
authorMichael Smith <xmldoc@users.sourceforge.net>
Mon, 9 Feb 2009 16:22:14 +0000 (16:22 +0000)
committerMichael Smith <xmldoc@users.sourceforge.net>
Mon, 9 Feb 2009 16:22:14 +0000 (16:22 +0000)
commit720efa785ec3d333a41e68d594e1d15ba65d2dac
tree33d8cecf72a62bf9c8bf75db070d2aa2bc952a7d
parent757caefe125112207b847b33dcb244e13d8ab7d8
This change closes bug 2013441 and makes man-page output generally
usable again on Solaris and other platforms that use AT&T troff
instead of groff.

The change was to add man.output.better.ps.enabled parameter, with
its default value set to zero.

If the value of the man.output.better.ps.enabled parameter is
non-zero, certain markup is embedded in each generated man page
such that PostScript output from the man -Tps command for that
page will include a number of enhancements designed to improve the
quality of that output.

If man.output.better.ps.enabled is zero (the default), no such
markup is embedded in generated man pages, and no enhancements are
included in the PostScript output generated from those man pages
by the man -Tps command.

WARNING: The enhancements provided by this parameter rely on
features that are specific to groff (GNU troff) and that are not
part of "classic" AT&T troff or any of its derivatives. Therefore,
any man pages you generate with this parameter enabled will be
readable only on systems on which the groff (GNU troff) program is
installed, such as GNU/Linux systems.  The pages will not not be
readable on systems on with the classic troff (AT&T troff) command
is installed.

NOTE: The value of this parameter only affects PostScript output
generated from the man command. It has no effect on output
generated using the FO backend.

TIP: You can generate PostScript output for any man page by
running the following command:

man FOO -Tps > FOO.ps

You can then generate PDF output by running the following command:

ps2pdf FOO.ps
xsl/manpages/block.xsl
xsl/manpages/docbook.xsl
xsl/manpages/other.xsl
xsl/manpages/param.ent
xsl/manpages/param.xweb
xsl/manpages/refentry.xsl
xsl/manpages/utility.xsl
xsl/params/man.output.better.ps.enabled.xml [new file with mode: 0644]