markdown 2 man, was Re: Git Community Book
- From
Johannes Schindelin <johannes.schindelin@gmx.de>
- Date
- Jul 30, 2008, 13:27 UTC
- Message-ID
- <alpine.LSU.1.00.0807301514280.3486@wbgn129.biozentrum.uni-wuerzburg.de>
- In-Reply-To
- <Pine.LNX.4.64.0807291957410.1779@reaper.quantumfyre.co.uk>
Hi,
On Tue, 29 Jul 2008, Julian Phillips wrote:
> there does exist at least one tool that claims to be able > to convert from markdown to man: http://johnmacfarlane.net/pandoc/
Just want to mention that it is written in Haskell, so chances are that it is even harder to install than asciidoc (I am thinking about non-Linux, of course).
Note also that Markdown cannot create TOCs automatically, AFAICT. So probably it would be not all that easy to convert the User Manual to that format.
If at all, I would have preferred a format switch to Wiki syntax so that we can use the same source on the Git wiki as in our Documentation/ directory. But such a switch could only come after a consensus of the Community anyway.
Ciao, Dscho