dtfilter(1M)                                            dtfilter(1M)


       NAME
             dtfilter - add an entry to the UnixWare Desktop printer filter
             table

       SYNOPSIS
             dtfilter -a [-o] file . . .
             dtfilter -d entry . . .

       DESCRIPTION
             The dtfilter command adds or deletes an entry to the printer
             filter table.  The printer filter table is used by the
             UnixWare Desktop Printer Setup facility to prompt users for
             printer filter options.

             -a    add entries in file, to the printer filter table

             -o    overwrite existing entries of the same name

             -d entry
                   remove entry from the filter table

             A filter table entry has the format:

                   EntryName<TAB>LabelString[^CatalogFile:Index]<TAB>OptionString

             EntryName
                   tag used to reference the entry

             LabelString[^CatalogFile:Index]
                   checkbox label, for example, Landscape mode: or Reverse
                   order printing: Note that [CatalogFile:Index:]
                   translates LabelString.  CatalogFile is the file of
                   locale specific translations.  index is the line number
                   of the translation.

             OptionString
                   option syntax, this can be a simple string (no % may be
                   included in the entry) or complex string (a % must be in
                   the entry).  A %% may be used to embed a percent
                   character in either simple or complex strings.

                   A simple string will be presented as a simple checkbox.
                   It is passed to lp via the -y option and should match
                   one of the ``mode strings'' already defined for the
                   print filter [see lp(1) and lpfilter(1M)].



                           Copyright 1994 Novell, Inc.               Page 1

      dtfilter(1M)                                            dtfilter(1M)


                  A complex string will require textual user input.  The
                  entry uses a printf-like format.

                  %d    integer field

                  %s    string field

                  %c    character field

                  %u    unsigned integer field

                  %f    floating point field

         Environment
            The dtfilter command uses the XWINHOME environment variable to
            locate printer filter tables.  The default value of XWINHOME
            is /usr/X, so /usr/X/desktop/PrintMgr/Filters will be
            searched.

         Files
            $XWINHOME/desktop/PrintMgr/Filters/*
            /usr/X/desktop/PrintMgr/Filters/*

         Exit Codes
            The dtfilter command returns

            0 success

            1 usage error

            2 format error

            3 item exists and -o not specified

            4 cannot read/write file

      USAGE
            dtfilter resides in /usr/X/adm.  Since the PATH environment
            variable does not normally include that directory, either
            specify the full pathname or add /usr/X/adm to the PATH
            variable.

         Examples
            The examples show filter strings and their corresponding user
            interfaces:



                          Copyright 1994 Novell, Inc.               Page 2

       dtfilter(1M)                                            dtfilter(1M)


                    Entry Name   User Interface         Passed to lp
                    ________________________________________________
                    landscape    Landscape Mode:[x]     landscape
                    pages        Maximum Pages:______   maxpages=%u
                    pages        Range of Pages:_____   range=%u-%u
                                                _____

             If, in the above example, the user inputs 44, 22, and 23, in
             that order, the arguments passed to lp will be

                   -ylandscape
                   -ymaxpages=44
                   -yrange=22-23

       REFERENCES
             dtprinter(1M), dttypes(1M), lp(1), lpfilter(1M)
































                           Copyright 1994 Novell, Inc.               Page 3