# Fix asciidoc callouts in git man pages 3 messages from 2006-04-28 to 2006-04-28. Participants: Sean Estabrooks, Jakub Narebski, sean. Thread: https://gitlist.dev/t/3986 ## Sean Estabrooks, 2006-04-28 13:13 Subject: Fix asciidoc callouts in git man pages Message-ID: URL: https://gitlist.dev/e/BAYC1-PASMTP1046BB48C01D83AC57A694AEB20%40CEZ.ICE ``` Started out just wanting to update the git-branch man page to include the "-r" option but noticed that the asciidoc callouts weren't being rendered in its man page. Then noticed the same was true for all the man pages where they are used. It turns out we've not been following the guidelines properly on how to use them. The fact that they show up in a useful way in the html docs is really an accident. Even there they're not showing up as intended. Unfortunately, even after all the docs are fixed up to use the proper format, they still don't render properly in the man format. Seems this is a missing feature in the "xmlto" command. The final patch in this series adds an xsl fragment which is passed to xmlto so that the callouts appear properly in the man pages. Sean Documentation/Makefile | 2 + Documentation/callouts.xsl | 16 ++++++++ Documentation/everyday.txt | 45 +++++++++++------------ Documentation/git-branch.txt | 57 ++++++++++++++++++++--------- Documentation/git-checkout.txt | 18 +++++---- Documentation/git-diff.txt | 38 ++++++++++--------- Documentation/git-init-db.txt | 8 ++-- Documentation/git-log.txt | 7 ++-- Documentation/git-reset.txt | 72 ++++++++++++++++++------------------ Documentation/git-update-index.txt | 31 ++++++++-------- 10 files changed, 163 insertions(+), 131 deletions(-) ``` ## Jakub Narebski, 2006-04-28 14:06 Subject: Re: Fix asciidoc callouts in git man pages Message-ID: URL: https://gitlist.dev/e/e2t7f6%24p1i%241%40sea.gmane.org In-Reply-To: ``` Sean Estabrooks wrote: > Started out just wanting to update the git-branch man page > to include the "-r" option but noticed that the asciidoc > callouts weren't being rendered in its man page. Then > noticed the same was true for all the man pages where > they are used. > > It turns out we've not been following the guidelines > properly on how to use them. The fact that they show up > in a useful way in the html docs is really an accident. > Even there they're not showing up as intended. > > Unfortunately, even after all the docs are fixed up to use > the proper format, they still don't render properly in the > man format. Seems this is a missing feature in the "xmlto" > command. > > The final patch in this series adds an xsl fragment which > is passed to xmlto so that the callouts appear properly in > the man pages. Have you sent bugreport/patch to the authors of asciidoc, by the way? -- Jakub Narebski Warsaw, Poland ``` ## sean, 2006-04-28 14:15 Subject: Re: Fix asciidoc callouts in git man pages Message-ID: URL: https://gitlist.dev/e/BAYC1-PASMTP11BA4F7CC68386E1F90F21AEB20%40CEZ.ICE In-Reply-To: ``` On Fri, 28 Apr 2006 16:06:06 +0200 Jakub Narebski wrote: > Have you sent bugreport/patch to the authors of asciidoc, by the way? Have now ;o) My xsl skills probably won't impress them any, but perhaps they'll put some time into including the feature in a future release. Cheers, Sean ```