C source docs genarator

[Jirka Kosek]

Karel Zak wrote:

>  nemate nekdo typ na nejaky generator dokumentace z C zdrojaku. Rad
>  bych, aby vysledek byl XML DocBook (<reference>). Co jsem se koukal na 
>  doxygen, gtk-doc nebo kdoc tak bud se na podpore XML pracuje nebo se
>  pouziva SGML (gtk-doc). 

A to SGML, co leze z gtk-doc je DocBook? SGML dokument lze totiž snadno 
převést do XML pomocí prográmku sx (osx) z balíku sp (opensp). Ke 
stažení na jclark.com (openjade.sf.net).

>  Moc nechapu proc autori vetsiny generatoru tak moc miluji HTML, kdyz
>  je zde platforma jako je DocBook z daleko vetsim dosahem a myslim, ze
>  i budoucnosti.

Holt nemají takový přehled, jako my :-)
Možná to je tím, že lidé okolo C přijímají změny okolního světa 
pomaleji. Např. pro Javu existuje doclet, který umí generovat DocBook, 
dokonce umí i inline vložené HTML značky převést na DocBook. Dokumentace 
pro C# zdrojáky se také ukládá do XML, ze kterého jde třeba XSLT 
transformací snadno udělat DocBook.

-- 
-----------------------------------------------------------------
   Jirka Kosek  	
   e-mail: jirka na kosek.cz
   http://www.kosek.cz
------------- další část ---------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 3403 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://www.linux.cz/pipermail/docbook/attachments/20030804/410c742a/attachment.bin>