Re: [Sbcl-devel] mostly convinced (Re: Yet Another Documentation Format Change)

[David L. <da...@li...>]

Quoting William Harold Newman (wil...@ai...):
> I'd like to continue to solicit comments for a few days, since even
> people who don't read sbcl-devel obsessively every few hours can have
> something to contribute, but then if nothing else comes up and...

Well, when I tried to use Docbook I ended up using either TeX or Plain
HTML instead...

But one advantage of XML formats is that existing tools can handle them.
There are XML parsers in Lisp.  And there is XSL to transform the XML
sources into anything else.  (Though I am not aware of a full XSL engine
in Lisp. :))

So even though I find the Docbook DTD to enforce very verbose and
somewhat inflexible XML documents, I would not disregard XML as such
because of that.  Inventing your own DTD is always an option.  For
example, start with a subset of HTML and add elements like <defun>.

Then write a simple XSL stylesheet to output HTML.

(Or implement a renderer for your format in Closure and print to
Postscript... :))


d.
--=20
o To emphasize the highly professional nature of Nmap, all instances
  of "fucked up" in error message text has been changed to "b0rked".
	-- http://www.insecure.org/stf/Nmap-3.50-Release.html