Re: Fix asciidoc callouts in git man pages
<opublikowany i wysłany>
Sean Estabrooks wrote:
Show 19 quoted lines
> 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