Dirk-Willem van Gulik wrote: 
> Because I'd eventually would like the GUI to be pulled of it as well, the
> XML is not quite complete yet, I am not too sure about the licence and I'd
> rather not go into the expense of DSSSL or full SGML unless I am sure that
> I need it. 
"The GUI pulled of it as well"? I thought the goal was to rewrite 
the server documentation in a format which preserved semantics 
better than HTML. DocBook is widely used (GNOME uses it and KDE 
seems to change from LinuxDoc to it) and the tools are available.

[snip]
> And quite frankly, DocBook seems overkill ? But I might be wrong ? It
> might help if you could show some examples. By all means the software is
> not (at this moment) the crucial bit, I'd just like to get the semantics
> of what one would put in such files more or less there.
Overkill in what sense?

I had an idea last year to make the configuration format an XML 
application (before I saw it on New-HTTPD) and then have modules 
supply their own DTD. This would allow them to extend the format 
for their own specific purposes and also make the configuration 
directly accessible by GUI tools. If this is close to what you 
are trying to do then you shouldn't use DocBook, but then the 
documentation is separate from this. IMO.

 /mill


-- 
#############################################################
# S-mail: Olof Oberg     #  [EMAIL PROTECTED]         #
#         Pedagoggr. 7A  #  [EMAIL PROTECTED]               #
#         S-907 30 Umea  #  [EMAIL PROTECTED]              #
# Phone:  090-197395     #  http://pedgr571.sn.umu.se/~mill #
#############################################################


Reply via email to