Daniel Leidert <[EMAIL PROTECTED]>, 2006-09-05 15:23 +0200:

> I thought about simply patching the docs in the debian package along
> with the param.xsl adding a notes

That assumes the users actually have installed docbook-xsl-doc and
that they are reading it instead of say, simply reading them over
the web at http://docbook.sourceforge.net/release/xsl/current/doc/

That doesn't seem to me to be a very good assumption to make.

> I don't think, that this should be put in upstream docs directly. I
> would maybe suggest (if you like the idea of reading the libpaper
> config), that you implement this in the XSL2 stylesheets using
> unparsed-text() of a file, set to /etc/papersize by default.

The DocBook XSL stylesheets are OS-agnostic, by design.
/etc/papersize is not a system-agnostic value to set as a default
in a set of stylesheets designed to work across platforms.

> The implementation for XSL1 is more a (working) workaround. But
> XSL2 offers the possibilities to do this, so it could be
> implemented.

We are a long, long way away from having a usable set of
stylesheets that rely on XSL2

> See above. Don't put anything system specific into the docs. It's also
> possible, that one day this patch will be dropped, because of a better
> solution or any issues and then upstream docs may be outdated (and
> wrong) then. So I really don't think it's a good idea to put this into
> upstream docs.

And my point is that if it's not put into the upstream docs (and
believe me, I'm not disagreeing that is shouldn't be), then it the
patch should be dropped from Debian. You otherwise will have users
who have no idea where the default value is coming from.

  --Mike

Attachment: smime.p7s
Description: S/MIME cryptographic signature

Reply via email to