Cleanup for manual page.
authorDaniel Carl <danielcarl@gmx.de>
Sat, 21 Feb 2015 20:39:47 +0000 (21:39 +0100)
committerDaniel Carl <danielcarl@gmx.de>
Sat, 21 Feb 2015 21:03:58 +0000 (22:03 +0100)
commit3360a5b2d836eca6eec1397da48e309bafd728b5
tree8db7db7681aae11aabd625044752f37dd6e67dc8
parent87ddae9ebd8b1ff5ad0b0d3a1d1d674e31dc96d6
Cleanup for manual page.

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.

Thanks Ingo Schwarze for this patch.
doc/vimb.1