[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#880551: xterm: corrections to man page



On Thu, Nov 02, 2017 at 02:20:54AM -0400, G. Branden Robinson wrote:
> Package: xterm
> Version: 327-2 (but I prepared the diff against xterm-330)
> Severity: normal
> Tags: upstream
> 
> Hi Thomas,
> 
> Here's a patch for various markup bugs and inconsistencies in the xterm
> man page.
> 
> 01. The local macro definitions for bP and NS were testing the values of
>     registers which were likely to be undefined; e.g.
>       "./xterm-330/xterm.man:64: warning: number register `.I' not defined"

thanks - someone reported a problem with the same macro in ncurses.
(I'll have to make a script to check for other instances, since I've
used bullets in a lot of places - I've a to-do item for that anyway).

For the rest, I'll pick through in case there's something I find
that's an unnecessary groffism (but likely will just apply most/all of the
change).

>     Make them test instead simply for "n" (nroff mode, as opposed to
>     troff mode), since that appears to be the intention.
> 
> 02. Use the \(ha, \(ga, and \(ti character escapes instead of ^`~
>     literals, since these produce full-sized spacing glyphs instead of
>     small ones intended as combining characters on troff output devices.
> 
> 03. Use \- character escape in (especially in examples) when an ASCII
>     "hyphen-minus" is intended; ensures that the correct glyph can be
>     cut and pasted from the man page both from TTY and PDF output
>     devices.

:-)

It would have been nice if groff hadn't reversed common usage here.


-- 
Thomas E. Dickey <dickey@invisible-island.net>
https://invisible-island.net
ftp://ftp.invisible-island.net

Attachment: signature.asc
Description: Digital signature


Reply to: