On Tue, 31 Jul 2018, Jon Trulson wrote: > So - is anyone on this list familiar with docbook XML want to take up the task > of upgrading our documentation format and generation to something from this > decade? > > Short term, using a new onsgmls is probably the way to go, but long term, it > seems clear we need to update to a proper, modern docbook XML.
I have zero clue about DtInfo and stuff, but I did some armchair grep research... Do we have "CDE: Information Manager Author's and Programmer's Guide" somewhere? - I see only "Help System Author's and Programmer's Guide" listed on a wiki). CDE 2.1 release boasts that DtInfo could be even made to work with different SGML DTDs, not only DocBook, so it is probably a pretty generic SGML tool. It seems that the documentation's SGML is almost the same as DocBook XML (XML is a subset of SGML), so they could be converted easily, but what about stylesheets and DTDs? There is a dtinfoStyle.dtd installed, which is an SGML DTD. We have a compontent called "mmdb" and "DtMmdb" - whatever it is doing, it has scary-looking "StyleSheet" directories. Is it for processing SGML stylesheets? I don't know who DtHelp is related (the distiction was always confusing me even in my orignal CDE days) but it seems it also uses some SGML internally. How much internally DtInfo format is based on SGML and its style sheets? Would that mean we would have to teach it to undrstand RELAX NG schemas or whatever XML brings to have the docs in XML? Marcin
smime.p7s
Description: S/MIME Cryptographic Signature
------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________ cdesktopenv-devel mailing list cdesktopenv-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/cdesktopenv-devel