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