Re: [vimb-users] manual page cleanup

[Daniel C. <dan...@gm...>]

Thank you for the patch and the information what's portable or not for man
pages. I must admit that I've never took the time to learn which of the troff
and groff marcros are portable.

-- 
Daniel Carl
Ingo Schwarze <sch...@us...> wrote:
> Hi,
> 
> here is a cleanup of the manual page.
> The patch applies to release 2.9.
> 
> Rationale, major points:
> 
>  * Esr's man-ext .SY macro is not portable.
>    Even esr himself recommends to copy the implementation
>    into the manual page itself if you *must* use it.
>    But in the case at hand, it does almost nothing,
>    so just use the portable .B instead.
>  * The glyph names \[char34] and \[char92] are not portable
>    at all, but internal, undocumented groff features at best,
>    and i'm surprised they work at all even with groff.
>    Better use the portable \(dq and \e.
> 
> Rationale, minor points:
> 
>  * The first .TH argument is by convention ALL CAPS.
>  * Use .PP and .sp as appropriate rather than blank lines.
>  * Drop useless .RS 0.
>  * New sentence, new line (sorry, that causes some churn).
>  * Some typos.