Hi Michal,
Michal Mazurek wrote on Mon, Oct 24, 2011 at 11:02:05AM +0200:
> On Sun, Oct 23, 2011 at 02:14:02PM +0200, Ingo Schwarze wrote:
>> I committed build system changes to install source manuals
>> and no longer install formatted manuals from 5.0 onwards.
> This is nice, now I can do something like this in /etc/man.conf:
> < _build .[1-9n] /usr/bin/mandoc %s
> > _build .[1-9n] /usr/bin/mandoc -Owidth=`stty size |
> > awk '{print $2 - 2}'` %s
> to have the manpage fit my display. Especially usefull if I have split
> screen in a tiling window manager, and the terminals are smaller than 80
> columns.
Interesting, i never heard about anybody actually using the -Owidth
feature before, and i wouldn't recommend this for general consumption,
but if you feel adventurous, why not?
When using it this way, you should be aware of two facts:
(1) The layout of many manuals is optimized for display on
terminals of 80 columns, i.e. the default of -Owidth=78.
Many manuals will look ugly, to varying degree, when
constrained to a smaller width, in particular when
containing tables, columnated lists, or nested indents.
(2) The -Owidth option is tested rarely and may exhibit bugs,
even in stable versions. You are welcome to report these
to kristaps@ and myself, in particular if you encounter
crashes, but other bugs as well, of course.
Yours,
Ingo
