[xml/sgml-commit] r695 - in packages/docbook2x/trunk/debian: .
examples patches
Daniel Leidert
dleidert-guest at alioth.debian.org
Tue Apr 10 19:26:25 UTC 2007
Author: dleidert-guest
Date: 2007-04-10 19:26:25 +0000 (Tue, 10 Apr 2007)
New Revision: 695
Added:
packages/docbook2x/trunk/debian/changelog
packages/docbook2x/trunk/debian/compat
packages/docbook2x/trunk/debian/control
packages/docbook2x/trunk/debian/copyright
packages/docbook2x/trunk/debian/docbook2x.doc-base
packages/docbook2x/trunk/debian/docbook2x.examples
packages/docbook2x/trunk/debian/examples/
packages/docbook2x/trunk/debian/examples/Makefile
packages/docbook2x/trunk/debian/examples/ttcn-el.dbk
packages/docbook2x/trunk/debian/patches/
packages/docbook2x/trunk/debian/patches/00list
packages/docbook2x/trunk/debian/patches/01_add_missing_documentation.dpatch
packages/docbook2x/trunk/debian/rules
Log:
Initially inject docbook2x (0.8.7-1) debian directory.
Added: packages/docbook2x/trunk/debian/changelog
===================================================================
--- packages/docbook2x/trunk/debian/changelog 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/changelog 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,113 @@
+docbook2x (0.8.7-1) experimental; urgency=low
+
+ * New upstream release 0.8.7 (closes: #292046).
+ - This release also doesn't fail to build any longer with the latest
+ libxml-sax-perl (closes: #409524).
+
+ [ Daniel Leidert ]
+ * debian/control (Uploaders): Added myself.
+ (Build-Depends): Added dpatch, opensp, sp and xsltproc and removed
+ libxslt1-dev.
+ (Build-Conflicts): Added tidy to avoid further tests.
+ * debian/copyright: Small update.
+ * debian/docbook2x.doc-base: Added for registering the docbook2X HTML docs
+ with doc-base.
+ * debian/rules: Removed simple-patchsys.mk inclusion and made the makefile
+ smaller. Added the dpatch ruleset to apply changes.
+ (common-install-prehook-arch, binary-install): Fixed. The info files come
+ with a INFO-DIR-SECTION entry. Further there is also info documentation
+ for the xslt stylesheets.
+ (binary-post-install): Removed a lot of obsolete stuff. The Perl stuff is
+ not longer installed. No CVS content is installed.
+ (binary-post-install, DEB_CONFIGURE_EXTRA_FLAGS): Replaced the manual
+ program/man-page renaming with adding --program-transform-name to
+ configure flags.
+ (clean): Removed unused stuff and improved the rest a bit.
+ * debian/patches/01_add_missing_documentation.dpatch: Added.
+ - This patch adds the missing docbook2{man,texi}.html files to the
+ documentation.
+ * debian/patches/00list: Added. Apply patch(es).
+
+ -- Daniel Leidert (dale) <daniel.leidert at wgdd.de> Sun, 25 Feb 2007 22:28:34 +0100
+
+docbook2x (0.8.3-1) unstable; urgency=low
+
+ * New upstream release. Removed all the patches that used to be in
+ debian/patches, since they have been applied upstream.
+ * debian/control:
+ - In Build-Depends, dropped libxml-perl and added libxml-sax-perl.
+ - Added Build-Conflicts on libxml2-utils, because the presence of
+ /usr/bin/xmllint triggers unecessary buildings in the doc
+ directory.
+ * debian/rules: Added an extra clean target for files left after building
+ the upstream package that are not removed by make clean. Also, make
+ sure that debian/examples is clean.
+
+ -- Rafael Laboissiere <rafael at debian.org> Sun, 18 Jul 2004 22:24:57 +0200
+
+docbook2x (0.8.2-6) unstable; urgency=low
+
+ * debian/control: Added dependencies on ${perl:Depends}, libxml-perl,
+ and libtext-wrapi18n-perl. The variable ${perl:Depends} is set by
+ dh_perl.
+
+ -- Rafael Laboissiere <rafael at debian.org> Thu, 29 Apr 2004 14:32:06 +0200
+
+docbook2x (0.8.2-5) unstable; urgency=low
+
+ * debian/patches/50-malocc-return.patch: Added this patch to fix a
+ serious upstream bug which was preventing the package of being built
+ by the ia64, hppa, sparc, and powerpc build daemons.
+
+ -- Rafael Laboissiere <rafael at debian.org> Thu, 29 Apr 2004 12:12:12 +0200
+
+docbook2x (0.8.2-4) unstable; urgency=low
+
+ * debian/control: Added build-dependency on texinfo, since the makeinfo
+ program is needed for building the package.
+
+ -- Rafael Laboissiere <rafael at debian.org> Sun, 25 Apr 2004 21:29:15 +0200
+
+docbook2x (0.8.2-3) unstable; urgency=low
+
+ * debian/control: Added build-dependency on libxml-perl.
+
+ -- Rafael Laboissiere <rafael at debian.org> Sun, 25 Apr 2004 17:09:09 +0200
+
+docbook2x (0.8.2-2) unstable; urgency=low
+
+ * debian/patches/50-gentext-dingbat-template.patch: Patch for
+ xslt/common/gentext.xsl, defining the lacking gentext-dingbat template
+ (closes: #245340).
+ * debian/patches/50-i-element.patch: Patch for xslt/texi/biblio.xsl,
+ fixing wrong <I> elements (closes: #245343).
+ * debian/patches/50-xml-fixes.patch: Patch for fixing XML problems in
+ the upstream files doc/docbook2X.xml and doc/faq.xml.
+ * debian/rules:
+ - Include cdbs' simple-patchsys.mk for coping with the patches above.
+ - Removed hard-coded Perl version from some installation directories
+ names. There is now a PERL_INSTALLPRIVLIB variable, properly
+ initialized through the Perl Config module (closes: #245291).
+ - Install Perl module in standard place, complying with the Debian
+ Perl Policy (closes: #245305).
+ - Run make clean in perl/XML/Handler directory to avoid inclusion of
+ extraneous patches in the Debian diff.gz file. Remove also
+ Makefile.old.
+ * debian/control:
+ - Added versioned build-dependency on libxslt1-dev. Also, changed
+ Build-Depends-Indep to Build-Depends, since the package is
+ Architecture: any (closes: #245285).
+ - Cite upstream URL homepage in debian/control in accordance with the
+ Debian Best Packaging Practices manual (closes: #245447)
+ - Added Uploaders field with Ardo, Wolfgang, and Rafael.
+
+ -- Rafael Laboissiere <rafael at debian.org> Sun, 25 Apr 2004 14:45:14 +0200
+
+docbook2x (0.8.2-1) unstable; urgency=low
+
+ * Initial package. Closes: #185295.
+ * The file install.xml is missing from the upstream archive, but is
+ available at the web site.
+ * Beware: <qandaset> can only be handled with defaultlabel attribute.
+
+ -- W. Borgert <debacle at debian.org> Sat, 13 Mar 2004 09:41:07 +0000
Added: packages/docbook2x/trunk/debian/compat
===================================================================
--- packages/docbook2x/trunk/debian/compat 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/compat 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1 @@
+4
Added: packages/docbook2x/trunk/debian/control
===================================================================
--- packages/docbook2x/trunk/debian/control 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/control 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,22 @@
+Source: docbook2x
+Section: text
+Priority: optional
+Maintainer: Debian XML/SGML Group <debian-xml-sgml-pkgs at lists.alioth.debian.org>
+Uploaders: Ardo van Rangelrooij <ardo at debian.org>, W. Borgert <debacle at debian.org>, Rafael Laboissiere <rafael at debian.org>, Daniel Leidert (dale) <daniel.leidert at wgdd.de>
+Build-Depends: debhelper (>= 4.2), cdbs (>= 0.4.21), dpatch, libxml-sax-perl, opensp, sp, texinfo, xsltproc
+Build-Conflicts: libxml2-utils, tidy
+Standards-Version: 3.7.2
+
+Package: docbook2x
+Architecture: any
+Depends: ${shlibs:Depends}, ${perl:Depends}, libxml-sax-expat-perl, libtext-wrapi18n-perl
+Recommends: docbook-xml, docbook-xsl
+Description: Converts DocBook/XML documents into man pages and TeXinfo
+ The main tools are:
+ * docbook2x-man: converts a DocBook/XML refentry into a manual page,
+ with table support
+ * docbook2x-texi: converts a DocBook/XML refentry into an info page,
+ most usable for Emacs users
+ .
+ Homepage: http://docbook2x.sourceforge.net/
+
Added: packages/docbook2x/trunk/debian/copyright
===================================================================
--- packages/docbook2x/trunk/debian/copyright 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/copyright 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,67 @@
+This package was debianized by W. Borgert <debacle at debian.org> on
+Sat, 2004-03-13 17:04:55 GMT 2004.
+
+It was downloaded from Sourceforge:
+
+ <URL:http://docbook2x.sourceforge.net/>
+
+Upstream Author:
+
+ Steve Cheng <stevecheng at users.sourceforge.net>
+
+Copyright:
+
+ Copyright (C) 2000-2006 Steve Cheng <stevecheng at users.sourceforge.net>.
+
+ Parts have been derived from the docbook-xsl stylesheet distribution, that
+ is:
+
+ Copyright (C) 1999, 2000, 2001, 2002 Norman Walsh.
+
+License and Warranty for docbook2X:
+
+ Permission is hereby granted, free of charge, to any person obtaining
+ a copy of this software and associated documentation files (the
+ "Software"), to deal in the Software without restriction, including
+ without limitation the rights to use, copy, modify, merge, publish,
+ distribute, sublicense, and/or sell copies of the Software, and to
+ permit persons to whom the Software is furnished to do so, subject to
+ the following conditions:
+
+ The above copyright notice and this permission notice shall be included
+ in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
+ OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ OTHER DEALNGS IN THE SOFTWARE.
+
+License and Warranty for derived parts:
+
+ Permission is hereby granted, free of charge, to any person
+ obtaining a copy of this software and associated documentation
+ files (the ``Software''), to deal in the Software without
+ restriction, including without limitation the rights to use,
+ copy, modify, merge, publish, distribute, sublicense, and/or
+ sell copies of the Software, and to permit persons to whom the
+ Software is furnished to do so, subject to the following
+ conditions:
+
+ The above copyright notice and this permission notice shall be
+ included in al copies or substantial portions of the Software.
+
+ Except as contained in this notice, the names of individuals
+ credited with contribution to this software shall not be used in
+ advertising or otherwise to promote the sale, use or other
+ dealings in this Software without prior written authorization
+ from the individuals in question.
+
+ Any stylesheet derived from this Software that is publically
+ distributed will be identified with a different name and the
+ version strings in any derived Software will be changed s that
+ no possibility of confusion between the derived package and this
+ Software will exist.
+
Added: packages/docbook2x/trunk/debian/docbook2x.doc-base
===================================================================
--- packages/docbook2x/trunk/debian/docbook2x.doc-base 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/docbook2x.doc-base 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,13 @@
+Document: docbook2X
+Title: docbook2X user documentation
+Author: Steve Cheng <stevecheng at users.sourceforge.net>
+Abstract: docbook2X converts DocBook documents into man pages and
+ Texinfo documents. This documentation contains the man-pages, a
+ quick start guide, the FAQ and some information about the
+ project (history).
+Section: Apps/Text
+
+Format: HTML
+Index: /usr/share/doc/docbook2x/docbook2X/docbook2X.html
+Files: /usr/share/doc/docbook2x/docbook2X/*.html
+
Added: packages/docbook2x/trunk/debian/docbook2x.examples
===================================================================
--- packages/docbook2x/trunk/debian/docbook2x.examples 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/docbook2x.examples 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1 @@
+debian/examples/*
Added: packages/docbook2x/trunk/debian/examples/Makefile
===================================================================
--- packages/docbook2x/trunk/debian/examples/Makefile 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/examples/Makefile 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,29 @@
+# -*- makefile -*-
+
+# Notes:
+# 1. you must have package libxml2-python2.3 installed
+# 2. your document must have a titleabbrev in the refentryinfo
+# 3. your document must have a refmiscinfo with role=infodirsection
+
+XTR=python -c 'import sys, libxml2; \
+print libxml2.parseFile(sys.argv[1]).xpathEval(sys.argv[2])[0].content'
+
+all: $(patsubst %.dbk,%.info,$(wildcard *.dbk))
+
+%.info: %.dbk
+ docbook2x-texi --info --to-stdout $< | \
+ awk -v base=`basename $< .dbk` \
+ -v sect="`${XTR} $< '//refmiscinfo[@role="infodirsection"]'`" \
+ -v title="`${XTR} $< '/refentry/refentryinfo/titleabbrev'`" \
+ 'BEGIN { p=1 } \
+ /^START-INFO-DIR-ENTRY/ { print \
+ "INFO-DIR-SECTION " sect "\n" $$0; p=0 } \
+ /^END-INFO-DIR-ENTRY/ { p=1 } \
+ /^\* / { if (p==0) { gsub(/.*\./, ""); \
+ print "* " title ": (" base ")." $$0 } } \
+ /^File: stdout,/ { if (p==1) { \
+ gsub(/File: stdout/, "File: " base ".info"); p=2 } } \
+ { if (p) { print } }' > $@
+
+clean::
+ rm -f *.info *~
Added: packages/docbook2x/trunk/debian/examples/ttcn-el.dbk
===================================================================
--- packages/docbook2x/trunk/debian/examples/ttcn-el.dbk 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/examples/ttcn-el.dbk 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+ <!ENTITY debian "<productname>Debian GNU/Linux</productname>">
+ <!ENTITY emacs "<abbrev>GNU Emacs</abbrev>">
+ <!ENTITY ttcn3 "<acronym>TTCN-3</acronym>">
+ <!ENTITY ttcnmp "<acronym>TTCN.MP</acronym>">
+]>
+
+<!-- Manual page for ttcn-el, DocBook source file (C) 2000 W. Borgert
+ debacle at debian.org
+
+ $Id: ttcn-el.dbk,v 1.1 2007/02/24 06:33:26 dleidert-guest Exp $ -->
+
+<refentry>
+ <refentryinfo>
+ <title>&emacs; modes for protocol testing languages</title>
+ <titleabbrev>TTCN-3 mode</titleabbrev>
+ <address>
+ <email>debacle at debian.org</email>
+ </address>
+ <author>
+ <firstname>W.</firstname>
+ <surname>Borgert</surname>
+ </author>
+ <copyright>
+ <year>2000</year>
+ <holder>W. Borgert</holder>
+ </copyright>
+ <date>2000-07-28</date>
+ </refentryinfo>
+ <refmeta>
+ <refentrytitle>ttcn-el</refentrytitle>
+
+ <manvolnum>7</manvolnum>
+ <refmiscinfo role="infodirsection">Development</refmiscinfo>
+ </refmeta>
+ <refnamediv>
+ <refname>ttcn-el</refname>
+
+ <refpurpose>&emacs; modes for protocol testing languages.</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>ttcn-3-mode</command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>ttcn-mode</command>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>tm-functions</command>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>Description</title>
+
+ <para>The programming modes <command>ttcn-3-mode</command>,
+ <command>ttcn-mode</command>, and
+ <command>tm-functions</command> for &emacs; are for programming
+ in the &ttcn3;, core language (Testing and Test Control Notation
+ - 3), &ttcnmp; format (Tree and Tabulart Combined Notation), or
+ the Test Manager scripts, an enhancement to the Forth
+ programming language, used in the Tektronix
+ <productname>K1297</productname> protocol tester.</para>
+
+ <para>The &ttcn3; programming mode
+ (<command>ttcn-3-mode</command>, file
+ <filename>ttcn3.el</filename>) does indentation, code
+ colourisation (so-called font-locking) and gives you an index of
+ test cases and other important definitions via the
+ <guimenu>Module-Index</guimenu>. With the command
+ <command>ttcn3-parse</command> you can run an external
+ TTCN3Parser or ttthreeparser, if available. The keywords are
+ according to the TTCN-3 BNF of 2001-10. To switch off the logo
+ splash screen, set the variable
+ <varname>ttcn3-show-logo</varname> to <constant>nil</constant>
+ in your <filename>~/.emacs</filename> file. The logo is by
+ Patrick Andrieu, the ASCII art version by W. Borgert. This mode
+ is based on <productname>CC Mode</productname>, please look in
+ the <productname>CC Mode</productname> documentation for further
+ information.</para>
+
+ <para>The &ttcnmp; programming mode (<command>ttcn-mode</command>,
+ file <filename>ttcn.el</filename>) is not for writing test
+ suites from scratch, but for fixing small errors or doing little
+ changes or just looking at the MP format. No indentation is
+ done, but some code colourisation, an index, and a menu with
+ some navigation functions are given. Note: For large test
+ suites startup might become very slow.</para>
+
+ <para>If one want that &emacs; treats files with the
+ <filename>.mp</filename> extension automatically as
+ &ttcnmp; files instead of MetaPost files, add the following
+ lines to your <filename>~/.emacs</filename> file:
+ <programlisting>(setq auto-mode-alist
+ (cons '("\\.mp\\'" . ttcn-mode) auto-mode-alist))</programlisting>
+ </para>
+
+ <para>The Test Manager programming functions
+ (<command>tm-functions</command>, file <filename>tm.el</filename>)is
+ an addition to the Forth programming mode
+ (<command>forth-mode</command>, file
+ <filename>forth.el</filename>). It includes only minor
+ additions to the regular Forth mode, i.e. font-locking, index
+ menu, and support of the Test Manager specific words.</para>
+
+ <para>To enable the <command>tm-functions</command> by default,
+ add the following line to your
+ <filename>~/.emacs</filename>:
+ <programlisting>(add-hook 'forth-mode-hook 'tm-functions)
+ </programlisting></para>
+
+ </refsect1>
+ <refsect1>
+ <title>Files</title>
+
+ <para>All lisp source files are in
+ <filename>/usr/share/emacs/site-lisp/ttcn-el/</filename>.</para>
+ </refsect1>
+ <refsect1>
+ <title>Author</title>
+
+ <para>These programmes are made by <author><firstname>W.</firstname>
+ <surname>Borgert</surname></author>
+ <<email>debacle at debian.org</email>>, as well as this
+ documentation.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>Thanks</title>
+
+ <para>All important ideas and some code are taken from other
+ &emacs; modes, and adapted to work with TTCN-3, &ttcnmp; and
+ Test Manager files. Thanks to Csaba Koppany and Theofanis
+ Vassiliou-Gioles for valuable hints on current TTCN-3 keywords
+ and regular expressions.</para>
+
+ </refsect1>
+ <refsect1>
+ <title>Copyright</title>
+
+ <para>Copyright 2000 W. Borgert and released under the
+ <acronym>GNU</acronym> General Public License
+ (<abbrev>GPL</abbrev>). Permission is granted to copy,
+ distribute and/or modify this document under the terms of the
+ <acronym>GNU</acronym> Free Documentation License, Version 1.1;
+ with no Invariant Sections, no Front-Cover Texts and no
+ Back-Cover Texts.</para>
+ </refsect1>
+ <refsect1>
+ <title>Bugs</title>
+
+ <para>The indentation is not correct in many cases.</para>
+ </refsect1>
+ <refsect1>
+ <title>History</title>
+
+ <para>Version 0.6 released on 2001-10-10. Updated
+ keywords.</para>
+
+ <para>Version 0.5 released on 2001-05-05. Updated
+ keywords.</para>
+
+ <para>Version 0.4 released on 2001-02-02. Calls external
+ parser.</para>
+
+ <para>Version 0.3 released on 2001-01-31.
+ <filename>ttcn3.el</filename> should now work with GNU Emacs
+ 21.0 and XEmacs 21.1, too.</para>
+
+ <para>Version 0.2 released on 2000-07-28. Includes updates for
+ &ttcn3; keywords in <filename>ttcn3.el</filename> and makes
+ <filename>tm.el</filename> a function library instead of a major
+ mode.</para>
+
+ <para>Version 0.1 released on 2000-03-31. Initial release.</para>
+ </refsect1>
+</refentry>
Added: packages/docbook2x/trunk/debian/patches/00list
===================================================================
--- packages/docbook2x/trunk/debian/patches/00list 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/patches/00list 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1 @@
+01_add_missing_documentation
Added: packages/docbook2x/trunk/debian/patches/01_add_missing_documentation.dpatch
===================================================================
--- packages/docbook2x/trunk/debian/patches/01_add_missing_documentation.dpatch 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/patches/01_add_missing_documentation.dpatch 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,349 @@
+#! /bin/sh /usr/share/dpatch/dpatch-run
+## 01_add_missing_documentation.dpatch by Daniel Leidert (dale) <daniel.leidert at wgdd.de>
+##
+## All lines beginning with `## DP:' are a description of the patch.
+## DP: There is a packaging bug so that docbook2man.html and docbook2texi.html
+## DP: are missing in the source package. We simply add it here and install
+## DP: it to the right location too.
+
+ at DPATCH@
+diff -urNad docbook2x-0.8.7~/doc/Makefile.in docbook2x-0.8.7/doc/Makefile.in
+--- docbook2x-0.8.7~/doc/Makefile.in 2007-02-24 06:57:24.000000000 +0100
++++ docbook2x-0.8.7/doc/Makefile.in 2007-02-24 18:04:30.000000000 +0100
+@@ -213,7 +213,8 @@
+ db2x_manxml.html db2x_texixml.html db2x_xsltproc.html \
+ sgml2xml-isoent.html docbook2X.html faq.html manpages.html \
+ texinfo.html todo.html utf8trans.html xsltproc.html \
+- performance.html install.html dependencies.html
++ performance.html install.html dependencies.html \
++ docbook2man.html docbook2texi.html
+
+ MAN_FILES = db2x_manxml.1 db2x_texixml.1 db2x_xsltproc.1 utf8trans.1 \
+ docbook2man.1 docbook2texi.1 sgml2xml-isoent.1
+diff -urNad docbook2x-0.8.7~/doc/docbook2man.html docbook2x-0.8.7/doc/docbook2man.html
+--- docbook2x-0.8.7~/doc/docbook2man.html 1970-01-01 01:00:00.000000000 +0100
++++ docbook2x-0.8.7/doc/docbook2man.html 2006-04-18 21:12:57.000000000 +0200
+@@ -0,0 +1,122 @@
++<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
++<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /><title>docbook2X: docbook2man</title><link rel="stylesheet" href="docbook2X.css" type="text/css" /><link rev="made" href="mailto:stevecheng at users.sourceforge.net" /><meta name="generator" content="DocBook XSL Stylesheets V1.68.1" /><link rel="start" href="docbook2X.html" title="docbook2X: Documentation Table of Contents" /><link rel="up" href="manpages.html" title="docbook2X: Converting to man pages" /><link rel="prev" href="manpages.html" title="docbook2X: Converting to man pages" /><link rel="next" href="db2x_manxml.html" title="docbook2X: db2x_manxml" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">docbook2man</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="manpages.html"><< Previous</a> </td><th width="60%" align="center">Converting to man pages</th><td width="20%" align="right"> <a accesskey="n" href="db2x_manxml.html">Next >></a></td></tr></table><hr /></div><div class="refentry" lang="en" xml:lang="en"><a id="docbook2man"></a><div class="titlepage"></div><a id="id2518466" class="indexterm"></a><a id="id2518577" class="indexterm"></a><a id="id2518583" class="indexterm"></a><a id="id2518590" class="indexterm"></a><div class="refnamediv"><h2>Name</h2><p><span><strong class="command">docbook2man</strong></span> — Convert DocBook to man pages</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">docbook2man</code> [<em class="replaceable"><code>options</code></em>] <em class="replaceable"><code>xml-document</code></em> </p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2518671"></a><h2>Description</h2><p>
++<span><strong class="command">docbook2man</strong></span> converts the given DocBook XML document into man pages.
++By default, the man pages will be output to the current directory.
++</p><p>
++<a id="id2518690" class="indexterm"></a>
++Only the <code class="sgmltag-element">refentry</code> content
++in the DocBook document is converted.
++(To convert content outside of a <code class="sgmltag-element">refentry</code>,
++stylesheet customization is required. See the docbook2X
++package for details.)
++</p><p>
++The <span><strong class="command">docbook2man</strong></span> command is a wrapper script
++for a two-step conversion process.
++
++</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2518735"></a><h2>Options</h2><p>
++The available options are essentially the union of the options
++from <a href="db2x_xsltproc.html"><span><strong class="command">db2x_xsltproc</strong></span></a> and <a href="db2x_manxml.html"><span><strong class="command">db2x_manxml</strong></span></a>.
++</p><p>
++Some commonly-used options are listed below:
++</p><div class="variablelist"><dl><dt><span class="term"><code class="option">--encoding=<em class="replaceable"><code>encoding</code></em></code></span></dt><dd><p>
++ Sets the character encoding of the output.
++ </p></dd><dt><span class="term"><code class="option">--string-param <em class="replaceable"><code>parameter</code></em>=<em class="replaceable"><code>value</code></em></code></span></dt><dd><p>
++ Sets a stylesheet parameter (options that affect how the output looks).
++ See “Stylesheet parameters” below for the parameters that
++ can be set.
++ </p></dd><dt><span class="term"><code class="option">--sgml</code></span></dt><dd><p>
++ Accept an SGML source document as input instead of XML.
++ </p></dd><dt><span class="term"><code class="option">--solinks</code></span></dt><dd><p>
++ Make stub pages for alternate names for an output man page.
++ </p></dd></dl></div><div class="refsect2" lang="en" xml:lang="en"><a id="id2518822"></a><h3>Stylesheet parameters</h3><a id="id2518827" class="indexterm"></a><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>uppercase-headings</code></em></span></dt><dd><p><b>Brief. </b>Make headings uppercase?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>
++Headings in man page content should be or should not be uppercased.
++</p></dd><dt><span class="term"><em class="parameter"><code>manvolnum-cite-numeral-only</code></em></span></dt><dd><p><b>Brief. </b>Man page section citation should use only the number</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>
++When citing other man pages, the man-page section is either given as is,
++or has the letters stripped from it, citing only the number of the
++section (e.g. section <code class="literal">3x</code> becomes
++<code class="literal">3</code>). This option specifies which style.
++</p></dd><dt><span class="term"><em class="parameter"><code>quotes-on-literals</code></em></span></dt><dd><p><b>Brief. </b>Display quotes on <code class="sgmltag-element">literal</code>
++elements?</p><p><b>Default setting. </b><code class="literal">0</code> (boolean false)</p><p>
++If true, render <code class="sgmltag-element">literal</code> elements
++with quotes around them.
++</p></dd><dt><span class="term"><em class="parameter"><code>show-comments</code></em></span></dt><dd><p><b>Brief. </b>Display <code class="sgmltag-element">comment</code> elements?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>If true, comments will be displayed, otherwise they are suppressed.
++Comments here refers to the <code class="sgmltag-element">comment</code> element,
++which will be renamed <code class="sgmltag-element">remark</code> in DocBook V4.0,
++not XML comments (<-- like this -->) which are unavailable.
++</p></dd><dt><span class="term"><em class="parameter"><code>function-parens</code></em></span></dt><dd><p><b>Brief. </b>Generate parentheses after a function?</p><p><b>Default setting. </b><code class="literal">0</code> (boolean false)</p><p>If true, the formatting of
++a <code class="sgmltag-starttag"><function></code> element will include
++generated parenthesis.
++</p></dd><dt><span class="term"><em class="parameter"><code>xref-on-link</code></em></span></dt><dd><p><b>Brief. </b>Should <code class="sgmltag-element">link</code> generate a
++cross-reference?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>
++Man pages cannot render the hypertext links created by <code class="sgmltag-element">link</code>. If this option is set, then the
++stylesheet renders a cross reference to the target of the link.
++(This may reduce clutter). Otherwise, only the content of the <code class="sgmltag-element">link</code> is rendered and the actual link itself is
++ignored.
++</p></dd><dt><span class="term"><em class="parameter"><code>header-3</code></em></span></dt><dd><p><b>Brief. </b>Third header text</p><p><b>Default setting. </b>(blank)</p><p>
++Specifies the text of the third header of a man page,
++typically the date for the man page. If empty, the <code class="sgmltag-element">date</code> content for the <code class="sgmltag-element">refentry</code> is used.
++</p></dd><dt><span class="term"><em class="parameter"><code>header-4</code></em></span></dt><dd><p><b>Brief. </b>Fourth header text</p><p><b>Default setting. </b>(blank)</p><p>
++Specifies the text of the fourth header of a man page.
++If empty, the <code class="sgmltag-element">refmiscinfo</code> content for
++the <code class="sgmltag-element">refentry</code> is used.
++</p></dd><dt><span class="term"><em class="parameter"><code>header-5</code></em></span></dt><dd><p><b>Brief. </b>Fifth header text</p><p><b>Default setting. </b>(blank)</p><p>
++Specifies the text of the fifth header of a man page.
++If empty, the “<span class="quote">manual name</span>”, that is, the title of the
++<code class="sgmltag-element">book</code> or <code class="sgmltag-element">reference</code> container is used.
++</p></dd><dt><span class="term"><em class="parameter"><code>default-manpage-section</code></em></span></dt><dd><p><b>Brief. </b>Default man page section</p><p><b>Default setting. </b><code class="literal">1</code></p><p>
++The source document usually indicates the sections that each man page
++should belong to (with <code class="sgmltag-element">manvolnum</code> in
++<code class="sgmltag-element">refmeta</code>). In case the source
++document does not indicate man-page sections, this option specifies the
++default.
++</p></dd><dt><span class="term"><em class="parameter"><code>custom-localization-file</code></em></span></dt><dd><p><b>Brief. </b>URI of XML document containing custom localization data</p><p><b>Default setting. </b>(blank)</p><p>
++This parameter specifies the URI of a XML document
++that describes text translations (and other locale-specific information)
++that is needed by the stylesheet to process the DocBook document.
++</p><p>
++The text translations pointed to by this parameter always
++override the default text translations
++(from the internal parameter <em class="parameter"><code>localization-file</code></em>).
++If a particular translation is not present here,
++the corresponding default translation
++is used as a fallback.
++</p><p>
++This parameter is primarily for changing certain
++punctuation characters used in formatting the source document.
++The settings for punctuation characters are often specific
++to the source document, but can also be dependent on the locale.
++</p><p>
++To not use custom text translations, leave this parameter
++as the empty string.
++</p></dd><dt><span class="term"><em class="parameter"><code>custom-l10n-data</code></em></span></dt><dd><p><b>Brief. </b>XML document containing custom localization data</p><p><b>Default setting. </b><code class="literal">document($custom-localization-file)</code></p><p>
++This parameter specifies the XML document
++that describes text translations (and other locale-specific information)
++that is needed by the stylesheet to process the DocBook document.
++</p><p>
++This parameter is internal to the stylesheet.
++To point to an external XML document with a URI or a file name,
++you should use the <em class="parameter"><code>custom-localization-file</code></em>
++parameter instead.
++</p><p>
++However, inside a custom stylesheet
++(<span class="emphasis"><em>not on the command-line</em></span>)
++this paramter can be set to the XPath expression
++<code class="literal">document('')</code>,
++which will cause the custom translations
++directly embedded inside the custom stylesheet to be read.
++</p></dd><dt><span class="term"><em class="parameter"><code>author-othername-in-middle</code></em></span></dt><dd><p><b>Brief. </b>Is <code class="sgmltag-element">othername</code> in <code class="sgmltag-element">author</code> a
++middle name?</p><p><b>Default setting. </b><code class="literal">1</code></p><p>If true, the <code class="sgmltag-element">othername</code> of an <code class="sgmltag-element">author</code>
++appears between the <code class="sgmltag-element">firstname</code> and
++<code class="sgmltag-element">surname</code>. Otherwise, <code class="sgmltag-element">othername</code>
++is suppressed.
++</p></dd></dl></div></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2519540"></a><h2>Examples</h2><a id="id2519546" class="indexterm"></a><div class="informalexample"><pre class="screen"><code class="prompt">$ </code><strong class="userinput"><code>docbook2man --solinks manpages.xml</code></strong>
++<code class="prompt">$ </code><strong class="userinput"><code>docbook2man --solinks --encoding=utf-8//TRANSLIT manpages.xml</code></strong>
++<code class="prompt">$ </code><strong class="userinput"><code>docbook2man --string-param header-4="Free Recode 3.6" document.xml</code></strong>
++</pre></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2520215"></a><h2>Limitations</h2><div class="itemizedlist"><ul><li><p>
++ Internally there is one long pipeline of programs which your
++ document goes through. If any segment of the pipeline fails
++ (even trivially, like from mistyped program options),
++ the resulting errors can be difficult to decipher —
++ in this case, try running the components of docbook2X
++ separately.
++ </p></li></ul></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="manpages.html"><< Previous</a> </td><td width="20%" align="center"><a accesskey="u" href="manpages.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="db2x_manxml.html">Next >></a></td></tr><tr><td width="40%" align="left" valign="top">Converting to man pages </td><td width="20%" align="center"><a accesskey="h" href="docbook2X.html">Table of Contents</a></td><td width="40%" align="right" valign="top"> <span><strong class="command">db2x_manxml</strong></span></td></tr></table></div><p class="footer-homepage"><a href="http://docbook2x.sourceforge.net/" title="docbook2X: Home page">docbook2X home page</a></p></body></html>
+diff -urNad docbook2x-0.8.7~/doc/docbook2texi.html docbook2x-0.8.7/doc/docbook2texi.html
+--- docbook2x-0.8.7~/doc/docbook2texi.html 1970-01-01 01:00:00.000000000 +0100
++++ docbook2x-0.8.7/doc/docbook2texi.html 2006-04-18 21:12:58.000000000 +0200
+@@ -0,0 +1,197 @@
++<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
++<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /><title>docbook2X: docbook2texi</title><link rel="stylesheet" href="docbook2X.css" type="text/css" /><link rev="made" href="mailto:stevecheng at users.sourceforge.net" /><meta name="generator" content="DocBook XSL Stylesheets V1.68.1" /><link rel="start" href="docbook2X.html" title="docbook2X: Documentation Table of Contents" /><link rel="up" href="texinfo.html" title="docbook2X: Converting to Texinfo" /><link rel="prev" href="texinfo.html" title="docbook2X: Converting to Texinfo" /><link rel="next" href="db2x_texixml.html" title="docbook2X: db2x_texixml" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">docbook2texi</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="texinfo.html"><< Previous</a> </td><th width="60%" align="center">Converting to Texinfo</th><td width="20%" align="right"> <a accesskey="n" href="db2x_texixml.html">Next >></a></td></tr></table><hr /></div><div class="refentry" lang="en" xml:lang="en"><a id="docbook2texi"></a><div class="titlepage"></div><a id="id2523423" class="indexterm"></a><a id="id2523430" class="indexterm"></a><a id="id2523437" class="indexterm"></a><a id="id2523443" class="indexterm"></a><div class="refnamediv"><h2>Name</h2><p><span><strong class="command">docbook2texi</strong></span> — Convert DocBook to Texinfo</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">docbook2texi</code> [<em class="replaceable"><code>options</code></em>] <em class="replaceable"><code>xml-document</code></em> </p></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2523526"></a><h2>Description</h2><p>
++<span><strong class="command">docbook2texi</strong></span> converts the given
++DocBook XML document into one or more Texinfo documents.
++By default, these Texinfo documents will be output to the current
++directory.
++</p><p>
++The <span><strong class="command">docbook2texi</strong></span> command is a wrapper script
++for a two-step conversion process.
++
++</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2523562"></a><h2>Options</h2><p>
++The available options are essentially the union of the options
++for <a href="db2x_xsltproc.html"><span><strong class="command">db2x_xsltproc</strong></span></a> and <a href="db2x_texixml.html"><span><strong class="command">db2x_texixml</strong></span></a>.
++</p><p>
++Some commonly-used options are listed below:
++</p><div class="variablelist"><dl><dt><span class="term"><code class="option">--encoding=<em class="replaceable"><code>encoding</code></em></code></span></dt><dd><p>
++ Sets the character encoding of the output.
++ </p></dd><dt><span class="term"><code class="option">--string-param <em class="replaceable"><code>parameter</code></em>=<em class="replaceable"><code>value</code></em></code></span></dt><dd><p>
++ Sets a stylesheet parameter (options that affect how the output looks).
++ See “Stylesheet parameters” below for the parameters that
++ can be set.
++ </p></dd><dt><span class="term"><code class="option">--sgml</code></span></dt><dd><p>
++ Accept an SGML source document as input instead of XML.
++ </p></dd></dl></div><div class="refsect2" lang="en" xml:lang="en"><a id="id2523658"></a><h3>Stylesheet parameters</h3><a id="id2523664" class="indexterm"></a><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>captions-display-as-headings</code></em></span></dt><dd><p><b>Brief. </b>Use heading markup for minor captions?</p><p><b>Default setting. </b><code class="literal">0</code> (boolean false)</p><p>If true, <code class="sgmltag-element">title</code>
++content in some (formal) objects are rendered with the Texinfo
++<span class="markup">@<em class="replaceable"><code>heading</code></em></span> commands.
++</p><p>
++If false, captions are rendered as an emphasized paragraph.
++</p></dd><dt><span class="term"><em class="parameter"><code>links-use-pxref</code></em></span></dt><dd><p><b>Brief. </b>Translate <code class="sgmltag-element">link</code> using
++<span class="markup">@pxref</span></p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>
++If true, <code class="sgmltag-element">link</code> is translated
++with the hypertext followed by the cross reference in parentheses.
++</p><p>
++Otherwise, the hypertext content serves as the cross-reference name
++marked up using <span class="markup">@ref</span>. Typically info displays this
++contruct badly.
++</p></dd><dt><span class="term"><em class="parameter"><code>explicit-node-names</code></em></span></dt><dd><p><b>Brief. </b>Insist on manually constructed Texinfo node
++names</p><p><b>Default setting. </b><code class="literal">0</code> (boolean false)</p><p>
++Elements in the source document can influence the Texinfo node name
++generation specifying either a <code class="sgmltag-attribute">xreflabel</code>, or for the sectioning elements,
++a <code class="sgmltag-element">title</code> with <code class="sgmltag-attribute">role='texinfo-node'</code> in the
++<code class="sgmltag-element"><em class="replaceable"><code>*</code></em>info</code> container.
++</p><p>
++However, for the majority of source documents, explicit Texinfo node
++names are not available, and the stylesheet tries to generate a
++reasonable one instead, e.g. from the normal title of an element.
++The generated name may not be optimal. If this option is set and the
++stylesheet needs to generate a name, a warning is emitted and
++<code class="function">generate-id</code> is always used for the name.
++</p><p>
++When the hashtable extension is not available, the stylesheet cannot
++check for node name collisions, and in this case, setting this option
++and using explicit node names are recommended.
++</p><p>
++This option is not set (i.e. false) by default.
++</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The absolute fallback for generating node names is using the XSLT
++function <code class="function">generate-id</code>, and the stylesheet always
++emits a warning in this case regardless of the setting of
++<em class="parameter"><code>explicit-node-names</code></em>.</p></div></dd><dt><span class="term"><em class="parameter"><code>show-comments</code></em></span></dt><dd><p><b>Brief. </b>Display <code class="sgmltag-element">comment</code> elements?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>If true, comments will be displayed, otherwise they are suppressed.
++Comments here refers to the <code class="sgmltag-element">comment</code> element,
++which will be renamed <code class="sgmltag-element">remark</code> in DocBook V4.0,
++not XML comments (<-- like this -->) which are unavailable.
++</p></dd><dt><span class="term"><em class="parameter"><code>funcsynopsis-decoration</code></em></span></dt><dd><p><b>Brief. </b>Decorate elements of a FuncSynopsis?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>If true, elements of the FuncSynopsis will be decorated (e.g. bold or
++italic). The decoration is controlled by functions that can be redefined
++in a customization layer.
++</p></dd><dt><span class="term"><em class="parameter"><code>function-parens</code></em></span></dt><dd><p><b>Brief. </b>Generate parentheses after a function?</p><p><b>Default setting. </b><code class="literal">0</code> (boolean false)</p><p>If true, the formatting of
++a <code class="sgmltag-starttag"><function></code> element will include
++generated parenthesis.
++</p></dd><dt><span class="term"><em class="parameter"><code>refentry-display-name</code></em></span></dt><dd><p><b>Brief. </b>Output NAME header before 'RefName'(s)?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>If true, a "NAME" section title is output before the list
++of 'RefName's.
++</p></dd><dt><span class="term"><em class="parameter"><code>manvolnum-in-xref</code></em></span></dt><dd><p><b>Brief. </b>Output <code class="sgmltag-element">manvolnum</code> as part of
++<code class="sgmltag-element">refentry</code> cross-reference?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>if true, the <code class="sgmltag-element">manvolnum</code> is used when cross-referencing
++<code class="sgmltag-element">refentry</code>s, either with <code class="sgmltag-element">xref</code>
++or <code class="sgmltag-element">citerefentry</code>.
++</p></dd><dt><span class="term"><em class="parameter"><code>prefer-textobjects</code></em></span></dt><dd><p><b>Brief. </b>Prefer <code class="sgmltag-element">textobject</code>
++over <code class="sgmltag-element">imageobject</code>?
++</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>
++If true, the
++<code class="sgmltag-element">textobject</code>
++in a <code class="sgmltag-element">mediaobject</code>
++is preferred over any
++<code class="sgmltag-element">imageobject</code>.
++</p><p>
++(Of course, for output formats other than Texinfo, you usually
++want to prefer the <code class="sgmltag-element">imageobject</code>,
++but Info is a text-only format.)
++</p><p>
++In addition to the values true and false, this parameter
++may be set to <code class="literal">2</code> to indicate that
++both the text and the images should be output.
++You may want to do this because some Texinfo viewers
++can read images. Note that the Texinfo <span class="markup">@image</span>
++command has its own mechanism for switching between text
++and image output — but we do not use this here.
++</p><p>
++The default is true.
++</p></dd><dt><span class="term"><em class="parameter"><code>semantic-decorations</code></em></span></dt><dd><p><b>Brief. </b>Use Texinfo semantic inline markup?</p><p><b>Default setting. </b><code class="literal">1</code> (boolean true)</p><p>
++If true, the semantic inline markup of DocBook is translated into
++(the closest) Texinfo equivalent. This is the default.
++</p><p>
++However, because the Info format is limited to plain text,
++the semantic inline markup is often distinguished by using
++explicit quotes, which may not look good.
++You can set this option to false to suppress these.
++(For finer control over the inline formatting, you can
++use your own stylesheet.)
++</p></dd><dt><span class="term"><em class="parameter"><code>custom-localization-file</code></em></span></dt><dd><p><b>Brief. </b>URI of XML document containing custom localization data</p><p><b>Default setting. </b>(blank)</p><p>
++This parameter specifies the URI of a XML document
++that describes text translations (and other locale-specific information)
++that is needed by the stylesheet to process the DocBook document.
++</p><p>
++The text translations pointed to by this parameter always
++override the default text translations
++(from the internal parameter <em class="parameter"><code>localization-file</code></em>).
++If a particular translation is not present here,
++the corresponding default translation
++is used as a fallback.
++</p><p>
++This parameter is primarily for changing certain
++punctuation characters used in formatting the source document.
++The settings for punctuation characters are often specific
++to the source document, but can also be dependent on the locale.
++</p><p>
++To not use custom text translations, leave this parameter
++as the empty string.
++</p></dd><dt><span class="term"><em class="parameter"><code>custom-l10n-data</code></em></span></dt><dd><p><b>Brief. </b>XML document containing custom localization data</p><p><b>Default setting. </b><code class="literal">document($custom-localization-file)</code></p><p>
++This parameter specifies the XML document
++that describes text translations (and other locale-specific information)
++that is needed by the stylesheet to process the DocBook document.
++</p><p>
++This parameter is internal to the stylesheet.
++To point to an external XML document with a URI or a file name,
++you should use the <em class="parameter"><code>custom-localization-file</code></em>
++parameter instead.
++</p><p>
++However, inside a custom stylesheet
++(<span class="emphasis"><em>not on the command-line</em></span>)
++this paramter can be set to the XPath expression
++<code class="literal">document('')</code>,
++which will cause the custom translations
++directly embedded inside the custom stylesheet to be read.
++</p></dd><dt><span class="term"><em class="parameter"><code>author-othername-in-middle</code></em></span></dt><dd><p><b>Brief. </b>Is <code class="sgmltag-element">othername</code> in <code class="sgmltag-element">author</code> a
++middle name?</p><p><b>Default setting. </b><code class="literal">1</code></p><p>If true, the <code class="sgmltag-element">othername</code> of an <code class="sgmltag-element">author</code>
++appears between the <code class="sgmltag-element">firstname</code> and
++<code class="sgmltag-element">surname</code>. Otherwise, <code class="sgmltag-element">othername</code>
++is suppressed.
++</p></dd><dt><span class="term"><em class="parameter"><code>output-file</code></em></span></dt><dd><p><b>Brief. </b>Name of the Info file</p><p><b>Default setting. </b>(blank)</p><a id="id2524996" class="indexterm"></a><p>This parameter specifies the name of the final Info file,
++overriding the setting in the document itself and the automatic
++selection in the stylesheet. If the document is a <code class="sgmltag-element">set</code>, this parameter has no effect. </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>
++Do <span class="emphasis"><em>not</em></span> include the <code class="literal">.info</code>
++extension in the name.
++</p></div><p>
++(Note that this parameter has nothing to do with the name of
++the <span class="emphasis"><em>Texi-XML output</em></span> by the XSLT processor you
++are running this stylesheet from.)
++</p></dd><dt><span class="term"><em class="parameter"><code>directory-category</code></em></span></dt><dd><p><b>Brief. </b>The categorization of the document in the Info directory</p><p><b>Default setting. </b>(blank)</p><a id="id2525063" class="indexterm"></a><p>
++This is set to the category that the document
++should go under in the Info directory of installed Info files.
++For example, <code class="literal">General Commands</code>.
++</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
++Categories may also be set directly in the source document.
++But if this parameter is not empty, then it always overrides the
++setting in the source document.
++</p></div></dd><dt><span class="term"><em class="parameter"><code>directory-description</code></em></span></dt><dd><p><b>Brief. </b>The description of the document in the Info directory</p><p><b>Default setting. </b>(blank)</p><a id="id2525112" class="indexterm"></a><p>
++This is a short description of the document that appears in
++the Info directory of installed Info files.
++For example, <code class="literal">An Interactive Plotting Program.</code>
++</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
++Menu descriptions may also be set directly in the source document.
++But if this parameter is not empty, then it always overrides the
++setting in the source document.
++</p></div></dd><dt><span class="term"><em class="parameter"><code>index-category</code></em></span></dt><dd><p><b>Brief. </b>The Texinfo index to use</p><p><b>Default setting. </b><code class="literal">cp</code></p><p>The Texinfo index for <code class="sgmltag-element">indexterm</code>
++and <code class="sgmltag-element">index</code> is specified using the
++<code class="sgmltag-attribute">role</code> attribute. If the above
++elements do not have a <code class="sgmltag-attribute">role</code>, then
++the default specified by this parameter is used.
++</p><p>
++The predefined indices are:
++
++</p><div class="variablelist"><dl><dt><span class="term"><code class="literal">c</code>, </span><span class="term"><code class="literal">cp</code></span></dt><dd><p>Concept index</p></dd><dt><span class="term"><code class="literal">f</code>, </span><span class="term"><code class="literal">fn</code></span></dt><dd><p>Function index</p></dd><dt><span class="term"><code class="literal">v</code>, </span><span class="term"><code class="literal">vr</code></span></dt><dd><p>Variable index</p></dd><dt><span class="term"><code class="literal">k</code>, </span><span class="term"><code class="literal">ky</code></span></dt><dd><p>Keystroke index</p></dd><dt><span class="term"><code class="literal">p</code>, </span><span class="term"><code class="literal">pg</code></span></dt><dd><p>Program index</p></dd><dt><span class="term"><code class="literal">d</code>, </span><span class="term"><code class="literal">tp</code></span></dt><dd><p>Data type index</p></dd></dl></div><p>
++
++User-defined indices are not yet supported.
++</p></dd><dt><span class="term"><em class="parameter"><code>qanda-defaultlabel</code></em></span></dt><dd><p><b>Brief. </b>Sets the default for defaultlabel on QandASet.</p><p><b>Default setting. </b><code class="literal"></code></p><p>If no defaultlabel attribute is specified on a QandASet, this
++value is used. It must be one of the legal values for the defaultlabel
++attribute.
++</p></dd><dt><span class="term"><em class="parameter"><code>qandaset-generate-toc</code></em></span></dt><dd><p><b>Brief. </b>Is a Table of Contents created for QandASets?</p><p><b>Default setting. </b><code class="literal"></code></p><p>If true, a ToC is constructed for QandASets.
++</p></dd></dl></div></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2525935"></a><h2>Examples</h2><a id="id2525941" class="indexterm"></a><div class="informalexample"><pre class="screen"><code class="prompt">$ </code><strong class="userinput"><code>docbook2texi tdg.xml</code></strong>
++<code class="prompt">$ </code><strong class="userinput"><code>docbook2texi --encoding=utf-8//TRANSLIT tdg.xml</code></strong>
++<code class="prompt">$ </code><strong class="userinput"><code>docbook2texi --string-param semantic-decorations=0 tdg.xml</code></strong>
++</pre></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="id2526103"></a><h2>Limitations</h2><div class="itemizedlist"><ul><li><p>
++ Internally there is one long pipeline of programs which your
++ document goes through. If any segment of the pipeline fails
++ (even trivially, like from mistyped program options),
++ the resulting errors can be difficult to decipher —
++ in this case, try running the components of docbook2X
++ separately.
++ </p></li></ul></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="texinfo.html"><< Previous</a> </td><td width="20%" align="center"><a accesskey="u" href="texinfo.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="db2x_texixml.html">Next >></a></td></tr><tr><td width="40%" align="left" valign="top">Converting to Texinfo </td><td width="20%" align="center"><a accesskey="h" href="docbook2X.html">Table of Contents</a></td><td width="40%" align="right" valign="top"> <span><strong class="command">db2x_texixml</strong></span></td></tr></table></div><p class="footer-homepage"><a href="http://docbook2x.sourceforge.net/" title="docbook2X: Home page">docbook2X home page</a></p></body></html>
Added: packages/docbook2x/trunk/debian/rules
===================================================================
--- packages/docbook2x/trunk/debian/rules 2007-04-10 19:22:18 UTC (rev 694)
+++ packages/docbook2x/trunk/debian/rules 2007-04-10 19:26:25 UTC (rev 695)
@@ -0,0 +1,33 @@
+#!/usr/bin/make -f
+
+include /usr/share/cdbs/1/rules/debhelper.mk
+include /usr/share/cdbs/1/class/autotools.mk
+include /usr/share/cdbs/1/rules/dpatch.mk
+
+
+PACKAGE := docbook2x
+
+DEB_CONFIGURE_EXTRA_FLAGS := --program-transform-name="s/^docbook2/docbook2x-/"
+
+
+common-install-prehook-arch::
+ sed "s/^INFO-DIR-SECTION Document Preparation/INFO-DIR-SECTION Text/" \
+ doc/docbook2X.info > debian/docbook2X.info
+ sed "s/^INFO-DIR-SECTION Document Preparation/INFO-DIR-SECTION Text/" \
+ xslt/documentation/docbook2man-xslt.info > debian/docbook2man-xslt.info
+ sed "s/^INFO-DIR-SECTION Document Preparation/INFO-DIR-SECTION Text/" \
+ xslt/documentation/docbook2texi-xslt.info > debian/docbook2texi-xslt.info
+
+binary-install/docbook2x::
+ dh_installinfo -pdocbook2x debian/docbook2X.info \
+ debian/docbook2man-xslt.info \
+ debian/docbook2texi-xslt.info
+
+binary-post-install/docbook2x::
+ mv $(CURDIR)/debian/$(PACKAGE)/usr/share/doc/docbook2X \
+ $(CURDIR)/debian/$(PACKAGE)/usr/share/doc/docbook2x
+
+clean::
+ make -C debian/examples clean
+ rm -f debian/docbook2X.info
+
Property changes on: packages/docbook2x/trunk/debian/rules
___________________________________________________________________
Name: svn:executable
+ *
More information about the debian-xml-sgml-commit
mailing list