Bug#1072354: Manpage copied without updating title

Kamil Ignacak <[email protected]>
Newsgroups gmane.linux.debian.apt.devel
Message-ID <68cde672-89b0-4690-ae50-085a1487711d__44867.6336951152$1746383252$gmane$org@wp.pl>
Hi!

> APT-TRANSPORT-HTTP(1)                 APT                APT-TRANSPORT-HTTP(1)
>                   ^========================== "S" forgotten ===============^

The source code for the man page in 2.6.1 is here:
https://salsa.debian.org/apt-team/apt/-/blob/2.6.1/doc/apt-transport-https.1.xml?ref_type=tags
As you can see, the name of the component (apt-transport-https) is
present in a non-truncated form throughout document.

The name of the component, seen in a header of man page, is taken from
this tag in the document (line 20 of xml):
<refentrytitle>apt-transport-https</refentrytitle>

The source file is in DocBook format. The available reference suggests
that maximal length of a title (TH tag in roff markup language) is 20
chars:
  - https://cdn.docbook.org/release/xsl/snapshot/doc/manpages/man.th.title.max.length
  - /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/param.xsl -> man.th.title.max.length

Count of chars in "APT\-TRANSPORT\-HTTPS" (the escape chars are
necessary in roff document) is 21, which is truncated to 20 chars, and
the ending "S" letter is lost.

To sum up: this issue is a result of inevitable truncation, not a result
of a mistake during copying of files.

Kamil
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.