[waffle] waffle man pages & 80 columns

[Jordan Justen]

Debian's lintian tool is flagging a manpage-has-errors-from-man warning on:
* waffle_config.3
* waffle_context.3
* waffle_display.3
* waffle_is_extension_in_string.3
* waffle_window.3

I guess the issue is that these man pages have issues with reflowing
lines > 80 characters.

The usage of docbook gives an extra level of indirection in solving
this. :) Google did not provide any useful tips either.

Anyone have any thoughts on how to fix this?

-Jordan

This command show an example of how lintian detects this issue:
$ LC_ALL=en_US.UTF-8 MANROFFSEQ='' MANWIDTH=80 \
            man --warnings -E UTF-8 -l -Tutf8 -Z \
            man/man3/waffle_config.3 >/dev/null
<standard input>:43: warning [p 1, 2.5i]: can't break line
<standard input>:43: warning [p 1, 2.7i]: can't break line
<standard input>:47: warning [p 1, 3.5i]: can't break line
<standard input>:506: warning [p 6, 8.5i]: can't break line
<standard input>:516: warning [p 6, 9.5i]: can't break line
<standard input>:521: warning [p 6, 10.0i]: can't break line