1
<?xml version='1.0' encoding='UTF-8'?>
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
8
-''-param man.charmap.use.subset "0" \
9
-''-param make.year.ranges "1" \
10
-''-param make.single.year.ranges "1" \
11
/usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl \
14
A manual page <package>.<section> will be generated. You may view the
15
manual page with: nroff -man <package>.<section> | less'. A typical entry
16
in a Makefile or Makefile.am is:
18
DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl
19
XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
21
manpage.1: manpage.xml
24
The xsltproc binary is found in the xsltproc package. The XSL files are in
25
docbook-xsl. A description of the parameters you can use can be found in the
26
docbook-xsl-doc-* packages. Please remember that if you create the nroff
27
version in one of the debian/rules file targets (such as build), you will need
28
to include xsltproc and docbook-xsl in your Build-Depends control field.
29
Alternatively use the xmlto command/package. That will also automatically
30
pull in xsltproc and docbook-xsl.
32
Notes for using docbook2x: docbook2x-man does not automatically create the
33
AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
34
<refsect1> ... </refsect1>.
36
To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
37
read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
38
found in the docbook-xsl-doc-html package.
40
Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
42
General documentation about man-pages and man-page-formatting:
43
man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
47
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
48
<!ENTITY dhfirstname "Georges">
49
<!ENTITY dhsurname "Khaznadar">
50
<!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
51
<!ENTITY dhusername "Georges Khaznadar">
52
<!ENTITY dhemail "georgesk@ofset.org">
53
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
54
allowed: see man(7), man(1) and
55
http://www.tldp.org/HOWTO/Man-Page/q2.html. -->
56
<!ENTITY dhsection "1">
57
<!-- TITLE should be something like "User commands" or similar (see
58
http://www.tldp.org/HOWTO/Man-Page/q2.html). -->
59
<!ENTITY dhtitle "pyacidobasic User Manual">
60
<!ENTITY dhucpackage "PYACIDOBASIC">
61
<!ENTITY dhpackage "pyacidobasic">
66
<title>&dhtitle;</title>
67
<productname>&dhpackage;</productname>
70
<firstname>&dhfirstname;</firstname>
71
<surname>&dhsurname;</surname>
72
<contrib>Wrote this manpage.</contrib>
74
<email>&dhemail;</email>
80
<holder>&dhusername;</holder>
83
<para>Permission is granted to copy, distribute and/or modify this
84
document under the terms of the GNU General Public License,
85
Version 2 or (at your option) any later version published by
86
the Free Software Foundation.</para>
87
<para>On Debian systems, the complete text of the GNU General Public
88
License can be found in
89
<filename>/usr/share/common-licenses/GPL</filename>.</para>
93
<refentrytitle>&dhucpackage;</refentrytitle>
94
<manvolnum>&dhsection;</manvolnum>
97
<refname>&dhpackage;</refname>
98
<refpurpose>program to plot simulated curves for acido-basic titrations</refpurpose>
102
<command>&dhpackage;</command>
105
<refsect1 id="description">
106
<title>DESCRIPTION</title>
107
<para><command>&dhpackage;</command> is a program to simulate
108
acido-basic titrations. It plots interactively the variations of pH
109
driven by the addition of a variable volume of a selected acid or base.</para>