In order to maintain consistency the docbook-xml-dtd ebuild should be installed to: /usr/share/sgml/docbook /etc/sgml/ instead of: /usr/share/xml/docbook /etc/xml/ All other docbook ebuilds are installed to these locations. In a related note, it would be nice to have an extra file added to /etc/env.d/ so that the catalog files are automatically added to the environment.
Howdy Sean, Is our current /etc/xml and /etc/sgml scheme known to break anything?
Matthew, No, it does not seem to be a problem in this regard. The only reason I brought it up is that docbook-xml-dtd is the only ebuild that uses these locations, while even docbook-xml-simple-dtd and docbook-xsl-stylesheets are installed to the standard /usr/share/sgml/docbook and /etc/sgml. It seemed to me that it would be more appropriate to keep all the docbook xml ebuilds installed in the same locations; either /usr/share/sgml or /usr/share/xml, not both. I guess I'm just finicky that way. Sorry for troubling you, Sean Bobb
Ah... okay. I see what you mean, and I do think it's worth a second look. Thanks
swamped by gcc3.1 stuff.. reassigning
Sean, OK, I had initially signed matt and me on to revamp the docbook stuff. With gcc-3.1 occupying Matt's time, it's now just me again. The thing is, I'm not so good with docbook, coz I've never used the stuff, and I dunno how to use it. So, would you be willing to have a close look at all the docbook stuff in portage and tell me what's wrong and what needs to be changed? As for the /etc/sgml and /etc/xml stuff, I'm inclined to agree with you. Thing is, should we just put everything into an sgml directory (xml is a subset of sgml right?) or should we have them separate?
added Sean to CC in case bugzilla is not aware to send him e-mail
Seemant, My Gentoo box is down right now, and it may be a few days before I can get it back up and running properly. For now, since gentoo is trying to follow the LSB, here is a link to the Docbook directory layout as described in a proposal for an Addendum to the LSB: http://www.bureau-cornavin.com/opensource/lsb-addendum/sgmlr002.html As far as I can remember, the only ebuild that doesn't use the LSB prescribed installation directories is docbook-xml-dtd. Sean Bobb
brilliant. Thanks for that link, Sean. That kinda clarifies things for me. Still have no idea what exactly docbook is and how to use it, but at least I know where the stuff's supposed to go :) What's wrong with the Gentoo box? Hardware issues?
Seemant, Briefly, Docbook is an all-encompassing DTD (Document Type Definition) that was created specifically for preparing documentation for computer hardware and software. As it is so thorough in scope, it has become a standard, and is frequently used by technical writers. My Gentoo box has had long-standing hardware issues that have only recently caused the failure of the entire system. I believe that the motherboard has finally given up the ghost. When I turn the power on the fans don't spin, not even after changing the power supply. Sean
punting to Azarah
Urk, I get all the boring ones *g*
Anybody around know what the "official" place is, and if it truely is /etc/sgml/ ? Also, is it also $SGML_CATALOG_FILES that needs to be updated ?
hmm.. not having the docbook xml dtd in /etc/sgml/catalog breaks psgml in emacs... I needed to add CATALOG /usr/share/xml/docbook/xml-dtd-4.1.2/docbook.cat to /etc/sgml/catalog to fix it in emacs... And jw (the jade wrapper) is also broken on my gentoo system (docbook2pdf doesnt work, etc..)
ok. as near as i can tell, /etc/xml needs to continue existing; the /etc/xml/docbook and /etc/xml/catalog files are incompatible with /etc/sgml/[catalog|docbook] . So, what I've done is changed the installation location of the DTDs to /usr/share/sgml and modified the catalog generation script. The new package is currently masked for testing.
unmasked. closing bug.
I do not concur with this decision. The FHS (http://www.samba.org/~cyeoh/) lists both /etc/xml/ and /usr/share/xml/ as directories that should exist for the XML versions of DocBook and related technologies. The separation is rather obvious, one is SGML technology, the other is XML. They use different backends and frontends in fact. sgmltools-lite won't work with XML, and neither will docbook-utils. I don't even know if OpenJade or OpenSP will. Anyway, with passivetex-1.25 (along with xmltex-1.9 and xmlto-1.4) entering the tree, I think it is a good time to fix this. The line from the LSB Addendum reads "This is the layout for a Jade-based or an Openjade-based system. Systems based on other SGML/XML computer programs can use this layout as well." which doesn't sound very authorative, and more related to precisely the SGML technologies. Further, the first paragraph in Chapter 1 has a warning attached to it stating "This document is still being heavily discussed. It is neither a standard nor a recommendation, and is currently being used only as a basis for further discussion." whereas the newly released FHS is in fact a final release (2.3).