How to find bugs in man pages?

How to find bugs in man pages?

[Xose Vazquez Perez]

Hi,

I'm using: groff -z -b -wall manpage.x

Is there anything better?


Thank you,
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: How to find bugs in man pages?

[Mike Frysinger]

[-- Attachment #1: Type: text/plain, Size: 146 bytes --]

On 19 Jun 2016 16:46, Xose Vazquez Perez wrote:
> I'm using: groff -z -b -wall manpage.x

seems like something we could add to `make check`
-mike

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 819 bytes --]

Re: How to find bugs in man pages?

[Michael Kerrisk (man-pages)]

Hi Mike,

On 21 June 2016 at 08:45, Mike Frysinger <vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org> wrote:
> On 19 Jun 2016 16:46, Xose Vazquez Perez wrote:
>> I'm using: groff -z -b -wall manpage.x
>
> seems like something we could add to `make check`

What's the advantage over the existing "man --warnings" check in the
"check-groff-warnings" target?

I see that the groff check above throws some warnings on pages that
aren't shown by "man --warnings":

==> "warning: invalid input character code" for Unicode input characters
==> "warning: indent cannot be negative" where I use ".in -4" in my
    feature test macro descriptions

But, I'm not sure that either of those warnings is helpful. Neither
seems indicative of a real problem, but maybe I misunderstand
something.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html