httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Joshua Slive <sl...@finance.commerce.ubc.ca>
Subject Re: Converting docs to XHTML
Date Fri, 08 Dec 2000 00:50:13 GMT
I'm not sure how much DocBook gains us.  I can see the following benefits:
- easy conversion to non-html formats (like print)
- conformaty with other open-source projects.

Besides that, I don't see the advantage over XHTML.

If I were to imagine the ultimate format, it would be XML that was
specifically structured for our needs.  For example, a module doc could
look like

<module>
<module-name>mod_access</module_name>
<module-source-name>mod_access.c</module_name>
<summary>blah blah</summary>

<directive>
<directive-name>Allow</directive-name>
<directive-syntax>blah blah</directive>
...
</directive>

...
</module>

(I make no claim that this is actually XML.)



Mime
View raw message