{"thread":{"id":"3986","subject":"Fix asciidoc callouts in git man pages","startedAt":"2006-04-28T13:13:37Z","lastAt":"2006-04-28T14:15:27Z","messageCount":3,"participants":["Sean Estabrooks","Jakub Narebski","sean"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"19224","messageId":"BAYC1-PASMTP1046BB48C01D83AC57A694AEB20@CEZ.ICE","threadId":"3986","inReplyTo":null,"subject":"Fix asciidoc callouts in git man pages","fromName":"Sean Estabrooks","fromEmail":"seanlkml@sympatico.ca","sentAt":"2006-04-28T13:13:37Z","receivedAt":"2006-04-28T13:13:37Z","isPatch":false,"sender":{"key":"seanlkml@sympatico.ca","avatar":"https://gravatar.com/avatar/f92923f54fc08c401fc59b71829d4b89e9b8087fbba45ff87c82e6a83aee02ae?d=mp&s=160"},"body":"\nStarted out just wanting to update the git-branch man page\nto include the \"-r\" option but noticed that the asciidoc \ncallouts weren't being rendered in its man page.  Then \nnoticed the same was true for all the man pages where\nthey are used. \n\nIt turns out we've not been following the guidelines \nproperly on how to use them.  The fact that they show up\nin a useful way in the html docs is really an accident.\nEven there they're not showing up as intended.\n\nUnfortunately, even after all the docs are fixed up to use\nthe proper format, they still don't render properly in the\nman format.   Seems this is a missing feature in the \"xmlto\"\ncommand.\n\nThe final patch in this series adds an xsl fragment which\nis passed to xmlto so that the callouts appear properly in \nthe man pages.\n\nSean\n\n Documentation/Makefile             |    2 +\n Documentation/callouts.xsl         |   16 ++++++++\n Documentation/everyday.txt         |   45 +++++++++++------------\n Documentation/git-branch.txt       |   57 ++++++++++++++++++++---------\n Documentation/git-checkout.txt     |   18 +++++----\n Documentation/git-diff.txt         |   38 ++++++++++---------\n Documentation/git-init-db.txt      |    8 ++--\n Documentation/git-log.txt          |    7 ++--\n Documentation/git-reset.txt        |   72 ++++++++++++++++++------------------\n Documentation/git-update-index.txt |   31 ++++++++--------\n 10 files changed, 163 insertions(+), 131 deletions(-)\n"},{"id":"19229","messageId":"e2t7f6$p1i$1@sea.gmane.org","threadId":"3986","inReplyTo":"BAYC1-PASMTP1046BB48C01D83AC57A694AEB20@CEZ.ICE","subject":"Re: Fix asciidoc callouts in git man pages","fromName":"Jakub Narebski","fromEmail":"jnareb@gmail.com","sentAt":"2006-04-28T14:06:06Z","receivedAt":"2006-04-28T14:06:06Z","isPatch":false,"sender":{"key":"jnareb@gmail.com","avatar":"https://avatars.githubusercontent.com/u/2706?v=4"},"body":"<opublikowany i wysłany>\n\nSean Estabrooks wrote:\n\n> Started out just wanting to update the git-branch man page\n> to include the \"-r\" option but noticed that the asciidoc\n> callouts weren't being rendered in its man page.  Then\n> noticed the same was true for all the man pages where\n> they are used.\n> \n> It turns out we've not been following the guidelines\n> properly on how to use them.  The fact that they show up\n> in a useful way in the html docs is really an accident.\n> Even there they're not showing up as intended.\n> \n> Unfortunately, even after all the docs are fixed up to use\n> the proper format, they still don't render properly in the\n> man format.   Seems this is a missing feature in the \"xmlto\"\n> command.\n> \n> The final patch in this series adds an xsl fragment which\n> is passed to xmlto so that the callouts appear properly in\n> the man pages.\n\nHave you sent bugreport/patch to the authors of asciidoc, by the way?\n\n-- \nJakub Narebski\nWarsaw, Poland\n"},{"id":"19230","messageId":"BAYC1-PASMTP11BA4F7CC68386E1F90F21AEB20@CEZ.ICE","threadId":"3986","inReplyTo":"e2t7f6$p1i$1@sea.gmane.org","subject":"Re: Fix asciidoc callouts in git man pages","fromName":"sean","fromEmail":"seanlkml@sympatico.ca","sentAt":"2006-04-28T14:15:27Z","receivedAt":"2006-04-28T14:15:27Z","isPatch":false,"sender":{"key":"seanlkml@sympatico.ca","avatar":"https://gravatar.com/avatar/f92923f54fc08c401fc59b71829d4b89e9b8087fbba45ff87c82e6a83aee02ae?d=mp&s=160"},"body":"On Fri, 28 Apr 2006 16:06:06 +0200\nJakub Narebski <jnareb@gmail.com> wrote:\n\n> Have you sent bugreport/patch to the authors of asciidoc, by the way?\n\nHave now ;o)   My xsl skills probably won't impress them any, but perhaps \nthey'll put some time into including the feature in a future release.\n\nCheers,\nSean\n"}]}