Re: Fix asciidoc callouts in git man pages

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



<opublikowany i wysłany>

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

-
: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]