5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in.manpages foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in.manpages	2014-08-28 14:48:37.799189679 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-cleanupdrivers.1.in	2014-08-28 14:48:37.799189679 +0100
5462d0
@@ -0,0 +1,16 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-CLEANUPDRIVERS 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-cleanupdrivers \- Remove driver entries with no command line
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-cleanupdrivers\fR\ 'u
5462d0
+\fBfoomatic-cleanupdrivers\fR [\fIDBDIR\fR]
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+The \fBfoomatic\-cleanupdrivers\fR command removes all driver XML
5462d0
+files which have an empty command line.
5462d0
+
5462d0
+.PP
5462d0
+It is not intended to be called directly by the user.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-datafile.1.manpages foomatic-db-engine-4.0.11/foomatic-datafile.1
5462d0
--- foomatic-db-engine-4.0.11/foomatic-datafile.1.manpages	2014-08-28 14:48:37.799189679 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-datafile.1	2014-08-28 14:48:37.799189679 +0100
5462d0
@@ -0,0 +1 @@
5462d0
+.so man1/foomatic-ppdfile.1
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-extract-text.1.in.manpages foomatic-db-engine-4.0.11/foomatic-extract-text.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-extract-text.1.in.manpages	2014-08-28 14:48:37.799189679 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-extract-text.1.in	2014-08-28 14:48:37.799189679 +0100
5462d0
@@ -0,0 +1,16 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-EXTRACT-TEXT 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-extract-text \- Generate .po files from Foomatic UI strings
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-extract-text\fR\ 'u
5462d0
+\fBfoomatic-extract-text\fR
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+The \fBfoomatic\-extract\-text\fR command generates .po files from the
5462d0
+UI strings in the currently installed Foomatic database.
5462d0
+
5462d0
+.PP
5462d0
+It is not intended to be called directly by the user.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in.manpages foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in.manpages	2014-08-28 14:48:37.799189679 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-fix-xml.1.in	2014-08-28 14:48:37.799189679 +0100
5462d0
@@ -0,0 +1,14 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-FIX-XML 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-fix-xml \- Remove leading blank lines from Foomatic database
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-fix-xml\fR\ 'u
5462d0
+\fBfoomatic-fix-xml\fR [\fIDBDIR\fR]
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+Use the \fBfoomatic\-fix\-xml\fR command if you have compiled
5462d0
+foomatic-perl-data against libxml 1.x and you have old database
5462d0
+entries with a leading blank line.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in.manpages foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in.manpages	2014-08-28 14:48:37.800189684 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-nonumericalids.1.in	2014-08-28 14:48:37.800189684 +0100
5462d0
@@ -0,0 +1,17 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-NONUMERICALIDS 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-nonumericalids \- Convert numerical printer IDS to clear-text IDs
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-nonumericalids\fR\ 'u
5462d0
+\fBfoomatic-nonumericalids\fR
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+This script changes all old cryptic numerical printer IDs from the old
5462d0
+PostGreSQL time to clear-text printer IDs in the installed Foomatic
5462d0
+database.
5462d0
+
5462d0
+.PP
5462d0
+It is very unlikely you need to do this.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in.manpages foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in.manpages	2014-08-28 14:48:37.800189684 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-ppd-to-xml.1.in	2014-08-28 14:48:37.800189684 +0100
5462d0
@@ -0,0 +1,104 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-PPD-TO-XML 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-ppd-to-xml \- Generate Foomatic printer XML from a PPD
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-ppd-to-xml\fR\ 'u
5462d0
+\fBfoomatic-ppd-to-xml\fR \fIOPTIONS\FR [\fIDRIVER\fR:]\fIPPD\fR [[\fIDRIVER\fR:]\fIPPD\fR ...]
5462d0
+.HP \w'\fBfoomatic-ppd-to-xml\fR\ 'u
5462d0
+\fBfoomatic-ppd-to-xml\fR \-h
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+The first form of the
5462d0
+.B foomatic-ppd-to-xml
5462d0
+command creates Foomatic printer XML corresponding to a given PPD
5462d0
+file.
5462d0
+
5462d0
+.PP
5462d0
+If \fIDRIVER\fR is specified, it is the driver to which the PPD file
5462d0
+should get assigned. If not supplied, the first driver in the driver
5462d0
+list supplied via the \fB\-d\fR option is used. Note that the PPD files
5462d0
+have to be supplied to different drivers, so drivers need to be
5462d0
+specified if using more than one PPD.
5462d0
+
5462d0
+.PP
5462d0
+The second form prints a help message and exits.
5462d0
+
5462d0
+.SS Options
5462d0
+.TP 5
5462d0
+\fB\-d\fR \fIDRIVERS\fR
5462d0
+Comma-separated list of drivers with which the printer works. First
5462d0
+driver is the one for which the PPD file is. If not otherwise stated
5462d0
+by the \fB\-r\fR option, this is also the recommended driver. Drivers
5462d0
+already specified together with PPDs do not need to be specified with
5462d0
+this option again. The option is not needed if drivers are specified
5462d0
+for all PPDs.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-r\fR \fIDRIVER\fR
5462d0
+Recommended driver.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-p\fR \fIPDLS\fR
5462d0
+Comma-separated list of known Page Description Languages (PDLs) which
5462d0
+the printer supports. This will add all suitable drivers to the XML
5462d0
+entry. Currently supported are: Postscript, PCLXL, PCL6, PCL5e, PCL5c,
5462d0
+PCL5, and PCL4.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-l\fR
5462d0
+Add a link to the PPD file to the driver entry in the XML file.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-b\fR \fIDIRECTORY\fR
5462d0
+Base directory for a relative link to the PPD. If the base directory
5462d0
+is given, the link set via the \fB\-l\fR option is relative to this
5462d0
+directory (and not relative to the current directory). With a base
5462d0
+directory given the \fIPPD\fR can also be given relative to this
5462d0
+directory.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-D\fR
5462d0
+Add only the driver requested by \fB\-d\fR and \fB\-r\fR to the driver
5462d0
+list in the XML file, do not add drivers based on PDLs, not even on
5462d0
+the PDLs supplied by the \fB\-p\fR option.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-c\fR \fICOMMENT\fR
5462d0
+Add the given comment to the comment field of the XML file. Comments
5462d0
+are in HTML.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-C\fR
5462d0
+Suppress any default comments (max paper width, pages per minute,
5462d0
+automatically generated XML, ...). Does not suppress the comment
5462d0
+supplied with \fB\-c\fR.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-f\fR \fIDIRECTORY\fR
5462d0
+Directory in which to write the resulting XML file. The name of the
5462d0
+file will be the printer ID with the ".xml" extension.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-n\fR
5462d0
+Do not write modified versions of existing XML files, only create XML
5462d0
+files for printers for which there is no XML file yet.
5462d0
+
5462d0
+.TP 5
5462d0
+\fB\-x\fR
5462d0
+Create XML files independent of whether or not there are already XML
5462d0
+files for the printers covered by the PPD. This makes the process
5462d0
+vastly faster if you have PPD files for printers which are definitely
5462d0
+not yet in the Foomatic database.
5462d0
+
5462d0
+.SH EXIT STATUS
5462d0
+\fBfoomatic-ppd-to-xml\fR returns 0 on success, 1 otherwise.
5462d0
+
5462d0
+.SH BUGS
5462d0
+None so far.
5462d0
+
5462d0
+Please post bug reports on
5462d0
+
5462d0
+http://lists.freestandards.org/mailman/listinfo/printing-foomatic
5462d0
+
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-preferred-driver.8.in.manpages foomatic-db-engine-4.0.11/foomatic-preferred-driver.8.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-preferred-driver.8.in.manpages	2014-08-28 14:48:59.729304630 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-preferred-driver.8.in	2014-08-28 15:00:59.291077529 +0100
5462d0
@@ -1,25 +1,16 @@
5462d0
 .\" This -*- nroff -*- source file is part of foomatic.
