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

[Alan Coopersmith]

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
me.

>> +  <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