NAME
    foomatic-configure - the main  configuration program of the foomatic
    printing system.

SYNOPSIS
    foomatic-configure [OPTION]...

    foomatic-configure -n queuename [ -N description ] [ -L loca-
    tion ] [ -c con-
    nect ] [ -d driver ] [ -p printer ] [ -s spooler ] [ -C [ source-
    spooler ] source-
    queue ] [ -o option1=value1 -o option2 ... ] [ -q ] [ --oldppd ]
    foomatic-configure -D -n queuename [ -s spooler ] [ -q ]

    foomatic-configure -R -n queuename [ -s spooler ] [ -q ]

    foomatic-configure -Q [ -s spooler ] [ -n queuename ] [ -r ]

    foomatic-configure -P [ -s spooler ] [ -n queuename ] [ index ]

    foomatic-configure -X -p printer | -d driver | -p printer -d driver

    foomatic-configure -O

    foomatic-configure -h

    foomatic-configure --help

DESCRIPTION
    foomatic-configure is a program to establish and configure print
    queues, drivers, spoolers, etc using the foomatic database and compan-
    ion filters.

    It also  comprises half of a programatic API for user tools: you can
    learn and control everything about the  static  properties of  print
    queues here.  With the sister program foomatic-printjob, you can do
    everything related to print queue dynamic state: submit jobs, and
    query, cancel, reorder, and redirect them.

 Options
    -n queuename
   Configure this print queue

    -N Name/Description
   Use this proper human-readable name/description

    -L Location
   Short phrase describing this printer's location

    -c connection
   Printer is connected thusly (ex file:/dev/lp0)

    -d driver Foomatic database name for desired printer driver

    -p printer
   Foomatic id for printer

    -s spooler
   Explicit spooler type (cups, lpd, lprng, pdq, ppr, direct)

    -o option=value
   Set the default of option to value

    -o option Turn on option by default

    --oldppd  Use the old CUPS-O-Matic PPD files for CUPS queues (default
   are the PPD-O-Matic PPDs)

    -D  Set this queue as the default queue (just give -n queuename)

    -R  Remove this whole queue entirely (just give -n queuename)

    -C [ sourcespooler ] sourcequeue
   Copy sourcequeue from sourcespooler (or the current one if
   sourcespooler is not given) into the queue given by -n queue-
   name (of the current spooler).

    -Q  Query existing configuration (gives XML summary)

    -r  List also remotely defined queues (CUPS only)

    -P [ index ]
   Get Perl dump of current configuration (as a Perl array named
   QUEUES, the first index is index, or zero if index is not
   given)

    -O  Print XML Overview of all known printer/drivers (this  shows
   also the Foomatic IDs of the printers)

    -X  Print XML data for -p printer and/or -d driver object

    -q  Run quietly

 Commands
    No commands, just options

FILES
    /etc/foomatic/lpd/<queue>

    /etc/foomatic/<queue>.xml

    /etc/printcap  The systems list of configured printers.

SEE ALSO
   foomatic-printjob(1),

EXIT STATUS
    foomatic-configure returns 0 if no errors occurred.

AUTHOR
    Manfred  Wassmann  <manolo@NCC-1701.B.Shuttle.de> for  the foomatic
    project using comments from the source.

BUGS
    foomatic-configure currently cannot handle printcap files in the  lprng
    style. As lprng can use BSD style printcaps this is not much of a
    problem, as long as the GUI based print manager lprngtool is not  used.
    The difference between those formats is, that BSD style requires con-
    tinuation lines in printer definitions to be ended with a colon and the
    newline character to be escaped with a backslash. Lprng has no such
    restriction.

    To use a printcap file generated or  edited  with lprngtool with
    foomatic-configure it is necessary to add :\ to the end of all but the
    last line of every printer definition, just as shown below:

    #comment
    # primary printer name
    lp
    #alternate names
 |lp2|lp3
 |Example of a printer
 :sd=/usr/spool/LPD/lp
 :rw:lp=/dev/lp:mx#100
 :

    must be converted to:

    #comment
    # primary printer name
    lp\
 |lp2|lp3\
 |Example of a printer\
 :sd=/usr/spool/LPD/lp:\
 :rw:lp=/dev/lp:mx#100:

    This manpage may be out of date.