5462d0
 .\"
5462d0
-.TH FOOMATIC-PREFERRED-DRIVER 8 "2001-05-07" "Foomatic Project"
5462d0
+.TH FOOMATIC-PREFERRED-DRIVER 8 "2014-08-28" "Foomatic Project"
5462d0
 .SH NAME
5462d0
-foomatic-preferred-driver \- <put a short description here>
5462d0
+foomatic-preferred-driver \- set default drivers in Foomatic database
5462d0
 .SH SYNOPSIS
5462d0
 .B foomatic-preferred-driver
5462d0
-.\"[\fIOPTION\fR]...
5462d0
 
5462d0
-[To be edited]
5462d0
-
5462d0
-.SH SEE ALSO
5462d0
-.IR foomatic-XXX (1),
5462d0
-
5462d0
-.SH EXIT STATUS
5462d0
-.B foomatic-preferred-driver
5462d0
-returns ...
5462d0
-
5462d0
-.SH AUTHOR
5462d0
-Manfred Wassmann <\fImanolo@NCC-1701.B.Shuttle.de\fR> for the foomatic
5462d0
-project using output from the associated binary.
5462d0
-
5462d0
-.SH BUGS
5462d0
-This manpage contains no useful information.
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+This command reads the printer database overview and puts default
5462d0
+driver entries (<driver>..</driver>) into every printer's XML database
5462d0
+entry.
5462d0
 
