[Date Prev][Date Next][Thread Prev][Thread Next]
[Date Index]
[Thread Index]
- Subject: Re: Documentation Markup
- From: steve donovan <steve.j.donovan@...>
- Date: Fri, 9 Oct 2009 15:19:40 +0200
On Fri, Oct 9, 2009 at 3:06 PM, Robert Raschke <rtrlists@googlemail.com> wrote:
> can't remember the changes. It would probably be pretty trivial to change it
> to allow markdown.
In fact, I bet you that a hundred lines of Lua will do the whole job
nicely - pretty-printing can be done as an afterthought, using some
styling and client Javascript. One of those satisfying
rainy-afternoon jobs.
The thing about literate programming is that both the source and the
result must look pretty and read well. HTML is not nice in source,
although doing anything non-trivial in LuaDoc seems to require it.
Traditionally, LP uses tools to extract separate docs and code from
the same document, which seems fussy.
steve d.
