46 lines
1.9 KiB
XML
46 lines
1.9 KiB
XML
<refentry xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
|
|
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
version="5.0" xml:id="man.break.after.slash">
|
|
<refmeta>
|
|
<refentrytitle>man.break.after.slash</refentrytitle>
|
|
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>man.break.after.slash</refname>
|
|
<refpurpose>Enable line-breaking after slashes?</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<src:fragment xml:id="man.break.after.slash.frag">
|
|
<xsl:param name="man.break.after.slash">0</xsl:param></src:fragment>
|
|
</refsynopsisdiv>
|
|
|
|
<refsection><info><title>Description</title></info>
|
|
|
|
<para>If non-zero, line-breaking after slashes is enabled. This is
|
|
mainly useful for causing long URLs or pathnames/filenames to be
|
|
broken up or "wrapped" across lines (though it also has the side
|
|
effect of sometimes causing relatively short URLs and pathnames to be
|
|
broken up across lines too).</para>
|
|
|
|
<para>If zero (the default), line-breaking after slashes is
|
|
disabled. In that case, strings containing slashes (for example, URLs
|
|
or filenames) are not broken across lines, even if they exceed the
|
|
maximum column widith.</para>
|
|
|
|
<warning>
|
|
<para>If you set a non-zero value for this parameter, check your
|
|
man-page output carefuly afterwards, in order to make sure that the
|
|
setting has not introduced an excessive amount of breaking-up of URLs
|
|
or pathnames. If your content contains mostly short URLs or
|
|
pathnames, setting a non-zero value for
|
|
<parameter>man.break.after.slash</parameter> will probably result in
|
|
in a significant number of relatively short URLs and pathnames being
|
|
broken across lines, which is probably not what you want.</para>
|
|
</warning>
|
|
|
|
</refsection>
|
|
</refentry>
|