• Kir Kolyshkin's avatar
    Documentation: prettify the man page · 5c681734
    Kir Kolyshkin authored
    This adds a way to re-enable justification and hyphenation for
    the man page (which in enabled by default in troff but then
    Docbook explicitly disables it). The man page looks better this way.
    
    The reason why hyphenation for man pages is disabled by Docbook is
    "The problem is that groff is not particularly smart about how it
    does hyphenation; it can end up hyphenating a lot of things that you
    don't want hyphenated".
    
    The reason why justification for man pages is disabled by Docbook is
    "justified text looks good only when it is also hyphenated.
    Without hyphenation, excessive amounts of space often end up
    getting between words, in order to "pad" lines out to align
    on the right margin".
    
    I carefully checked the resuling man page using both terminal output
    on 80 columns and the PS/PDF generated. In both cases hyphenation
    looks normal, i.e. I don't see any unwanted cases of extra hyphenation.
    Same for justification.
    Signed-off-by: 's avatarKir Kolyshkin <kir@openvz.org>
    Reviewed-by: 's avatarCyrill Gorcunov <gorcunov@openvz.org>
    Signed-off-by: 's avatarPavel Emelyanov <xemul@virtuozzo.com>
    5c681734
Name
Last commit
Last update
..
.gitattributes Loading commit data...
.gitignore Loading commit data...
HOWTO.cross-compile Loading commit data...
Makefile Loading commit data...
asciidoc.conf Loading commit data...
criu.txt Loading commit data...
custom.xsl Loading commit data...