Package: docbook-xsl-ns Version: 1.76.0~RC1+dfsg-1 Severity: normal When using a funcsynopsis with language="C" or language="C++", the XSL-NS stylesheets default to a K&R representation of the function. This is a bad default. Almost no new code is written in K&R-style and ANSI-style is much, much more common. To my knowledge, C++ has never allowed K&R-style declarations, and so to represent a C++ function in that way is an error.
Also, DocBook has only existed since 1991, two years *after* the C89 ANSI standard took effect. The XSL-NS stylesheets are designed for DocBook 5, which was created over *twenty-five years* after this ratification. There is really no reason for DocBook to default to K&R. I see this with FO output as well as XHTML output. A test file that demonstrates this problem is available at <https://github.com/bk2204/drew/raw/documentation/doc/manual/hash.xml>. -- System Information: Debian Release: wheezy/sid APT prefers unstable APT policy: (500, 'unstable'), (1, 'experimental') Architecture: amd64 (x86_64) Kernel: Linux 2.6.39-rc7-amd64 (SMP w/2 CPU cores) Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages docbook-xsl-ns depends on: ii xml-core 0.13 XML infrastructure and XML catalog Versions of packages docbook-xsl-ns recommends: ii docbook-xsl-doc-html [docbook 1.75.2-1 stylesheets for processing DocBook ii docbook5-xml 5.0-2 standard XML documentation system Versions of packages docbook-xsl-ns suggests: pn dbtoepub <none> (no description available) ii docbook-xsl-saxon 1.00.dfsg.1-4 Java extensions for use with DocBo ii fop 1:1.0.dfsg-3 XML to PDF Translator ii libsaxon-java 1:6.5.5-7 Saxon XSLT Processor ii libxalan2-java 2.7.1-5 XSL Transformations (XSLT) process pn libxslthl-java <none> (no description available) pn xalan <none> (no description available) -- no debconf information -- brian m. carlson / brian with sandals: Houston, Texas, US +1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
signature.asc
Description: Digital signature
