Package: dblatex
Version: 0.3-2
Severity: wishlist
Tags: patch

"the option order is meaningful" is useless unless user is notified
priority order.  (I had to test it just to be sure.)

The patch is to the content of dblatex_0.3.orig.tar.bz2 .

These updates
 * docs/html/manual/re01.html
 * docs/manpage/dblatex.1.xml

Since diff for generated gzipped file is useless, I did not update
 * docs/manpage/dblatex.1.gz
   user stylesheet to use\. Several user stylesheets can be specified,
   but the option order is meaningful\.

This should be changed in the same way.  (Manually or using the method:
  http://www.debian.org/doc/manuals/maint-guide/dother.en.html#manpagexml

The English may need improvement by the native speaker but I hope intent
of change request is clear.


-- System Information:
Debian Release: 6.0.1
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages dblatex depends on:
ii  docbook-xml             4.5-7            standard XML documentation system 
ii  python                  2.6.6-3+squeeze6 interactive high-level object-orie
ii  python-apt              0.7.100.1        Python interface to libapt-pkg
ii  python-support          1.0.10           automated rebuilding support for P
ii  texlive                 2009-11          TeX Live: A decent selection of th
ii  texlive-bibtex-extra    2009-10          TeX Live: Extra BibTeX styles
ii  texlive-extra-utils     2009-10          TeX Live: TeX auxiliary programs
ii  texlive-latex-extra     2009-10          TeX Live: LaTeX supplementary pack
ii  texlive-math-extra      2009-10          TeX Live: Advanced math typesettin
ii  xsltproc                1.1.26-6         XSLT 1.0 command line processor

Versions of packages dblatex recommends:
ii  libxml2-utils               2.7.8.dfsg-2 XML utilities

Versions of packages dblatex suggests:
ii  docbook              4.5-4               standard SGML representation syste
ii  evince [pdf-viewer]  2.30.3-2            Document (PostScript, PDF) viewer
ii  ghostscript          8.71~dfsg2-9        The GPL Ghostscript PostScript/PDF
ii  imagemagick          8:6.6.0.4-3         image manipulation programs
ii  latex-cjk-all        4.8.2+git20090105-5 installs all LaTeX CJK packages
ii  lmodern              2.004.1-3           scalable PostScript and OpenType f
ii  opensp               1.5.2-8             OpenJade group's SGML parsing tool
ii  texlive-lang-cyrilli 2009-3              TeX Live: Cyrillic
ii  texlive-xetex        2009-11             TeX Live: XeTeX packages
ii  transfig             1:3.2.5.c-1         Utilities for converting XFig figu
ii  xpdf [pdf-viewer]    3.02-14             Portable Document Format (PDF) rea

-- no debconf information
diff -Nru dblatex-0.3-orig/docs/html/manual/re01.html dblatex-0.3/docs/html/manual/re01.html
--- dblatex-0.3-orig/docs/html/manual/re01.html	2010-04-05 09:08:59.000000000 +0900
+++ dblatex-0.3/docs/html/manual/re01.html	2011-05-21 18:12:05.204505795 +0900
@@ -70,7 +70,8 @@
           <code class="option">--xsl-user=<em class="replaceable"><code>xsl_user</code></em></code>
         </span></dt><dd>
             An <span class="application">XSL</span> user stylesheet to use. Several
-            user stylesheets can be specified, but the option order is meaningful.
+            user stylesheets can be specified.  The stylesheet specified by the later option is parsed first.  
+            The first definition always wins whenever there is a duplicate difinition.
             <span>See <a class="xref" href="sec-custom.html#sec-param" title="Using XSL Parameters">the section called &#8220;Using XSL Parameters&#8221;</a>.</span>
           </dd><dt><span class="term"><code class="option">-P <em class="replaceable"><code>param</code></em>=<em class="replaceable"><code>value</code></em></code>
         , </span><span class="term">
diff -Nru dblatex-0.3-orig/docs/manpage/dblatex.1.xml dblatex-0.3/docs/manpage/dblatex.1.xml
--- dblatex-0.3-orig/docs/manpage/dblatex.1.xml	2010-04-05 09:07:53.000000000 +0900
+++ dblatex-0.3/docs/manpage/dblatex.1.xml	2011-05-21 18:15:07.044506273 +0900
@@ -262,7 +262,8 @@
         <listitem>
           <simpara>
             An <application>XSL</application> user stylesheet to use. Several
-            user stylesheets can be specified, but the option order is meaningful.
+            user stylesheets can be specified.  The stylesheet specified by the later option is parsed first.
+            The first definition always wins whenever there is a duplicate difinition.
             <phrase output="manual">See <xref linkend="sec-param"/>.</phrase>
           </simpara>
         </listitem>

Reply via email to