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 <schwa...@usta.de> 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.

------------------------------------------------------------------------------
Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration & more
Get technology previously reserved for billion-dollar corporations, FREE
http://pubads.g.doubleclick.net/gampad/clk?id=190641631&iu=/4140/ostg.clktrk
_______________________________________________
vimb-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/vimb-users

Reply via email to