Skip to content

Commit d832f2a

Browse files
felipecgitster
authored andcommitted
doc: manpage: remove maximum title length
DocBook Stylesheets limit the size of the manpage titles for some reason. Even some of the longest git commands have no trouble fitting in 80 character terminals, so it's not clear why we would want to limit titles to 20 characters, especially when modern terminals are much bigger. For example: --- a/git-credential-cache--daemon.1 +++ b/git-credential-cache--daemon.1 @@ -1,4 +1,4 @@ -GIT-CREDENTIAL-CAC(1) Git Manual GIT-CREDENTIAL-CAC(1) +GIT-CREDENTIAL-CACHE--DAEMON(1) Git Manual GIT-CREDENTIAL-CACHE--DAEMON(1) NAME git-credential-cache--daemon - Temporarily store user credentials in @@ -24,4 +24,4 @@ DESCRIPTION GIT Part of the git(1) suite -Git omitted 2023-05-02 GIT-CREDENTIAL-CAC(1) +Git omitted 2023-05-02 GIT-CREDENTIAL-CACHE--DAEMON(1) Moreover, asciidoctor manpage backend doesn't limit the title length, so we probably want to do the same for docbook backends for consistency. Signed-off-by: Felipe Contreras <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent 48d89b5 commit d832f2a

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

Documentation/manpage-normal.xsl

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@
88
<xsl:param name="man.output.quietly" select="1"/>
99
<xsl:param name="refentry.meta.get.quietly" select="1"/>
1010

11+
<!-- unset maximum length of title -->
12+
<xsl:param name="man.th.title.max.length"/>
13+
1114
<!-- convert asciidoc callouts to man page format -->
1215
<xsl:template match="co">
1316
<xsl:value-of select="concat('\fB(',substring-after(@id,'-'),')\fR')"/>

0 commit comments

Comments
 (0)