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

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



On Mon, Dec 19, 2016 at 02:39:27PM -0800, Ben Longbons wrote:
> Package: xterm
> Version: 327-2
> Severity: serious

severity's incorrect.

You should change that.

> 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).

I don't recall any bug reports on the topic.  The only to-do item for
ctlseqs.ms which I _have_ is a comment from a different person that at
least one item isn't ordered alphabetically.  I'm working on _that_,
now (another script to check the file).

ctlseqs.txt is part of the upstream sources, has been since June 2006.

Each time I make an update to ctlseqs.ms, I regenerate the ".txt" file
using the rule in the makefile.  If it's not, my test-builds would fail.

Since all of the upstream source has proper timestamps, there's
nothing to rebuild.  Debian builds from pristine upstream source, so
there's no reason for timestamp contamination, say, by pulling it from
someone's source repo.
 
> 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.

The makefile doesn't use -P.

> * -Tutf8 (better quotes/bullets; the VT fonts have everything they need).

no.  It's an ASCII file.  Pretty bullets don't help much, considering that
less than 1% of the file uses that.  For interesting typography, refer to
the PDF.

> * -Tpdf

You can do this with the makefile.

> * -Thtml
> 
> The html and pdf formats provide significant features not in the txt

groff's html format isn't useful.  I don't use that anymore:

	http://invisible-island.net/scripts/man2html.html

> version, though the PDF doesn't have a Table of Contents.

hmm - ms macros are said to support table of contents,

	https://www.hactrn.net/ietf/rfcgen/textms.html

but I've not found it necessary, e.g, generated with man2html plus
a post-processing script to construct the navigation area:

	http://invisible-island.net/xterm/ctlseqs/ctlseqs.html

> -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
> 

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

Attachment: signature.asc
Description: Digital signature


Reply to: