Control: tag -1 fixed-upstream

On Wed, Oct 07, 2015 at 06:29:21PM +0000, Bjarni Ingi Gislason wrote:
>    * What led up to the situation?
> 
>   On the web-page "lintian.debian.org", tag
> "manpage-has-errors-from-man" an example with this option is presented
> 
>    * What exactly did you do (or not do) that was effective (or
>      ineffective)?
> 
>   With environmental variables
> 
> MANOPT=--no-hyphenation --warnings=w --locale=POSIX
> MANWIDTH=40
> MAN_KEEP_STDERR=yes
> 
>   and command line
> 
> man -Z sed > /dev/null
> 
>    * What was the outcome of this action?
> 
>   no output is seen
> 
>    * What outcome did you expect instead?
> 
> The missing one
> 
> <standard input>:86: warning [p 2, 8.0i]: can't break line
> <standard input>:385: warning [p 7, 6.2i]: can't break line
> <standard input>:391: warning [p 7, 8.7i]: can't break line
> <standard input>:404: warning [p 7, 10.5i]: can't break line

It's a little more complicated than described in the subject line.
What's actually happening here is that -Z also implies a switch into
troff mode, defaulting to the PostScript renderer, and MANWIDTH is
ignored in that case.

This commit fixes that for man-db 2.7.4, so that -Z on its own doesn't
inhibit passing the line length options to groff:

  
http://git.savannah.gnu.org/cgit/man-db.git/commit/?id=de287dd0ee6aa134e8ae1db405d95a91a53ca74b

To entirely fix the bug at your end, though, you also need to fix your
command line.
https://lintian.debian.org/tags/manpage-has-errors-from-man.html
recommends a command line containing "-Tutf8 -Z", but for some reason
you have chosen to drop the -Tutf8 part of that.  The -Z option requests
a more raw invocation of groff than man usually uses, and its usual
logic for selecting the output device doesn't apply in this mode, so
without -Tutf8 you get groff's default output device, which is ps.  The
warnings don't seem to be quite entirely device-independent for some
reason I haven't investigated in detail, and you get a slightly
different set of warnings with and without -Tutf8.  With that option, it
should be closer to what lintian itself sees.

Thanks,

-- 
Colin Watson                                       [cjwat...@debian.org]

Reply via email to