Provided by: html2ps_1.0b7-6_all bug

NAME

       html2psrc - configuration file format for html2ps(1)

DESCRIPTION

       Configuration files are used for layout control, resource information etc. Normally, there
       should always exist a global configuration file.   In  this  file  one  typically  specify
       things like: what image conversion packages are available on the system, the default paper
       size, the default text fonts and sizes, etc.

       For  Unix  and  Windows  systems,  the  installation  script  'install'  can  be  used  to
       automatically  build  a  global  configuration  file  with  all necessary definitions, and
       install all files. The files replaced by the installation  are  saved.  If  you  for  some
       reason  are  not satisfied with the new version: execute the script 'backout' to reinstall
       your earlier version.

       On other systems, you will have to manually create a global configuration file, and insert
       the  name  of this file into the html2ps script (close to the beginning, the line starting
       with "$globrc="). The configuration file should contain a package block, and perhaps paper
       and hyphenation blocks, described below.

       Each  user  can then have a personal configuration file (by default $HOME/.html2psrc) that
       complements/overrides the definitions made in the global file.  It  is  also  possible  to
       specify alternative files on the command line, using the -f option.

FILE FORMAT

       A configuration file can include other configuration files. This is done with:

          @import "filename";

       The rest of the configuration file consists of zero or more blocks.  A block is given by a
       block name, followed by the block definition, as in:

          BODY {
            font-size: 12pt;
            font-family: Helvetica;
            text-align: justify
          }

       The block definition, enclosed by curly braces: { }, consists of  key-value  pairs  and/or
       other  blocks.  A key-value pair consists of the key name followed by a colon, followed by
       the value. Blocks and key-value pairs are separated by semicolons. The  semicolon  may  be
       omitted after a block.

       Several  blocks  can  share  the  same  definition.  The block names are then separated be
       commas, as in:

          H2, H4, H6 { font-style: italic }

       A comment in a configuration file starts with the characters "/*" and ends with "*/":

          @html2ps {
            seq-number: 1;  /* Automatic numbering of headings */
          }

       Notations

       Here are some definitions of terms used below:

              Flag:  A value of either 0 (absence, inactive etc) or 1 (presence, active etc).
              Absolute size:
                     A real number optionally followed by one of the  following  two-letter  unit
                     identifiers:  cm  (centimeters),  mm (millimeters), in (inches), pt (points,
                     1pt = 1/72 inch), pc (picas, 1pc = 12pt). The default unit is centimeters.
              Relative size:
                     A size  relative  to  current  fontsize.  The  default  and  currently  only
                     recognized  unit  is  em.  One  em equals the size of the current font.  The
                     value should be given as a real number, optionally followed by 'em',  as  in
                     '0.25em'.
              Whitespace:
                     Any one of the characters: space, tab, newline, or carriage return.

       CSS2 blocks

       All blocks, except one: the @html2ps block, coincides with a subset of the Cascading Style
       Sheets,  level  2  CSS2  Specification  (http://www.w3.org/TR/REC-CSS2/).   The  following
       default  settings  for html2ps illustrate just about everything that currently can be used
       from the CSS2 specification:

          BODY {
            font-family: Times;
            font-size: 11pt;
            text-align: left;
            background: white;
          }

          H1, H2, H3, H4, H5, H6 {
            font-weight: bold;
            margin-top: 0.8em;
            margin-bottom: 0.5em;
          }
          H1 { font-size: 19pt }
          H2 { font-size: 17pt }
          H3 { font-size: 15pt }
          H4 { font-size: 13pt }
          H5 { font-size: 12pt }
          H6 { font-size: 11pt }

          P, OL, UL, DL, BLOCKQUOTE, PRE {
            margin-top: 1em;
            margin-bottom: 1em;
          }

          P {
            line-height: 1.2em;
            text-indent: 0;
          }

          OL, UL, DD { margin-left: 2em }

          TT, KBD, PRE { font-family: Courier }

          PRE { font-size: 9pt }

          BLOCKQUOTE {
            margin-left: 1em;
            margin-right: 1em;
          }

          ADDRESS {
            margin-top: 0.5em;
            margin-bottom: 0.5em;
          }

          TABLE {
            margin-top: 1.3em;
            margin-bottom: 1em;
          }

          DIV.noprint { display: none }

          DEL { text-decoration: line-through }

          A:link, HR { color: black }

          @page {
            margin-left: 2.5cm;
            margin-right: 2.5cm;
            margin-top: 3cm;
            margin-bottom: 3cm;
          }

       The program specific block @html2ps:

       This block is used to specify parameters that are specific to html2ps, and not covered  by
       CSS2.  The @html2ps  block has several sub-blocks and key-value pairs, these are described
       in this section.

       The package block
            This block is used to specify which program packages are  installed  on  the  system.
            Typically, this is done in the global configuration file.

            PerlMagick
                   A  flag specifying whether the Perl module PerlMagick is installed or not. The
                   default is 0.

            ImageMagick
                   A flag specifying whether the ImageMagick package is  installed  or  not.  The
                   default is 0.

            pbmplus
                   A flag specifying whether the pbmplus package is installed or not. The default
                   is 0.

            netpbm A flag specifying whether the netpbm package is installed or not. The  default
                   is 0.

            djpeg  A flag specifying whether djpeg is installed or not.  The default is 0.

            Ghostscript
                   A flag specifying whether Ghostscript is installed or not.  The default is 0.

            TeX    A flag specifying whether the TeX package is installed or not.  The default is
                   0.

            dvips  A flag specifying whether dvips is installed or not.  The default is 0.

            libwww-perl
                   A flag specifying whether the Perl module library libwww-perl is installed  or
                   not. The default is 0.

            geturl When  neither  of  the  Perl  packages  for  retrieving  remote  documents are
                   available, it is possible to use some other program like wget  or  lynx.  This
                   value  should  be  set  to a command that retrieves a document with a complete
                   MIME header, such as "wget -s -q -O-" or "lynx -source -mime_header".

            check  The name of a program used for syntax checking HTML documents.  No default,  a
                   good choice is weblint.

            path   A  colon  separated list of directories where the executables from the program
                   packages are. It is only necessary to include directories that are not in  the
                   PATH for a typical user.

       The paper block
            The  paper  size is defined in this block. The size can either be given as one of the
            recognized paper types or by giving explicit values for the paper height  and  width.
            As of version 1.0 beta2, one can also use the @page block in CSS2 for the paper size.
            The paper block is kept for backwards compatibility.   Also,  one  can  only  specify
            explicit dimensions in @page, not any paper types by name.

            type   Paper  type, possible choices are: A0, A1, A2, A3, A4,...,A10, B0, B1,...,B10,
                   letter, legal, arche, archd, archc,  archb,  archa,  flsa,  flse,  halfletter,
                   11x17, and ledger (this set of paper types is taken from Aladdin Ghostscript).
                   The default is A4.

            height An absolute size specifying the paper height.

            width  An absolute size specifying the paper width.

       The option block
            This block is used to set default values for the command line options. The key in the
            key-value pair is the option name, in either its long or short form.

            twoup  Two column (2-up) output. The default is one column per page.

            base   Use  URL  as  a base to expand relative references for in-line images. This is
                   useful if you have downloaded a document to a local file.  The URL should then
                   be the URL of the original document.

            check  Check  the  syntax  of  the  HTML file (using an external syntax checker). The
                   default is to not make a syntax check.

            toc    Generate a table of contents (ToC). The value should be a string consisting of
                   one of the letters 'f', 'h', or 't', optionally combined with the letter 'b':

                   b      The  ToC  will  be  printed  first.  This  requires that Ghostscript is
                          installed.
                   f      The ToC will be generated from the links in the converted document.
                   h      The ToC will be generated from headings and  titles  in  the  converted
                          documents. Note that if the document author for some strange reason has
                          chosen to use some other means to represent the headings than the  HTML
                          elements H1,...,H6, you are out of luck!
                   t      The  ToC  will  be generated from links having the attribute rev=TOC in
                          the converted document.

            debug  Generate debugging  information.  You  should  always  use  this  option  when
                   reporting problems with html2ps.

            DSC    Generate  DSC  compliant  PostScript.  This  requires Ghostscript and can take
                   quite some time to do. Note that a PostScript file generated with this  option
                   cannot be used as input to html2ps for reformatting later.

            encoding
                   The  document  encoding.  Currently  recognized values are ISO-8859-1, EUC-JP,
                   SHIFT-JIS, and ISO-2022-JP (other EUC-xx encodings may also work). The default
                   is ISO-8859-1.

            rcfile A  colon  separated  list  of  configuration  file names to use instead of the
                   default personal configuration file $HOME/.html2psrc.  Definitions made in one
                   file  override  definitions  in  previous files (the last file in the list has
                   highest precedence). An empty file name (as  in  ':file',  'file1::file3',  or
                   'file:')  will  expand  to the default personal file. The environment variable
                   HTML2PSPATH is used to specify the  directories  where  to  search  for  these
                   files.  (Note:  this is only supposed to be used on the command line, not in a
                   configuration file.)

            frame  Draw a frame around the text on each page. The default is to not draw a frame.

            grayscale
                   Convert colour images to grayscale images. Note that the PostScript file  will
                   be  smaller  when  the  images  are  converted to grayscale. The default is to
                   generate colour images.

            help   Show usage information.

            hyphenate
                   Hyphenate the text. This requires TeX hyphenation pattern files.

            scaleimage
                   Scale in-line images with a factor num.  The default is 1.

            cookie Enable cookie support,  using  a  netscape  formatted  cookie  file  (requires
                   libwww-perl).

            language
                   Specifies  the  language of the document (overrides an eventual LANG attribute
                   of the BODY element).  The language  should  be  given  according  to  RFC1766
                   (ftp://ftp.nordu.net/rfc/rfc1766.txt)           and           ISO          639
                   (http://www.w3.org/WAI/ER/IG/ert/iso639.htm).

            landscape
                   Generate code for printing in landscape mode. The default is portrait mode.

            scalemath
                   Scale mathematical formulas with a factor num.  The default is 1.

            mainchapter
                   Specifies the start number for automatic numbering of headings (by setting the
                   seq-number parameter), the default is 1.

            number Insert page numbers. The default is to not number the pages.

            startno
                   Specifies the starting page number, the default is 1.

            output Write the PostScript code to file. The default is to write to standard output.

            original
                   Use  PostScript  original  images  if  they  exist. For example, if a document
                   contains an image  figure.gif,  and  an  encapsulated  PostScript  file  named
                   figure.ps  exists  in  the same directory, that file will be use instead. This
                   only work for documents read as local files. Note: if the PostScript  file  is
                   large  or contains bitmap images, this must be combined with the -D option. In
                   HTML 4.0 this can be achieved in a much better way with:

               <OBJECT data="figure.ps" type="application/postscript">
                <OBJECT data="figure.gif" type="image/gif">
                 <PRE>[Maybe some ASCII art for text browsers]</PRE>
                </OBJECT>
               </OBJECT>

            rootdir
                   When a document is read from  a  local  file,  this  value  specifies  a  base
                   directory  for  resolving  relative  links starting with "/".  Typically, this
                   should be the directory where your web server's home page resides.

            xref   Insert cross  references  at  every  link  to  within  the  set  of  converted
                   documents.

            scaledoc
                   Scale the entire document with a factor num.  The default is 1.

            style  This option complements/overrides definitions made in the configuration files.
                   The string must follow the configuration file  syntax.  (Note:  this  is  only
                   supposed to be used on the command line, not in a configuration file.)

            titlepage
                   Generate a title page. The default is to not generate one.

            text   Text mode, ignore images. The default is to include the images.

            underline
                   Underline  text  that  constitutes  a  hypertext  link.  The default is to not
                   underline.

            colour Produce colour output for text and background, when specified.  The default is
                   black text on white background (mnemonic: coloUr ;-).

            version
                   Print information about the current version of html2ps.

            web    Process  a web of documents by recursively retrieve and convert documents that
                   are referenced with hyperlinks. When dealing with remote documents it will  of
                   course  be  necessary  to impose restrictions, to avoid downloading the entire
                   web... The value should be a string consisting of one of the letters 'a', 'b',
                   'l',  'r',  or 's', optionally combined with a combination of the letters 'p',
                   'L', and a positive integer:

                   a      Follow all links.
                   b      Follow only links to within the same directory, or below, as the  start
                          document.
                   l      Follow only links specified with "<LINK rel=NEXT>" in the document.
                   p      Prompt  for  each  remote  document.  This  mode  will automatically be
                          entered after the first 50 documents.
                   r      Follow only relative links.
                   s      Follow only links to within the same server as the start document.
                   L      With this option, the order in which the documents are  processed  will
                          be:  first  all  top level documents, then the documents linked to from
                          these etc. For example, if the document A has links to B and C,  and  B
                          has  a link to D, the order will be A-B-C-D.  By default, each document
                          will be followed by the first document it links to etc; so the  default
                          order for the example is A-B-D-C.
                   #      A  positive  integer giving the number of recursive levels. The default
                          is 4 (when the option is present).

            duplex Generate postscript code for single or double  sided  printing.   No  default,
                   valid values are:

                   0      Single sided.
                   1      Double sided.
                   2      Double sided, opposite page reversed (tumble mode).

       The margin block
            This  block is used to specify page margins. The left, right, top and bottom margins,
            previously  defined  with  this  block,  should  now  be  defined  using  the   @page
            construction from CSS2.

            middle An  absolute  size  for  the  distance  between  the columns when printing two
                   columns per page, default is 2cm.

       The xref block
            At every hyperlink (to within the set of converted documents) it is possible to  have
            a cross reference inserted. The xref block is used to control this function.

            text   This  defines  the  cross  reference  text  to be inserted; the symbol $N will
                   expand to the page number, default is "[p $N]".

            passes The number of passes used to insert the cross references.  Normally, only  one
                   pass  is  run. But since the insertion of the page numbers may effect the page
                   breaks, it might for large documents with many links be  necessary  with  more
                   than one pass to get the cross references right. The default is 1.

       The quote block
            Language  specific  quotation marks are defined in this block.  These quotation marks
            are used with the HTML 4.01 element Q  for  short  quotations.  Quotation  marks  are
            predefined for a few languages (English, Swedish, Danish, Norwegian (also Nynorsk and
            Bokmål), Finnish, Spanish, French, German and Italian).  It  is  possible  to  define
            different quotation marks for quotes within quotes.

            A  quotation  mark  is  defined as a string, using the same encoding as the converted
            document (normally ISO-8859-1), and/or with character entities.  Note that  quotation
            mark  characters  for  several  languages  are  not included in ISO-8859-1, and their
            corresponding character entities were not been defined prior to HTML 4.0.

            Quotation marks for a language can be defined explicitly in a sub-block of the  quote
            block.  One  can  also  identify  the  set of quotation marks with another previously
            defined language, using a key-value pair.  The sub-block/key name  should  equal  the
            language  code  as  defined in ISO 639. The language sub-block can have the following
            key-values:

                   open   The quote opening character(s).
                   close  The quote closing character(s). If undefined, it will equal open.
                   open2  The quote opening character(s) for quotes within quotes. If  undefined,
                          it will equal open.
                   close2 The  quote closing character(s) for quotes within quotes. If undefined,
                          it will equal close.

            Example: English and Spanish use the same set of quotation marks - at least according
            to my book on typography. These (already known to html2ps) are defined with:

               quote {
                 en {
                   open: "&ldquo;";
                   close: "&rdquo;";
                   open2: "`";
                   close2: "'";
                 }
                 es: en;
               }

       The toc block
            When  a  table  of contents (ToC) is generated from document headings and titles, the
            appearance is controlled by this block.

            heading
                   A string with HTML code specifying a heading used on the first ToC page.

            level  The maximum heading level used for building the ToC. The default is  6,  which
                   means that all headings will generate ToC entries.

            indent The  ToC entries are indented proportional to the corresponding heading level.
                   This value specifies the size of the indentation.  The default is 1em.

       The titlepage block
            When a title page is generated, its appearance is controlled by this block.

            content
                   A string with HTML code specifying a heading  used  on  the  title  page,  The
                   default        is       "<DIV       align=center>       <H1><BIG>$T</BIG></H1>
                   <H2>$[author]</H2></DIV>".

            margin-top
                   The size of the top margin on the title page, The default is 4cm.

       The font block
            Currently, html2ps recognizes the fonts:  Times,  New-Century-Schoolbook,  Helvetica,
            Helvetica-Narrow,  Palatino,  Avantgarde,  Bookman,  and  Courier.  To add a new font
            (family), choose a name (consisting of letters, digits, hyphens, and underscores) for
            the font. Then define a sub-block to the font block, with the same name as the chosen
            font name. This block can contain two key-value pairs:

                   names  A  string  containing  four  PostScript  font   names,   separated   by
                          whitespace,  corresponding to the font styles normal, italic, bold, and
                          bold-italic. If less than four names are given, the first is  used  for
                          the missing names. Note that PostScript font names are case sensitive.
                   files  A  string  of  four  file  names,  separated  by  whitespace, for files
                          containing font definitions for  the  four  font  styles  as  specified
                          above.

            Example:  A  font  'myfont'  has its four font styles defined in local files.  To use
            this font in all tables in the converted documents, one can use something like:

               TABLE { font-family: myfont }

               @html2ps {
                 font {
                   myfont {
                     names: "MyFont-Roman MyFont-Italic MyFont-Bold MyFont-BoldItalic";
                     files: "/x/y/myfr.pfa /x/y/myfi.pfa /x/y/myfb.pfa /x/y/myfbi.pfa";
                   }
                 }
               }

       The hyphenation block
            Hyphenation pattern files for different languages are specified in sub-blocks  within
            this  block.  The  blocks names should equal the language code as defined in ISO 639.
            These language blocks can contain the following two key-values:

                   file   A hyphenation pattern file in TeX format for this language.
                   extfile
                          A file containing a list of hyphenation exceptions for  this  language.
                          The exception file should contain words, separated by whitespaces, with
                          hyphens inserted where hyphenation is allowed,  as  in:  "in-fra-struc-
                          ture white-space".

            For example, for English (with language code 'en') one can have a block like:

                   en {
                     file: "/opt/tex/lib/macros/hyphen.tex";
                     extfile: "/opt/tdb/lib/html2ps/enhyphext";
                   }

            The hyphenation block itself can furthermore have these key-values:

            min    A  positive integer defining the minimum number of letters a word must contain
                   to make it a candidate for hyphenation.  The default is 8.

            start  A positive integer defining the minimum number of letters  that  must  precede
                   the hyphen when a word is hyphenated.  The default is 4.

            end    A positive integer defining the minimum number of letters that must follow the
                   hyphen when a word is hyphenated.  The default is 3.

       The header block
            This block is used to specify page headers. It is possible to  define  left,  center,
            and  right  headers.  Different headers for odd and even pages can be specified. Some
            symbols can be used that will expand to document title, author, date etc. See below.

            left   A left aligned header. If the alternate flag in this block is set to  1,  this
                   will be the right header on even pages.

            center A centered header.

            right  A  right aligned header. If the alternate flag in this block is set to 1, this
                   will be the left header on even pages.

            odd-left
                   A left aligned header on odd pages.

            odd-center
                   A centered header on odd pages.

            odd-right
                   A right aligned header on odd pages.

            even-left
                   A left aligned header on even pages.

            even-center
                   A centered header on even pages.

            even-right
                   A right aligned header on even pages.

            font-family
                   The font used for the header, default is Helvetica.

            font-size
                   The font size for the header, default is 8pt.

            font-style
                   The default is "normal".

            font-weight
                   The default is "normal".

            color  The header color, default is black.

            alternate
                   A flag indicating whether the headers given by the left and right keys  should
                   change  place  on  even  pages. Typically used for double sided printing.  The
                   default is 1.

       The footer block
            This block is used to specify page footers. It is possible to  define  left,  center,
            and  right  footers.  Different footers for odd and even pages can be specified. Some
            symbols can be used that will expand to document title, author, date etc. See below.

            left   A left aligned footer. If the alternate flag in this block is set to  1,  this
                   will be the right footer on even pages.

            center A centered footer.

            right  A  right aligned footer. If the alternate flag in this block is set to 1, this
                   will be the left footer on even pages.

            odd-left
                   A left aligned footer on odd pages.

            odd-center
                   A centered footer on odd pages.

            odd-right
                   A right aligned footer on odd pages.

            even-left
                   A left aligned footer on even pages.

            even-center
                   A centered footer on even pages.

            even-right
                   A right aligned footer on even pages.

            font-family
                   The font used for the footer, default is Helvetica.

            font-size
                   The font size for the footer, default is 8pt.

            font-style
                   The default is "normal".

            font-weight
                   The default is "normal".

            color  The footer color, default is black.

            alternate
                   A flag indicating whether the footers given by the left and right keys  should
                   change  place  on  even  pages. Typically used for double sided printing.  The
                   default is 1.

       The frame block
            The appearance of the optional frame (drawn on  each  page)  is  controlled  by  this
            block.

            width  The width of the frame, default is 0.6pt.

            margin The size of the frame margin, default is 0.5cm.

            color  The colour of the frame, default is black.

       The justify block
            This  block  specifies  the  maximum amount of extra space inserted between words and
            letters when text justification is in effect.

            word   Maximum amount of extra space inserted between words.  The default is 15pt.

            letter Maximum amount of extra space  inserted  between  letters  within  words.  The
                   default is 0pt.

       The draft block
            It is possible to have some text written in a large font diagonally across each page.
            Typically this is a word, written  in  a  very  light  colour,  indicating  that  the
            document is a draft.

            text   The text to be printed, default is "DRAFT".

            print  A  flag  specifying  whether  the  draft  text  should  be printed or not.  If
                   unspecified, the draft text is printed when the document head  contains  <META
                   name="Status" content="Draft">.

            dir    Specifies print direction, 0=downwards, 1=upwards.

            font-family
                   The default is Helvetica.

            font-style
                   The default is "normal".

            font-weight
                   The default is "bold".

            color  The default is "F0F0F0".

       The colour block
            The  16 standard colour names from HTML 4.01 (although their use in HTML elements are
            now deprecated) are recognized by html2ps.  Use this block to  extend  this  list  of
            colours. This is done with key-value pairs, where the key is the colour name, and the
            value is the colour given as a hexadecimal RGB value, for example: "brown: A52A2A;".
       Key-value pairs in the @html2ps block

       html2psrc
              The  name  of  the  default  personal   configuration   file.    The   default   is
              $HOME/.html2psrc.

       imgalt Specifies which text should be written as a replacement for in-line images when the
              IMG element has no ALT attribute.  The default is "[IMAGE]".

       datefmt
              The symbol $D can be used in  page  headers  and  footers  to  insert  the  current
              date/time;  the  value  of the datefmt key specifies the format used. The syntax is
              the same as in the strftime(3) routine. The default is "%e %b %Y  %R", which  gives
              a date string like " 7 May 2010  13:22".

       locale The  locale  (language  code)  used  for  formating language dependent parts of the
              date/time  in  datefmt.  If  unspecified,  the  value  is  taken  from  environment
              variables, see setlocale(3). No default.

       doc-sep
              A  string  of  HTML code that will be inserted between the documents when more than
              one are converted. The default is "<!--NewPage-->", which will cause a page  break.
              You may use (almost) any HTML code, for example "<HR><HR>" or "<IMG src=...>".

       ball-radius
              The  radius,  given  as  a relative size, of the balls used in unordered lists. The
              default is 0.25em.

       numbstyle
              Page numbering style, 0=arabic, 1=roman. The default is 0.

       showurl
              When this flag is set to 1, the URL for external links are shown within parentheses
              after the link. The default is 0.

       seq-number
              When  this flag is set, the headings in the document will be sequentially numbered:
              H1 headings will be numbered 1, 2,..., H2 headings  1.1,  1.2,  etc.  The  starting
              number for H1 can be changed using the -M (--mainchapter) option. The default is 0.

       extrapage
              A  flag specifying whether an extra (empty) page should be printed, when necessary,
              to ensure that the title page, the table of contents, and the document itself  will
              start  on  odd  pages.  This  is typically desirable for double sided printing. The
              default is 1.

       break-table
              A flag specifying if a table should be broken across two pages when it does not fit
              on  the  current  page,  but it does on a page of its own.  The default is 0 (avoid
              breaking tables when possible).

       forms  This flag is used to specify whether  FORM  elements  in  the  document  should  be
              processed or ignored. Some forms may be suitable for printing out and be filled out
              (with a pen), others are not. The default is 1.

       textarea-data
              When a TEXTAREA element contains prefilled data, the text will be used as labels if
              this flag is set, otherwise ignored. The default is 0.

       page-break
              Set  this  flag to 0 to suppress the normal behavior of generating page breaks from
              the comment <!--NewPage--> etc, as specified below. The default is 1.

       expand-acronyms
              A flag specifying whether  acronyms,  given  by  the  ACRONYM  element,  should  be
              expanded or not. The default is 0.

       spoof  Some  web  servers return different documents depending on which user agent is used
              to retrieve the document. You can fool the web server that  a  certain  browser  is
              used,  by  setting  this  value  to the identification used by the browser, such as
              "Mozilla/4.0". This only works if you  are  using  one  of  the  Perl  packages  to
              retrieve remote documents.

       ssi    When  this  flag  is  set,  some  Server  Side  Includes will be processed when the
              document is read from a local file. Examples are <!--#include file=...>,  <!--#echo
              var="LAST_MODIFIED">, <!--#config timefmt=...>. The default is 0.

       prefilled
              This  flag controls whether the content of form elements should be rendered or not.
              That is, when this flag is set, the content of TEXTAREA elements, and the value  of
              the  value  attribute  of  text  INPUT  elements will be shown. Also, checked radio
              buttons and checkboxes will be marked.  The default is 0.

SYMBOLS

       The following symbols can be used on the title page, the page headers/footers, and in  the
       heading for the table of contents:

       Symbols  of  the  form "$[name]" will expand to the value of the content attribute of META
       elements,  having  either  of  the  attributes  "name=name"  or  "http-equiv=name"   (case
       insensitive string matching).  For example, when a document containing:

          <META name="expires" content="31 Dec 2011">

       is converted, using a configuration file with:

          footer { left: "Expires: $[expires]" }

       this left footer will be inserted:

          Expires: 31 Dec 2011

       In addition, these symbols are defined:

              $T     Current document title.
              $A     Author   of   current   document,  as  specified  with  <META  name="Author"
                     content="..."> in the document head.
              $U     The URL, or file name, of current document.
              $N     Page number.
              $H     Current document heading (level 1-3).
              $D     Current date/time. The format is given by the datefmt key.

       So $A is equivalent to $[author], but kept for backwards compatibility.

       To avoid symbol expansion, precede the dollar sign with a backslash, as in "\$T".

HINTS

       I imagine that a typical use of configuration files can be something along  the  following
       lines.

       System  specific definitions (e.g. specification of available program packages) and global
       defaults (paper type etc) are defined in the global configuration file.

       If there is more than one user of the program on the system, each user  can  also  have  a
       personal  configuration  file  with  his/hers own personal preferences.  (On a single user
       system one can use the global configuration file for this purpose as well.)

       One may also develop a collection of configuration files  for  typical  situations.  These
       files  are  placed  in a directory that is searched by html2ps (the search path is defined
       with the environment variable HTML2PSPATH).  For example, to print a document as slides  -
       in  landscape  mode,  with  large  text in Helvetica, and a thick frame - one can create a
       configuration file, called 'slides' say, containing:

          @html2ps {
            option {
              landscape: 1;
              frame: 1;
            }
            frame { width: 3pt }
          }
          BODY {
            font-family: Helvetica;
            font-size: 20pt;
          }
          H1 { font-size: 35pt }
          H2 { font-size: 32pt }
          H3 { font-size: 29pt }
          H4 { font-size: 26pt }
          H5 { font-size: 23pt }
          H6 { font-size: 20pt }
          PRE { font-size: 18pt }

       Then use the command:

          html2ps -f slides ...

       to convert the document. Note that with this command the file 'slides' is used instead  of
       the  personal  configuration  file.  If  you  want  both  to be used, giving precedence to
       definitions made in the file 'slides', use the command:

          html2ps -f :slides ...

       (The page breaks  between  the  slides  can  for  example  be  generated  by  adding  '<HR
       class=PAGE-BREAK>' to the HTML document.)

       For  features  that  are  frequently  turned  on and off, and that cannot be controlled by
       command line options, it may be a  good  idea  to  create  small  configuration  files  as
       "building  blocks".  For  example  a  file 'A4' for printing on A4 paper (if you have some
       other default paper type):

          @html2ps { paper { type: A4 } }

       and a file 'hnum' for automatic numbering of headings:

          @html2ps { seq-number: 1 }

       Combining this with the previous example: to convert a document for printing on  A4  sized
       slides with all headings numbered, use the command:

          html2ps -f :slides:A4:hnum ...

SEE ALSO

       html2ps(1), setlocale(3), strftime(3)

VERSION

       This manpage describes html2ps version 1.0 beta7.

AVAILABILITY

       http://user.it.uu.se/~jan/html2ps.html

AUTHOR

       Jan Karrman (jan@it.uu.se)