Provided by: html2ps_1.0b7-1_all bug

NAME

       html2ps - convert HTML to PostScript

SYNOPSIS

       html2ps [ -2cdDFghHLnORtTuUv ] [ -b URL ] [ -C string ] [ -e encoding ]
       [ -f file[:file[:...]]  ] [ -i num ] [ -k file ] [ -l lang ] [ -m num ]
       [  -M num ] [ -N num ] [ -o file ] [ -r path ] [ -s num ] [ -S string ]
       [ -W string ] [ -x num ] [ URL|file ]

DESCRIPTION

       The program html2ps converts HTML to PostScript. The HTML code  can  be
       retrieved  from  one  or  more  URL:s  or  local  files,  specified  as
       parameters on the command line.  If  no  parameter  is  given,  html2ps
       reads from standard input.

       Note:  To avoid unnecessary network traffic, one can rebuild an already
       generated PostScript file with new options. This  is  done  by  running
       html2ps with the new options, and with the old PostScript file as input
       (not applicable for all options).

OPTIONS

       All  options  have  a  short  (case  sensitive),  and  a   long   (case
       insensitive) form.

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

       -b URL --base URL
              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.

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

       -C string --toc string
              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.

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

       -D --dsc --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.

       -e encoding --encoding 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.

       -f file[:file[:...]] --rcfile file[:file[:...]]
              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.)

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

       -g --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.

       -h --help
              Show usage information.

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

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

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

       -l lang --language lang
              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).

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

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

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

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

       -N num --startno num
              Specifies the starting page number, the default is 1.

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

       -O --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>

       -r path --rootdir path
              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.

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

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

       -S string --style string
              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.)

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

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

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

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

       -v --version
              Print information about the current version of html2ps.

       -W string --web string
              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).

       -x num --duplex num
              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).

BUGS

       (This is incomplete.)

       The CELLSPACING attribute of the TABLE element is  not  implemented  as
       described  in  the  specification; instead the value of the CELLPADDING
       attribute is increased by half the value of CELLSPACING.

       Rendering HTML tables well is a non-trivial task.  For  "real"  tables,
       that  is  representation  of  tabular  data,  html2ps usually generates
       reasonably good output. When tables are used for layout  purposes,  the
       result  varies  from  good  to useless. This is because a table cell is
       never broken across pages. So if a table contains a cell with a lot  of
       content,  the  entire table may have to be scaled down in size in order
       to make this cell fit on a single page. Sometimes this may even  result
       in unreadable output.

       Page  breaks  are occasionally done in bad places: for example directly
       after a (long) heading, and before the last line in a paragraph.

ENVIRONMENT

       HTML2PSPATH
              This  variable  specifies  the   directories   to   search   for
              configuration  files.  It  should  be  a colon separated list of
              directory names. Use a dot '.' to denote the current  directory.
              An  empty directory name (as in ':dir', 'dir1::dir3', or 'dir:')
              will expand to the directory where the global configuration file
              is.  The  default  value  is  '.:',  that is: search the current
              directory first, and then the global one.

FILES

       $HOME/.html2psrc
              User configuration file, see html2psrc(5).

SEE ALSO

       html2psrc(5), perl(1), setlocale(3), strftime(3), weblint(1)

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)