Bug#848818: xterm: ctlseqs.txt is not rebuilt from ctlseq.ms

[Ben Longbons <brlongbons@gmail.com>]

Package: xterm
Version: 327-2
Severity: serious
Justification: Policy 2.1

Dear Maintainer,

The ctlseqs.txt file is not built from ctlseqs.ms if it is modified
(which it should be, since it is wrong in a few places).

The command to bytewise-reproduce the existing file is:

$ groff -P{-c,-b,-o,-u} -Tascii -t -ms < ctlseqs.ms > ctlseqs.txt

Note: You need to add a build-dep on `groff`, not just `groff-base`,
in order to install the macro packages `-ms`.

But there are some *better* command variants.

* Remove the -P options to preserve formatting, less can handle it.
* -Tutf8 (better quotes/bullets; the VT fonts have everything they need).
* -Tpdf
* -Thtml

The html and pdf formats provide significant features not in the txt
version, though the PDF doesn't have a Table of Contents.

-Ben


-- System Information:
Debian Release: stretch/sid
  APT prefers unstable-debug
  APT policy: (500, 'unstable-debug'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386, x32, arm64

Kernel: Linux 4.8.0-2-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages xterm depends on:
ii  libc6           2.24-8
ii  libfontconfig1  2.11.0-6.7
ii  libice6         2:1.0.9-1+b1
ii  libtinfo5       6.0+20161126-1
ii  libutempter0    1.1.6-3
ii  libx11-6        2:1.6.4-2
ii  libxaw7         2:1.0.13-1
ii  libxft2         2.3.2-1
ii  libxinerama1    2:1.1.3-1+b1
ii  libxmu6         2:1.1.2-2
ii  libxpm4         1:3.5.11-1+b1
ii  libxt6          1:1.1.5-1
ii  xbitmaps        1.1.1-2

Versions of packages xterm recommends:
ii  x11-utils  7.7+3

Versions of packages xterm suggests:
ii  xfonts-cyrillic  1:1.0.4

-- no debconf information