OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: [docbook] Simply viewing DB

rob writes:
 > I came across a piece of free software documentation (and glad to  
 > find any documentation at all besides source code!) that from the  
 > file extension is SGML and from content of the first line is  
 > apparently a DocBook document.  I tended to go cross-eyed, however,  
 > when I tried to (human-) read the d___ thing.  Firefox shows a giant,  
 > undifferentiated and still partially marked-up blob of text.

It's probably a bit harsh to judge DocBook by the SGML sources of some
document. This is like evaluating your favourite ego-shooter's next
release by peeking at the source code. You wouldn't be impressed

DocBook is a markup language which is supposed to be transformed to
human-readable formats like PDF or HTML. Self-respecting
software projects that write their documentation as DocBook documents
always provide them in human-readable format.


Markus Hoenicka
(Spam-protected email: replace the quadrupeds with "mhoenicka")

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]