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