Mark Johnson <[EMAIL PROTECTED]> writes: > The /usr/share/sgml tree would look like: > > /usr/share/sgml/ > declaration/ > dtd/ > entities/ > stylesheet/ > misc/ > ... > html/ > jade/ > tei/ > docbook/ > > The dtd/ and stylesheet/ dirs are for stuff that doesn't warrant it's own > subtree.
I don't know if I like this convention. I know it follows Debian current practice, but it diverges unnecessarily from the LSB spec for little benefit. Take for example the freebsd materials: catalog default.dsl freebsd.dsl freebsd.dtd freebsd41.dtd man-refs.ent Here we see a pretty common DocBook customization layer. It has entities, a DTD extending docbook (3.1 and 4.1), a stylesheet, and a catalog. In your scheme this would be split under the stylesheet and dtd subdirs, and I think that's a big minus. > THe docbook subdirectory looks like: Agreed. > /usr/share/sgml/docbook/dtd/xml/ > docbookx.CAT (for docbook-xml 3X & 4X) > (symlinks??) Yes -- Symlinks. 3.1 -> 3.1.7 as well as 3 -> 3.1.7. > DTDs derived from, or dependent on, a DTD should be in subdirectories > of the DTD. Selected sections of the docbook-xml tree would look > like: Agreed. > Note that the catalogs for a given package (*.CAT) are NOT in the > directories with the DTDs. They sit one level up--alongside the > versioned directories. Why? I strongly disagree with this. In your simplified docbook example: > /usr/share/sgml/docbook/dtd/xml/4.1.2/simple/ > sdocbookx.CAT > 4.1.2.1/ > 4.1.2.4/ Now it's unclear and confusing which Simplified Docboo, 4.1.2.1 or 4.1.2.4, the catalog file refers to. > Stylesheets are similar, but no versioned directories: Agreed. > I haven't yet thought about the super/central/localized catalogs. That > structure might need to be modified as well. Please retain focus on the layout of the /usr/share/sgml tree only. We must do one thing at a time or we'll never get anything done. > Entities need to be addressed, as well. I believe they already are addressed. Leave them with the DTDs they go with. Regarding standard entities, I don't know that we really have to diverge with LSB. -- .....Adam Di [EMAIL PROTECTED]<URL:http://www.onShore.com/>
