Re: [ANNOUNCE] GIT 1.5.3-rc4

From: Timo Hirvonen <tihirvon@gmail.com>
Date: Aug 4, 2007, 10:39 UTC
Message-ID: <20070804133923.eb84a308.tihirvon@gmail.com>
In-Reply-To: <7vfy2zj4nj.fsf@assigned-by-dhcp.cox.net>

Junio C Hamano <gitster@pobox.com> wrote:

Show 11 quoted lines

> It might be more worthwhile to research what other "Text-ish
> lightweight mark-up" systems are availble, and if there is one
> that is more efficient and can go to at least html and man,
> one-time convert our documentation source to that format using
> your Perl magic.  The minimum requirements are:
> 
>  * The source is readable without too much mark-up distraction;
> 
>  * Can go to roff -man;
> 
>  * Can go to html.

I used asciidoc too but it was really PITA to install and use so I wrote a small tool (ttman) in C which converts .txt files directly to man pages. It doesn't have html support but you could use man2html for that. Unfortunately it does not format as pretty html as asciidoc.

http://onion.dynserv.net/git/?p=cmus.git;a=tree;f=Doc;h=8ab4e92a6356d9cca0d738130fe54026da8c690b;hb=54b6ddacd9d1387c256ce5e7d7d8bb3324799c04

It might be quite easy to extend ttman to output html too...

-- 
http://onion.dynserv.net/~timo/