[PATCH 1/2: xorg-sgml-doctools] Provide common CSS & XSL stylesheets for DocBook docs

Alan Coopersmith alan.coopersmith at oracle.com
Fri Jun 18 09:56:33 PDT 2010

Dan Nicholson wrote:
> It's a stretch to put the css files in this directory. The ent and xsl
> files make sense since xsltproc will search for them here and include
> them. Not so for the css file.
> I'm not sure what a better alternative would be, though. Just for a datapoint:
> $ find /usr/share/sgml -name '*.css' | wc -l
> 0
> Maybe pkgdatadir would be more appropriate, but I guess I'm OK
> overloading this path.

Yeah, I saw there were other .xsl files in that subdir on my machine, such as
the upstream docbook stylesheets, but didn't know where to put the .css.  Since
it's referenced in the .xsl putting in the same directory made the most sense to

>> +  <xsl:param name="saxon.character.representation" select="'entity;decimal'"/>
> This setting isn't really useful for xorg since we use xsltproc and
> not saxon. However, this appears to be the default value anyway:
> http://docbook.sourceforge.net/release/xsl/current/doc/html/saxon.character.representation.html

I don't remember why I put that in originally - it's been cargo-culted around as
this style sheet has been copied from module to module.

Once this is in git, I'll go back and apply changes similar to the libXmu patch
to replace the prior copies in app/xfs & lib/libXfont.

	-Alan Coopersmith-        alan.coopersmith at oracle.com
	 Oracle Solaris Platform Engineering: X Window System

More information about the xorg-devel mailing list