[python-bumps] 09/20: create manpage bumps.1 using docbook bumps.xml
Drew Parsons
dparsons at moszumanska.debian.org
Sun Oct 29 06:29:25 UTC 2017
This is an automated email from the git hooks/post-receive script.
dparsons pushed a commit to tag debian/0.7.6-1
in repository python-bumps.
commit 4c5a0b205b8c2ea5004450b8cb52be2c880a5ea4
Author: Drew Parsons <dparsons at debian.org>
Date: Sun Oct 29 12:00:26 2017 +0800
create manpage bumps.1 using docbook bumps.xml
bumps.1 generated with:
xsltproc --nonet --param man.charmap.use.subset "0" --param make.year.ranges "1" --param make.single.year.ranges "1" /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl bumps.xml
---
debian/bumps.1 | 366 ++++++++++++++++++++++++++++
debian/bumps.xml | 551 +++++++++++++++++++++++++++++++++++++++++++
debian/manpage.1.ex | 56 -----
debian/manpage.sgml.ex | 154 ------------
debian/manpage.xml.ex | 291 -----------------------
debian/python-bumps.manpages | 1 +
6 files changed, 918 insertions(+), 501 deletions(-)
diff --git a/debian/bumps.1 b/debian/bumps.1
new file mode 100644
index 0000000..f4c573d
--- /dev/null
+++ b/debian/bumps.1
@@ -0,0 +1,366 @@
+'\" t
+.\" Title: bumps
+.\" Author: Drew Parsons <dparsons at debian.org>
+.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
+.\" Date: 10/29/2017
+.\" Manual: python-bumps man page
+.\" Source: bumps
+.\" Language: English
+.\"
+.TH "BUMPS" "1" "10/29/2017" "bumps" "python-bumps man page"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+bumps \- data fitting and Bayesian uncertainty modeling for inverse problems
+.SH "SYNOPSIS"
+.HP \w'\fBbumps\fR\ 'u
+\fBbumps\fR [\fIoptions\fR] \fImodelfile\fR [\fImodelargs\fR]
+.HP \w'\fBbumps\fR\ 'u
+\fBbumps\fR [{\fB\-?\fR\ |\ \fB\-h\fR\ |\ \fB\-\-help\fR}]
+.SH "DESCRIPTION"
+.PP
+This manual page documents briefly the
+\fBbumps\fR
+command (
+\fBbumps3\fR
+for python3)\&.
+.PP
+This manual page was written for the Debian distribution because the original program does not have a manual page\&. Instead, it has documentation in HTML and in the GNU
+\fBinfo\fR(1)
+format; see below\&.
+.PP
+\fBbumps\fR
+provides a set of routines for curve fitting and uncertainty analysis from a Bayesian perspective\&. In addition to traditional optimizers which search for the best minimum they can find in the search space, bumps provides uncertainty analysis which explores all viable minima and finds confidence intervals on the parameters based on uncertainty in the measured values\&. Bumps has been used for systems of up to 100 parameters with tight constraints on the parameters\&. Full uncertainty an [...]
+.PP
+Bumps includes several traditional local optimizers such as Nelder\-Mead simplex, BFGS and differential evolution\&. Bumps uncertainty analysis uses Markov chain Monte Carlo to explore the parameter space\&. Although it was created for curve fitting problems, Bumps can explore any probability density function, such as those defined by PyMC\&. In particular, the bumps uncertainty analysis works well with correlated parameters\&.
+.PP
+The modelfile is a Python script (i\&.e\&., a series of Python commands) which sets up the data, the models, and the fittable parameters\&. The model arguments are available in the modelfile as sys\&.argv[1:]\&. Model arguments may not start with \*(Aq\-\*(Aq\&.
+.SH "OPTIONS"
+.PP
+The program follows the usual GNU command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&. For a complete description, see the HTML documentation or
+\fBinfo\fR(1)
+files\&.
+.PP
+\fB\-\-preview\fR
+.RS 4
+display model but do not perform a fitting operation
+.RE
+.PP
+\fB\-\-pars=filename\fR
+.RS 4
+initial parameter values; fit results are saved as
+\fImodelname\fR\&.par
+.RE
+.PP
+\fB\-\-plot=log [linear|log|residuals]\fR
+.RS 4
+type of plot to display
+.RE
+.PP
+\fB\-\-simulate\fR
+.RS 4
+simulate a dataset using the initial problem parameters
+.RE
+.PP
+\fB\-\-simrandom\fR
+.RS 4
+simulate a dataset using random problem parameters
+.RE
+.PP
+\fB\-\-shake\fR
+.RS 4
+set random parameters before fitting
+.RE
+.PP
+\fB\-\-noise=5%\fR
+.RS 4
+percent noise to add to the simulated data
+.RE
+.PP
+\fB\-\-seed=integer\fR
+.RS 4
+random number seed
+.RE
+.PP
+\fB\-\-err\fR
+.RS 4
+show uncertainty estimate from curvature at the minimum
+.RE
+.PP
+\fB\-\-cov\fR
+.RS 4
+show the covariance matrix for the model when done
+.RE
+.PP
+\fB\-\-entropy\fR
+.RS 4
+compute entropy for the model when done [dream only]
+.RE
+.PP
+\fB\-\-staj\fR
+.RS 4
+output staj file when done
+.RE
+.PP
+\fB\-\-edit\fR
+.RS 4
+start the gui
+.RE
+.PP
+\fB\-\-view=linear|log\fR
+.RS 4
+one of the predefined problem views; reflectometry also has fresnel, logfresnel, q4 and residuals
+.RE
+.PP
+\fB\-\-store=path\fR
+.RS 4
+output directory for plots and models
+.RE
+.PP
+\fB\-\-overwrite\fR
+.RS 4
+if store already exists, replace it
+.RE
+.PP
+\fB\-\-resume=path [dream]\fR
+.RS 4
+resume a fit from previous stored state
+.RE
+.PP
+\fB\-\-parallel\fR
+.RS 4
+run fit using multiprocessing for parallelism
+.RE
+.PP
+\fB\-\-mpi\fR
+.RS 4
+run fit using MPI for parallelism (use command "mpirun \-n cpus \&.\&.\&.")
+.RE
+.PP
+\fB\-\-batch\fR
+.RS 4
+batch mode; save output in \&.mon file and don\*(Aqt show plots after fit
+.RE
+.PP
+\fB\-\-noshow\fR
+.RS 4
+semi\-batch; send output to console but don\*(Aqt show plots after fit
+.RE
+.PP
+\fB\-\-remote\fR
+.RS 4
+queue fit to run on remote server
+.RE
+.PP
+\fB\-\-notify=user at email\fR
+.RS 4
+remote fit notification
+.RE
+.PP
+\fB\-\-queue=http://reflectometry\&.org\fR
+.RS 4
+remote job queue
+.RE
+.PP
+\fB\-\-time=inf\fR
+.RS 4
+run for a maximum number of hours
+.RE
+.PP
+\fB\-\-fit=amoeba [amoeba|de|dream|lm|newton|ps|pt|rl|snobfit]\fR
+.RS 4
+fitting engine to use; see manual for details
+.RE
+.PP
+\fB\-\-steps=400 [amoeba|de|dream|lm|newton|ps|pt|rl|snobfit]\fR
+.RS 4
+number of fit iterations after any burn\-in time
+.RE
+.PP
+\fB\-\-samples=1e4 [dream]\fR
+.RS 4
+set steps so the target number of samples is drawn
+.RE
+.PP
+\fB\-\-xtol=1e\-4 [de, amoeba]\fR
+.RS 4
+minimum population diameter
+.RE
+.PP
+\fB\-\-ftol=1e\-4 [de, amoeba]\fR
+.RS 4
+minimum population flatness
+.RE
+.PP
+\fB\-\-pop=10 [dream, de, rl, ps]\fR
+.RS 4
+population size
+.RE
+.PP
+\fB\-\-burn=100 [dream, pt]\fR
+.RS 4
+number of burn\-in iterations before accumulating stats
+.RE
+.PP
+\fB\-\-thin=1 [dream]\fR
+.RS 4
+number of fit iterations between steps
+.RE
+.PP
+\fB\-\-nT=25\fR
+.RS 4
+.RE
+.PP
+\fB\-\-Tmin=0\&.1\fR
+.RS 4
+.RE
+.PP
+\fB\-\-Tmax=10 [pt]\fR
+.RS 4
+temperatures vector; use a higher maximum temperature and a larger nT if your fit is getting stuck in local minima
+.RE
+.PP
+\fB\-\-CR=0\&.9 [de, rl, pt]\fR
+.RS 4
+crossover ratio for population mixing
+.RE
+.PP
+\fB\-\-starts=1 [newton, rl, amoeba]\fR
+.RS 4
+number of times to run the fit from random starting points\&.
+.RE
+.PP
+\fB\-\-keep_best\fR
+.RS 4
+when running with multiple starts, restart from a point near the last minimum rather than using a completely random starting point\&.
+.RE
+.PP
+\fB\-\-init=eps [dream]\fR
+.RS 4
+population initialization method:
+.PP
+eps
+.RS 4
+ball around initial parameter set
+.RE
+.PP
+lhs
+.RS 4
+latin hypercube sampling
+.RE
+.PP
+cov
+.RS 4
+normally distributed according to covariance matrix
+.RE
+.PP
+random
+.RS 4
+uniformly distributed within parameter ranges
+.RE
+.sp
+.RE
+.PP
+\fB\-\-stepmon\fR
+.RS 4
+show details for each step
+.RE
+.PP
+\fB\-\-resynth=0\fR
+.RS 4
+run resynthesis error analysis for n generations
+.RE
+.PP
+\fB\-\-time_model\fR
+.RS 4
+run the model \-\-steps times in order to estimate total run time\&.
+.RE
+.PP
+\fB\-\-profile\fR
+.RS 4
+run the python profiler on the model; use \-\-steps to run multiple models for better statistics
+.RE
+.PP
+\fB\-\-chisq\fR
+.RS 4
+print the model description and chisq value and exit
+.RE
+.PP
+\fB\-m\fR, \fB\-c\fR, \fB\-p command\fR
+.RS 4
+run the python interpreter with bumps on the path:
+.PP
+m
+.RS 4
+command is a module such as bumps\&.cli, run as __main__
+.RE
+.PP
+c
+.RS 4
+command is a python one\-line command
+.RE
+.PP
+p
+.RS 4
+command is the name of a python script
+.RE
+.sp
+.RE
+.PP
+\fB\-i\fR
+.RS 4
+start the interactive interpreter
+.RE
+.PP
+\fB\-?\fR, \fB\-h\fR, \fB\-\-help\fR
+.RS 4
+display this help
+.RE
+.SH "SEE ALSO"
+.PP
+Bumps is documented fully in HTML at
+\m[blue]\fB/usr/share/doc/python\-bumps\-doc/html/index\&.html\fR\m[]\&\s-2\u[1]\d\s+2
+and also in the
+\fBinfo\fR(1)
+system\&.
+.SH "AUTHOR"
+.PP
+\fBDrew Parsons\fR <\&dparsons at debian\&.org\&>
+.RS 4
+Wrote this manpage for the Debian system\&.
+.RE
+.SH "COPYRIGHT"
+.br
+Copyright \(co 2017 Drew Parsons
+.br
+.PP
+This manual page was written for the Debian system (and may be used by others)\&.
+.PP
+Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
+.PP
+On Debian systems, the complete text of the GNU General Public License can be found in
+/usr/share/common\-licenses/GPL\&.
+.sp
+.SH "NOTES"
+.IP " 1." 4
+/usr/share/doc/python-bumps-doc/html/index.html
+.RS 4
+\%file:///usr/share/doc/python-bumps-doc/html/index.html
+.RE
diff --git a/debian/bumps.xml b/debian/bumps.xml
new file mode 100644
index 0000000..d06c906
--- /dev/null
+++ b/debian/bumps.xml
@@ -0,0 +1,551 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+
+<!--
+
+`xsltproc -''-nonet \
+ -''-param man.charmap.use.subset "0" \
+ -''-param make.year.ranges "1" \
+ -''-param make.single.year.ranges "1" \
+ /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
+ manpage.xml'
+
+A manual page <package>.<section> will be generated. You may view the
+manual page with: nroff -man <package>.<section> | less'. A typical entry
+in a Makefile or Makefile.am is:
+
+DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/manpages/docbook.xsl
+XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
+
+manpage.1: manpage.xml
+ $(XP) $(DB2MAN) $<
+
+The xsltproc binary is found in the xsltproc package. The XSL files are in
+docbook-xsl. A description of the parameters you can use can be found in the
+docbook-xsl-doc-* packages. Please remember that if you create the nroff
+version in one of the debian/rules file targets (such as build), you will need
+to include xsltproc and docbook-xsl in your Build-Depends control field.
+Alternatively use the xmlto command/package. That will also automatically
+pull in xsltproc and docbook-xsl.
+
+Notes for using docbook2x: docbook2x-man does not automatically create the
+AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
+<refsect1> ... </refsect1>.
+
+To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
+read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
+found in the docbook-xsl-doc-html package.
+
+Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
+
+General documentation about man-pages and man-page-formatting:
+man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
+
+-->
+
+ <!ENTITY dhfirstname "Drew">
+ <!ENTITY dhsurname "Parsons">
+ <!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
+ <!ENTITY dhusername "Drew Parsons">
+ <!ENTITY dhemail "dparsons at debian.org">
+ <!ENTITY dhsection "1">
+ <!ENTITY dhtitle "python-bumps man page">
+ <!ENTITY dhucpackage "bumps">
+ <!ENTITY dhpackage "bumps">
+]>
+
+<refentry>
+ <refentryinfo>
+ <title>&dhtitle;</title>
+ <productname>&dhpackage;</productname>
+ <authorgroup>
+ <author>
+ <firstname>&dhfirstname;</firstname>
+ <surname>&dhsurname;</surname>
+ <contrib>Wrote this manpage for the Debian system.</contrib>
+ <address>
+ <email>&dhemail;</email>
+ </address>
+ </author>
+ </authorgroup>
+ <copyright>
+ <year>2017</year>
+ <holder>&dhusername;</holder>
+ </copyright>
+ <legalnotice>
+ <para>This manual page was written for the Debian system
+ (and may be used by others).</para>
+ <para>Permission is granted to copy, distribute and/or modify this
+ document under the terms of the GNU General Public License,
+ Version 2 or (at your option) any later version published by
+ the Free Software Foundation.</para>
+ <para>On Debian systems, the complete text of the GNU General Public
+ License can be found in
+ <filename>/usr/share/common-licenses/GPL</filename>.</para>
+ </legalnotice>
+ </refentryinfo>
+ <refmeta>
+ <refentrytitle>&dhucpackage;</refentrytitle>
+ <manvolnum>&dhsection;</manvolnum>
+ </refmeta>
+ <refnamediv>
+ <refname>&dhpackage;</refname>
+ <refpurpose>data fitting and Bayesian uncertainty modeling for inverse problems</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>&dhpackage;</command>
+ <!-- These are several examples, how syntaxes could look -->
+ <arg choice="opt"><replaceable>options</replaceable></arg>
+ <arg choice="plain"><replaceable>modelfile</replaceable></arg>
+ <arg choice="opt"><replaceable>modelargs</replaceable></arg>
+ </cmdsynopsis>
+ <cmdsynopsis>
+ <command>&dhpackage;</command>
+ <!-- Normally the help and version options make the programs stop
+ right after outputting the requested information. -->
+ <group choice="opt">
+ <arg choice="plain">
+ <group choice="req">
+ <arg choice="plain"><option>-?</option></arg>
+ <arg choice="plain"><option>-h</option></arg>
+ <arg choice="plain"><option>--help</option></arg>
+ </group>
+ </arg>
+ </group>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+ <refsect1 id="description">
+ <title>DESCRIPTION</title>
+ <para>This manual page documents briefly the
+ <command>&dhpackage;</command> command ( <command>&dhpackage;3</command> for python3).</para>
+ <para>This manual page was written for the Debian distribution
+ because the original program does not have a manual page.
+ Instead, it has documentation in HTML and in the GNU <citerefentry>
+ <refentrytitle>info</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry> format; see below.</para>
+ <para><command>&dhpackage;</command> provides a set of routines
+ for curve fitting and uncertainty analysis from a Bayesian
+ perspective. In addition to traditional optimizers which search
+ for the best minimum they can find in the search space, bumps
+ provides uncertainty analysis which explores all viable minima and
+ finds confidence intervals on the parameters based on uncertainty
+ in the measured values. Bumps has been used for systems of up to
+ 100 parameters with tight constraints on the parameters. Full
+ uncertainty analysis requires hundreds of thousands of function
+ evaluations, which is only feasible for cheap functions, systems
+ with many processors, or lots of patience.</para>
+ <para> Bumps includes several traditional local optimizers such as
+ Nelder-Mead simplex, BFGS and differential evolution. Bumps
+ uncertainty analysis uses Markov chain Monte Carlo to explore the
+ parameter space. Although it was created for curve fitting
+ problems, Bumps can explore any probability density function, such
+ as those defined by PyMC. In particular, the bumps uncertainty
+ analysis works well with correlated parameters.
+ </para>
+ <para>The modelfile is a Python script (i.e., a series of Python
+ commands) which sets up the data, the models, and the fittable
+ parameters. The model arguments are available in the modelfile as
+ sys.argv[1:]. Model arguments may not start with '-'.</para>
+
+ </refsect1>
+ <refsect1 id="options">
+ <title>OPTIONS</title>
+ <para>The program follows the usual GNU command line syntax,
+ with long options starting with two dashes (`-'). A summary of
+ options is included below. For a complete description, see the HTML documentation or
+ <citerefentry>
+ <refentrytitle>info</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry> files.</para>
+ <variablelist>
+ <!-- Use the variablelist.term.separator and the
+ variablelist.term.break.after parameters to
+ control the term elements. -->
+ <varlistentry>
+ <term><option>--preview</option></term>
+ <listitem>
+ <para>
+ display model but do not perform a fitting operation</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--pars=filename</option></term>
+ <listitem>
+ <para>
+ initial parameter values; fit results are saved as <replaceable>modelname</replaceable>.par</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--plot=log [linear|log|residuals]</option></term>
+ <listitem>
+ <para>
+ type of plot to display</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--simulate</option></term>
+ <listitem>
+ <para>
+ simulate a dataset using the initial problem parameters</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--simrandom</option></term>
+ <listitem>
+ <para>
+ simulate a dataset using random problem parameters</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--shake</option></term>
+ <listitem>
+ <para>
+ set random parameters before fitting</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--noise=5%</option></term>
+ <listitem>
+ <para>
+ percent noise to add to the simulated data</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--seed=integer</option></term>
+ <listitem>
+ <para>
+ random number seed</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--err</option></term>
+ <listitem>
+ <para>
+ show uncertainty estimate from curvature at the minimum</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--cov</option></term>
+ <listitem>
+ <para>
+ show the covariance matrix for the model when done</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--entropy</option></term>
+ <listitem>
+ <para>
+ compute entropy for the model when done [dream only]</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--staj</option></term>
+ <listitem>
+ <para>
+ output staj file when done</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--edit</option></term>
+ <listitem>
+ <para>
+ start the gui</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--view=linear|log</option></term>
+ <listitem>
+ <para>
+ one of the predefined problem views; reflectometry also has fresnel,
+ logfresnel, q4 and residuals
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--store=path</option></term>
+ <listitem>
+ <para>
+ output directory for plots and models</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--overwrite</option></term>
+ <listitem>
+ <para>
+ if store already exists, replace it</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--resume=path [dream]</option></term>
+ <listitem>
+ <para>
+ resume a fit from previous stored state</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--parallel</option></term>
+ <listitem>
+ <para>
+ run fit using multiprocessing for parallelism</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--mpi</option></term>
+ <listitem>
+ <para>
+ run fit using MPI for parallelism (use command "mpirun -n cpus ...")</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--batch</option></term>
+ <listitem>
+ <para>
+ batch mode; save output in .mon file and don't show plots after fit</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--noshow</option></term>
+ <listitem>
+ <para>
+ semi-batch; send output to console but don't show plots after fit</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--remote</option></term>
+ <listitem>
+ <para>
+ queue fit to run on remote server</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--notify=user at email</option></term>
+ <listitem>
+ <para>
+ remote fit notification</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--queue=http://reflectometry.org</option></term>
+ <listitem>
+ <para>
+ remote job queue</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--time=inf</option></term>
+ <listitem>
+ <para>
+ run for a maximum number of hours
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--fit=amoeba [amoeba|de|dream|lm|newton|ps|pt|rl|snobfit]</option></term>
+ <listitem>
+ <para>
+ fitting engine to use; see manual for details</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--steps=400 [amoeba|de|dream|lm|newton|ps|pt|rl|snobfit]</option></term>
+ <listitem>
+ <para>
+ number of fit iterations after any burn-in time</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--samples=1e4 [dream]</option></term>
+ <listitem>
+ <para>
+ set steps so the target number of samples is drawn</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--xtol=1e-4 [de, amoeba]</option></term>
+ <listitem>
+ <para>
+ minimum population diameter</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--ftol=1e-4 [de, amoeba]</option></term>
+ <listitem>
+ <para>
+ minimum population flatness</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--pop=10 [dream, de, rl, ps]</option></term>
+ <listitem>
+ <para>
+ population size</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--burn=100 [dream, pt]</option></term>
+ <listitem>
+ <para>
+ number of burn-in iterations before accumulating stats</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--thin=1 [dream]</option></term>
+ <listitem>
+ <para>
+ number of fit iterations between steps</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--nT=25</option></term>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--Tmin=0.1</option></term>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--Tmax=10 [pt]</option></term>
+ <listitem>
+ <para>
+ temperatures vector; use a higher maximum temperature and a larger
+ nT if your fit is getting stuck in local minima</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--CR=0.9 [de, rl, pt]</option></term>
+ <listitem>
+ <para>
+ crossover ratio for population mixing</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--starts=1 [newton, rl, amoeba]</option></term>
+ <listitem>
+ <para>
+ number of times to run the fit from random starting points.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--keep_best</option></term>
+ <listitem>
+ <para>
+ when running with multiple starts, restart from a point near the
+ last minimum rather than using a completely random starting point.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--init=eps [dream]</option></term>
+ <listitem>
+ <para>
+ population initialization method:
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>eps</term>
+ <listitem><para>ball around initial parameter set</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>lhs</term>
+ <listitem><para>latin hypercube sampling</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>cov</term>
+ <listitem><para> normally distributed according to covariance matrix</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>random</term>
+ <listitem><para> uniformly distributed within parameter ranges</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--stepmon</option></term>
+ <listitem>
+ <para>
+ show details for each step</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--resynth=0</option></term>
+ <listitem>
+ <para>
+ run resynthesis error analysis for n generations</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--time_model</option></term>
+ <listitem>
+ <para>
+ run the model --steps times in order to estimate total run time.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>--profile</option></term>
+ <listitem>
+ <para>
+ run the python profiler on the model; use --steps to run multiple models for better statistics</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--chisq</option></term>
+ <listitem>
+ <para>
+ print the model description and chisq value and exit</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-m</option></term><term><option>-c</option></term><term><option>-p command</option></term>
+ <listitem>
+ <para>
+ run the python interpreter with bumps on the path:
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term>m</term>
+ <listitem><para> command is a module such as bumps.cli, run as __main__</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>c</term>
+ <listitem><para> command is a python one-line command</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>p</term>
+ <listitem><para> command is the name of a python script</para></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-i</option></term>
+ <listitem>
+ <para>
+ start the interactive interpreter</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><option>-?</option></term><term><option>-h</option></term><term><option>--help</option></term>
+ <listitem>
+ <para>
+ display this help</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+ <refsect1 id="see_also">
+ <title>SEE ALSO</title>
+ <!-- In alpabetical order. -->
+ <para>Bumps is documented fully in HTML at
+ <ulink url="file:///usr/share/doc/python-bumps-doc/html/index.html">
+ /usr/share/doc/python-bumps-doc/html/index.html</ulink> and also in the <citerefentry>
+ <refentrytitle>info</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry> system.</para>
+ </refsect1>
+</refentry>
+
diff --git a/debian/manpage.1.ex b/debian/manpage.1.ex
deleted file mode 100644
index 4384fc4..0000000
--- a/debian/manpage.1.ex
+++ /dev/null
@@ -1,56 +0,0 @@
-.\" Hey, EMACS: -*- nroff -*-
-.\" (C) Copyright 2017 Drew Parsons <Drew Parsons <dparsons at debian.org>>,
-.\"
-.\" First parameter, NAME, should be all caps
-.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
-.\" other parameters are allowed: see man(7), man(1)
-.TH Python-bumps SECTION "October 26 2017"
-.\" Please adjust this date whenever revising the manpage.
-.\"
-.\" Some roff macros, for reference:
-.\" .nh disable hyphenation
-.\" .hy enable hyphenation
-.\" .ad l left justify
-.\" .ad b justify to both left and right margins
-.\" .nf disable filling
-.\" .fi enable filling
-.\" .br insert line break
-.\" .sp <n> insert n+1 empty lines
-.\" for manpage-specific macros, see man(7)
-.SH NAME
-python-bumps \- program to do something
-.SH SYNOPSIS
-.B python-bumps
-.RI [ options ] " files" ...
-.br
-.B bar
-.RI [ options ] " files" ...
-.SH DESCRIPTION
-This manual page documents briefly the
-.B python-bumps
-and
-.B bar
-commands.
-.PP
-.\" TeX users may be more comfortable with the \fB<whatever>\fP and
-.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
-.\" respectively.
-\fBpython-bumps\fP is a program that...
-.SH OPTIONS
-These programs follow the usual GNU command line syntax, with long
-options starting with two dashes (`-').
-A summary of options is included below.
-For a complete description, see the Info files.
-.TP
-.B \-h, \-\-help
-Show summary of options.
-.TP
-.B \-v, \-\-version
-Show version of program.
-.SH SEE ALSO
-.BR bar (1),
-.BR baz (1).
-.br
-The programs are documented fully by
-.IR "The Rise and Fall of a Fooish Bar" ,
-available via the Info system.
diff --git a/debian/manpage.sgml.ex b/debian/manpage.sgml.ex
deleted file mode 100644
index 4237ad6..0000000
--- a/debian/manpage.sgml.ex
+++ /dev/null
@@ -1,154 +0,0 @@
-<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
-
-<!-- Process this file with docbook-to-man to generate an nroff manual
- page: `docbook-to-man manpage.sgml > manpage.1'. You may view
- the manual page with: `docbook-to-man manpage.sgml | nroff -man |
- less'. A typical entry in a Makefile or Makefile.am is:
-
-manpage.1: manpage.sgml
- docbook-to-man $< > $@
-
-
- The docbook-to-man binary is found in the docbook-to-man package.
- Please remember that if you create the nroff version in one of the
- debian/rules file targets (such as build), you will need to include
- docbook-to-man in your Build-Depends control field.
-
- -->
-
- <!-- Fill in your name for FIRSTNAME and SURNAME. -->
- <!ENTITY dhfirstname "<firstname>FIRSTNAME</firstname>">
- <!ENTITY dhsurname "<surname>SURNAME</surname>">
- <!-- Please adjust the date whenever revising the manpage. -->
- <!ENTITY dhdate "<date>October 26 2017</date>">
- <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
- allowed: see man(7), man(1). -->
- <!ENTITY dhsection "<manvolnum>SECTION</manvolnum>">
- <!ENTITY dhemail "<email>Drew Parsons <dparsons at debian.org></email>">
- <!ENTITY dhusername "Drew Parsons">
- <!ENTITY dhucpackage "<refentrytitle>Python-bumps</refentrytitle>">
- <!ENTITY dhpackage "python-bumps">
-
- <!ENTITY debian "<productname>Debian</productname>">
- <!ENTITY gnu "<acronym>GNU</acronym>">
- <!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
-]>
-
-<refentry>
- <refentryinfo>
- <address>
- &dhemail;
- </address>
- <author>
- &dhfirstname;
- &dhsurname;
- </author>
- <copyright>
- <year>2003</year>
- <holder>&dhusername;</holder>
- </copyright>
- &dhdate;
- </refentryinfo>
- <refmeta>
- &dhucpackage;
-
- &dhsection;
- </refmeta>
- <refnamediv>
- <refname>&dhpackage;</refname>
-
- <refpurpose>program to do something</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>&dhpackage;</command>
-
- <arg><option>-e <replaceable>this</replaceable></option></arg>
-
- <arg><option>--example <replaceable>that</replaceable></option></arg>
- </cmdsynopsis>
- </refsynopsisdiv>
- <refsect1>
- <title>DESCRIPTION</title>
-
- <para>This manual page documents briefly the
- <command>&dhpackage;</command> and <command>bar</command>
- commands.</para>
-
- <para>This manual page was written for the &debian; distribution
- because the original program does not have a manual page.
- Instead, it has documentation in the &gnu;
- <application>Info</application> format; see below.</para>
-
- <para><command>&dhpackage;</command> is a program that...</para>
-
- </refsect1>
- <refsect1>
- <title>OPTIONS</title>
-
- <para>These programs follow the usual &gnu; command line syntax,
- with long options starting with two dashes (`-'). A summary of
- options is included below. For a complete description, see the
- <application>Info</application> files.</para>
-
- <variablelist>
- <varlistentry>
- <term><option>-h</option>
- <option>--help</option>
- </term>
- <listitem>
- <para>Show summary of options.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>-v</option>
- <option>--version</option>
- </term>
- <listitem>
- <para>Show version of program.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
- <refsect1>
- <title>SEE ALSO</title>
-
- <para>bar (1), baz (1).</para>
-
- <para>The programs are documented fully by <citetitle>The Rise and
- Fall of a Fooish Bar</citetitle> available via the
- <application>Info</application> system.</para>
- </refsect1>
- <refsect1>
- <title>AUTHOR</title>
-
- <para>This manual page was written by &dhusername; &dhemail; for
- the &debian; system (and may be used by others). Permission is
- granted to copy, distribute and/or modify this document under
- the terms of the &gnu; General Public License, Version 2 any
- later version published by the Free Software Foundation.
- </para>
- <para>
- On Debian systems, the complete text of the GNU General Public
- License can be found in /usr/share/common-licenses/GPL.
- </para>
-
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:2
-sgml-indent-data:t
-sgml-parent-document:nil
-sgml-default-dtd-file:nil
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
diff --git a/debian/manpage.xml.ex b/debian/manpage.xml.ex
deleted file mode 100644
index 6b7faaf..0000000
--- a/debian/manpage.xml.ex
+++ /dev/null
@@ -1,291 +0,0 @@
-<?xml version='1.0' encoding='UTF-8'?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
-"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-
-<!--
-
-`xsltproc -''-nonet \
- -''-param man.charmap.use.subset "0" \
- -''-param make.year.ranges "1" \
- -''-param make.single.year.ranges "1" \
- /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
- manpage.xml'
-
-A manual page <package>.<section> will be generated. You may view the
-manual page with: nroff -man <package>.<section> | less'. A typical entry
-in a Makefile or Makefile.am is:
-
-DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/manpages/docbook.xsl
-XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
-
-manpage.1: manpage.xml
- $(XP) $(DB2MAN) $<
-
-The xsltproc binary is found in the xsltproc package. The XSL files are in
-docbook-xsl. A description of the parameters you can use can be found in the
-docbook-xsl-doc-* packages. Please remember that if you create the nroff
-version in one of the debian/rules file targets (such as build), you will need
-to include xsltproc and docbook-xsl in your Build-Depends control field.
-Alternatively use the xmlto command/package. That will also automatically
-pull in xsltproc and docbook-xsl.
-
-Notes for using docbook2x: docbook2x-man does not automatically create the
-AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
-<refsect1> ... </refsect1>.
-
-To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
-read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
-found in the docbook-xsl-doc-html package.
-
-Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
-
-General documentation about man-pages and man-page-formatting:
-man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
-
--->
-
- <!-- Fill in your name for FIRSTNAME and SURNAME. -->
- <!ENTITY dhfirstname "FIRSTNAME">
- <!ENTITY dhsurname "SURNAME">
- <!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
- <!ENTITY dhusername "Drew Parsons">
- <!ENTITY dhemail "Drew Parsons <dparsons at debian.org>">
- <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
- allowed: see man(7), man(1) and
- http://www.tldp.org/HOWTO/Man-Page/q2.html. -->
- <!ENTITY dhsection "SECTION">
- <!-- TITLE should be something like "User commands" or similar (see
- http://www.tldp.org/HOWTO/Man-Page/q2.html). -->
- <!ENTITY dhtitle "python-bumps User Manual">
- <!ENTITY dhucpackage "Python-bumps">
- <!ENTITY dhpackage "python-bumps">
-]>
-
-<refentry>
- <refentryinfo>
- <title>&dhtitle;</title>
- <productname>&dhpackage;</productname>
- <authorgroup>
- <author>
- <firstname>&dhfirstname;</firstname>
- <surname>&dhsurname;</surname>
- <contrib>Wrote this manpage for the Debian system.</contrib>
- <address>
- <email>&dhemail;</email>
- </address>
- </author>
- </authorgroup>
- <copyright>
- <year>2007</year>
- <holder>&dhusername;</holder>
- </copyright>
- <legalnotice>
- <para>This manual page was written for the Debian system
- (and may be used by others).</para>
- <para>Permission is granted to copy, distribute and/or modify this
- document under the terms of the GNU General Public License,
- Version 2 or (at your option) any later version published by
- the Free Software Foundation.</para>
- <para>On Debian systems, the complete text of the GNU General Public
- License can be found in
- <filename>/usr/share/common-licenses/GPL</filename>.</para>
- </legalnotice>
- </refentryinfo>
- <refmeta>
- <refentrytitle>&dhucpackage;</refentrytitle>
- <manvolnum>&dhsection;</manvolnum>
- </refmeta>
- <refnamediv>
- <refname>&dhpackage;</refname>
- <refpurpose>program to do something</refpurpose>
- </refnamediv>
- <refsynopsisdiv>
- <cmdsynopsis>
- <command>&dhpackage;</command>
- <!-- These are several examples, how syntaxes could look -->
- <arg choice="plain"><option>-e <replaceable>this</replaceable></option></arg>
- <arg choice="opt"><option>--example=<parameter>that</parameter></option></arg>
- <arg choice="opt">
- <group choice="req">
- <arg choice="plain"><option>-e</option></arg>
- <arg choice="plain"><option>--example</option></arg>
- </group>
- <replaceable class="option">this</replaceable>
- </arg>
- <arg choice="opt">
- <group choice="req">
- <arg choice="plain"><option>-e</option></arg>
- <arg choice="plain"><option>--example</option></arg>
- </group>
- <group choice="req">
- <arg choice="plain"><replaceable>this</replaceable></arg>
- <arg choice="plain"><replaceable>that</replaceable></arg>
- </group>
- </arg>
- </cmdsynopsis>
- <cmdsynopsis>
- <command>&dhpackage;</command>
- <!-- Normally the help and version options make the programs stop
- right after outputting the requested information. -->
- <group choice="opt">
- <arg choice="plain">
- <group choice="req">
- <arg choice="plain"><option>-h</option></arg>
- <arg choice="plain"><option>--help</option></arg>
- </group>
- </arg>
- <arg choice="plain">
- <group choice="req">
- <arg choice="plain"><option>-v</option></arg>
- <arg choice="plain"><option>--version</option></arg>
- </group>
- </arg>
- </group>
- </cmdsynopsis>
- </refsynopsisdiv>
- <refsect1 id="description">
- <title>DESCRIPTION</title>
- <para>This manual page documents briefly the
- <command>&dhpackage;</command> and <command>bar</command>
- commands.</para>
- <para>This manual page was written for the Debian distribution
- because the original program does not have a manual page.
- Instead, it has documentation in the GNU <citerefentry>
- <refentrytitle>info</refentrytitle>
- <manvolnum>1</manvolnum>
- </citerefentry> format; see below.</para>
- <para><command>&dhpackage;</command> is a program that...</para>
- </refsect1>
- <refsect1 id="options">
- <title>OPTIONS</title>
- <para>The program follows the usual GNU command line syntax,
- with long options starting with two dashes (`-'). A summary of
- options is included below. For a complete description, see the
- <citerefentry>
- <refentrytitle>info</refentrytitle>
- <manvolnum>1</manvolnum>
- </citerefentry> files.</para>
- <variablelist>
- <!-- Use the variablelist.term.separator and the
- variablelist.term.break.after parameters to
- control the term elements. -->
- <varlistentry>
- <term><option>-e <replaceable>this</replaceable></option></term>
- <term><option>--example=<replaceable>that</replaceable></option></term>
- <listitem>
- <para>Does this and that.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>-h</option></term>
- <term><option>--help</option></term>
- <listitem>
- <para>Show summary of options.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><option>-v</option></term>
- <term><option>--version</option></term>
- <listitem>
- <para>Show version of program.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
- <refsect1 id="files">
- <title>FILES</title>
- <variablelist>
- <varlistentry>
- <term><filename>/etc/foo.conf</filename></term>
- <listitem>
- <para>The system-wide configuration file to control the
- behaviour of <application>&dhpackage;</application>. See
- <citerefentry>
- <refentrytitle>foo.conf</refentrytitle>
- <manvolnum>5</manvolnum>
- </citerefentry> for further details.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><filename>${HOME}/.foo.conf</filename></term>
- <listitem>
- <para>The per-user configuration file to control the
- behaviour of <application>&dhpackage;</application>. See
- <citerefentry>
- <refentrytitle>foo.conf</refentrytitle>
- <manvolnum>5</manvolnum>
- </citerefentry> for further details.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
- <refsect1 id="environment">
- <title>ENVIRONMENT</title>
- <variablelist>
- <varlistentry>
- <term><envar>FOO_CONF</envar></term>
- <listitem>
- <para>If used, the defined file is used as configuration
- file (see also <xref linkend="files"/>).</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </refsect1>
- <refsect1 id="diagnostics">
- <title>DIAGNOSTICS</title>
- <para>The following diagnostics may be issued
- on <filename class="devicefile">stderr</filename>:</para>
- <variablelist>
- <varlistentry>
- <term><errortext>Bad configuration file. Exiting.</errortext></term>
- <listitem>
- <para>The configuration file seems to contain a broken configuration
- line. Use the <option>--verbose</option> option, to get more info.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- <para><command>&dhpackage;</command> provides some return codes, that can
- be used in scripts:</para>
- <segmentedlist>
- <segtitle>Code</segtitle>
- <segtitle>Diagnostic</segtitle>
- <seglistitem>
- <seg><errorcode>0</errorcode></seg>
- <seg>Program exited successfully.</seg>
- </seglistitem>
- <seglistitem>
- <seg><errorcode>1</errorcode></seg>
- <seg>The configuration file seems to be broken.</seg>
- </seglistitem>
- </segmentedlist>
- </refsect1>
- <refsect1 id="bugs">
- <!-- Or use this section to tell about upstream BTS. -->
- <title>BUGS</title>
- <para>The program is currently limited to only work
- with the <package>foobar</package> library.</para>
- <para>The upstreams <acronym>BTS</acronym> can be found
- at <ulink url="http://bugzilla.foo.tld"/>.</para>
- </refsect1>
- <refsect1 id="see_also">
- <title>SEE ALSO</title>
- <!-- In alpabetical order. -->
- <para><citerefentry>
- <refentrytitle>bar</refentrytitle>
- <manvolnum>1</manvolnum>
- </citerefentry>, <citerefentry>
- <refentrytitle>baz</refentrytitle>
- <manvolnum>1</manvolnum>
- </citerefentry>, <citerefentry>
- <refentrytitle>foo.conf</refentrytitle>
- <manvolnum>5</manvolnum>
- </citerefentry></para>
- <para>The programs are documented fully by <citetitle>The Rise and
- Fall of a Fooish Bar</citetitle> available via the <citerefentry>
- <refentrytitle>info</refentrytitle>
- <manvolnum>1</manvolnum>
- </citerefentry> system.</para>
- </refsect1>
-</refentry>
-
diff --git a/debian/python-bumps.manpages b/debian/python-bumps.manpages
new file mode 100644
index 0000000..056da55
--- /dev/null
+++ b/debian/python-bumps.manpages
@@ -0,0 +1 @@
+debian/bumps.1
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/python-bumps.git
More information about the debian-science-commits
mailing list