5462d0
+.PP
5462d0
+It is very unlikely you need to do this.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in.manpages foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in.manpages	2014-08-28 14:48:37.800189684 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-printermap-to-gutenprint-xml.1.in	2014-08-28 14:48:37.800189684 +0100
5462d0
@@ -0,0 +1,18 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-PRINTERMAP-TO-GUTENPRINT-XML 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-printermap-to-gutenprint-xml \- Updates Gutenprint driver XML file
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-printermap-to-gutenprint-xml\fR\ 'u
5462d0
+\fBfoomatic-printermap-to-gutenprint-xml\fR
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+This command updates the driver XML file for the Gutenprint driver to
5462d0
+the state of the foomatic-printermap file in the Gutenprint source
5462d0
+tree. Used to update the driver XML file for Gutenprint in the
5462d0
+OpenPrinting database.
5462d0
+
5462d0
+.PP
5462d0
+It is very unlikely you need to do this.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in.manpages foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in.manpages	2014-08-28 14:48:37.800189684 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-replaceoldprinterids.1.in	2014-08-28 14:48:37.800189684 +0100
5462d0
@@ -0,0 +1,18 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-REPLACEOLDPRINTERIDS 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-replaceoldprinterids \- Replace references to old printer IDs
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-replaceoldprinterids\fR\ 'u
5462d0
+\fBfoomatic-replaceoldprinterids\fR
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+.PP
5462d0
+Replaces references to old numerical or otherwise obsolete printer IDs
5462d0
+in arbitrary file. By default it uses the db/oldprinterids file of the
5462d0
+current Foomatic database as translation table, but you can use
5462d0
+arbitrary translation tables.
5462d0
+
5462d0
+.PP
5462d0
+It is very unlikely you need to use this.
5462d0
diff -up foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in.manpages foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in
5462d0
--- foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in.manpages	2014-08-28 14:48:37.800189684 +0100
5462d0
+++ foomatic-db-engine-4.0.11/foomatic-searchprinter.1.in	2014-08-28 14:48:37.800189684 +0100
5462d0
@@ -0,0 +1,82 @@
5462d0
+.\" This -*- nroff -*- source file is part of foomatic.
5462d0
+.\"
5462d0
+.TH FOOMATIC-SEARCHPRINTER 1 "2014-08-21" "Foomatic Project"
5462d0
+.SH NAME
5462d0
+foomatic-searchprinter \- Search Foomatic database
5462d0
+.SH SYNOPSIS
5462d0
+.HP \w'\fBfoomatic-searchprinter\fR\ 'u
5462d0
+\fBfoomatic-searchprinter\fR [\-m\fIM\fR] [\-d\FID\fR] \fISEARCHTERM\fR
5462d0
+.HP \w'\fBfoomatic-searchprinter\fR\ 'u
5462d0
+\fBfoomatic-searchprinter\fR \-h
5462d0
+
5462d0
+.SH DESCRIPTION
5462d0
+This command displays Foomatic database entries matching \fISEARCHTERM\fR.
5462d0
+
5462d0
+.SS Options
5462d0
+.PP
5462d0
+\fB\-m\fR\fIM\fR
5462d0
+.RS 4
5462d0
+Search mode:
5462d0
+.PP
5462d0
+\fIM\fR = 0
5462d0
+.RS 4
5462d0
+Match everything (default)
5462d0
+.RE
5462d0
+.PP
5462d0
+\fIM\fR = 1
5462d0
+.RS 4
5462d0
+No matches on only the manufacturer
5462d0
+.RE
5462d0
+.PP
5462d0
+\fIM\fR = 2
5462d0
+.RS 4
5462d0
+No matches on only the manufacturer or only the model
5462d0
+.RE
5462d0
+.PP
5462d0
+\fIM\fR = 3
5462d0
+.RS 4
5462d0
+Exact matches of device ID, make/model, or Foomatic ID plus matches of
5462d0
+the page description language in the device ID to appropriate
5462d0
+"Generic" printers
5462d0
+.RE
5462d0
+.PP
5462d0
+\fIM\fR = 4
5462d0
+.RS 4
5462d0
+Exact matches of device ID, make/model, or Foomatic ID only
5462d0
+.RE
5462d0
+.RE
5462d0
+
5462d0
+.PP
5462d0
+\fB\-d\fR\fID\fR
5462d0
+.RS 4
5462d0
+Display results:
5462d0
+.PP
5462d0
+\fID\fR = 0
5462d0
+.RS 4
5462d0
+Everything
5462d0
+.RE
5462d0
+.PP
5462d0
+\fID\fR = 1
5462d0
+.RS 4
5462d0
+Only best match class (default)
5462d0
+.RE
5462d0
+.PP
5462d0
+\fID\fR = 2
5462d0
+.RS 4
5462d0
+Only best match
5462d0
+.RE
5462d0
+.RE
5462d0
+
5462d0
+.PP
5462d0
+\fB\-h\fR
5462d0
+.RS 4
5462d0
+Show help message and exit.
5462d0
+.RE
5462d0
+
5462d0
+.SH BUGS
5462d0
+None so far.
5462d0
+
5462d0
+Please post bug reports on
5462d0
+
5462d0
+http://lists.freestandards.org/mailman/listinfo/printing-foomatic
5462d0
+