[Date Prev][Date Next][Thread Prev][Thread Next]
- Subject: Re: Documentation Markup
- From: Robert Raschke <rtrlists@...>
- Date: Fri, 9 Oct 2009 14:25:19 +0100
On Fri, Oct 9, 2009 at 2:19 PM, steve donovan <email@example.com>
In fact, I bet you that a hundred lines of Lua will do the whole job
On Fri, Oct 9, 2009 at 3:06 PM, Robert Raschke <firstname.lastname@example.org
> can't remember the changes. It would probably be pretty trivial to change it
> to allow markdown.
nicely - pretty-printing can be done as an afterthought, using some
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.
LP does that in order to lift the ordering constraints your prog lang imposes. With modern languages this is no longer such a big concern. Although it is nice to be able to write LP code that has holes with neat readable placeholders which you fill in further down your document.
It is possible to write nice HTML, but you have to do it by hand (and not get carried away with typography :-). HTML editors create unreadable muck. At least I've not come across any that don't.