Bug#1072354: Manpage copied without updating title

Control: reopen 1072354
Control: tags 1072354 patch
Control: retitle 1072354 apt: man page title limit exceeded for apt-transport-https/mirror


On Tue, 10 Jun 2025 23:39:32 +0200 Guillem Jover <[email protected]> wrote:
> But this is not an inevitable truncation, docbook could be told to
> leave more room before truncation.

You are right, I have overlooked this.

I'm attaching a patch (1072354.patch) that increases the value of
relevant xsltproc parameter. The new value will lead to not truncating
of title in apt-transport-https, and in apt-transport-mirror.

> and I think it can also mess
> with the apropos scanning (?).

This doesn't seem to be the case. It looks like apropos matches searched
substrings in something other than a title:

acerion@debian:~$ apropos apt-transport-http
apt-transport-http (1) - APT transport for downloading via the Hypertext Transfer Protocol (HTTP)
apt-transport-https (1) - APT transport for downloading via the HTTP Secure protocol (HTTPS)
acerion@debian:~$ apropos apt-transport-https
apt-transport-https (1) - APT transport for downloading via the HTTP Secure protocol (HTTPS)

Kamil

diff --git a/CMake/Documentation.cmake b/CMake/Documentation.cmake
index d7f136020..c0f0ae7a6 100644
--- a/CMake/Documentation.cmake
+++ b/CMake/Documentation.cmake
@@ -140,6 +140,7 @@ function(xsltproc_one)
         --xinclude
         --stringparam chunk.quietly yes
         --stringparam man.output.quietly yes
+        --param man.th.title.max.length 22
         --path ${PROJECT_SOURCE_DIR}/vendor/${CURRENT_VENDOR}/
         --path ${CMAKE_CURRENT_SOURCE_DIR}/
     )