apdf/doc/pdftotext.hlp

   1 ! Generated automatically by mantohlp
   2 1 pdftotext
   3
   4        pdftotext  -  Portable  Document Format (PDF) to text con-
   5        verter
   6
   7        pdftotext [options] [PDF-file [text-file]]
   8
   9        Pdftotext converts Portable Document Format (PDF) files to
  10        plain text.
  11
  12        Pdftotext  reads the PDF file, PDF-file, and writes a text
  13        file, text-file.  If text-file is not specified, pdftotext
  14        converts  file.pdf  to file.txt.  If text-file is '-', the
  15        text is sent to stdout.
  16
  17                                                                ()
  18
  19 2 ONFIGURATION_FIL
  20
  21        Pdftotext reads a configuration file at startup.  It first
  22        tries to find the user's private config  file,  ~/.xpdfrc.
  23        If  that  doesn't exist, it looks for a system-wide config
  24        file, typically /usr/local/etc/xpdfrc (but  this  location
  25        can   be  changed  when  pdftotext  is  built).   See  the
  26        xpdfrc(5) man page for details.
  27
  28                                                                ()
  29
  30 2 OPTIONS
  31
  32        Many  of  the following options can be set with configura-
  33        tion file commands.  These are listed in  square  brackets
  34        with  the  description  of  the corresponding command line
  35        option.
  36
  37        -f number
  38               Specifies the first page to convert.
  39
  40        -l number
  41               Specifies the last page to convert.
  42
  43        -layout
  44               Maintain (as best as possible) the original  physi-
  45               cal  layout  of the text.  The default is to 'undo'
  46               physical layout (columns,  hyphenation,  etc.)  and
  47               output the text in reading order.
  48
  49        -raw   Keep  the  text in content stream order.  This is a
  50               hack which often "undoes" column  formatting,  etc.
  51               Use of raw mode is no longer recommended.
  52
  53        -htmlmeta
  54               Generate  a  simple  HTML  file, including the meta
  55               information.  This simply wraps the text  in  <pre>
  56               and </pre> and prepends the meta headers.
  57
  58        -enc encoding-name
  59               Sets  the  encoding  to  use  for text output.  The
  60               encoding-name must be defined with  the  unicodeMap
  61               command  (see  xpdfrc(5)).   The  encoding  name is
  62               case-sensitive.  This defaults to  "Latin1"  (which
  63               is  a built-in encoding).  [config file: textEncod-
  64               ing]
  65
  66        -eol unix | dos | mac
  67               Sets the end-of-line convention  to  use  for  text
  68               output.  [config file: textEOL]
  69
  70        -nopgbrk
  71               Don't  insert  page  breaks  (form feed characters)
  72               between pages.  [config file: textPageBreaks]
  73
  74        -opw password
  75               Specify the owner password for the PDF file.   Pro-
  76               viding  this will bypass all security restrictions.
  77
  78        -upw password
  79               Specify the user password for the PDF file.
  80
  81        -q     Don't print any messages or errors.  [config  file:
  82               errQuiet]
  83
  84        -cfg config-file
  85               Read  config-file in place of ~/.xpdfrc or the sys-
  86               tem-wide config file.
  87
  88        -v     Print copyright and version information.
  89
  90        -h     Print usage information.   (-help  and  --help  are
  91               equivalent.)
  92
  93                                                                ()
  94
  95 2 BUGS
  96
  97        Some  PDF  files  contain  fonts whose encodings have been
  98        mangled beyond recognition.  There is  no  way  (short  of
  99        OCR) to extract text from these files.
 100
 101                                                                ()
 102
 103 2 XIT_CODE
 104
 105        The Xpdf tools use the following exit codes:
 106
 107        0      No error.
 108
 109        1      Error opening a PDF file.
 110
 111        2      Error opening an output file.
 112
 113        3      Error related to PDF permissions.
 114
 115        99     Other error.
 116
 117                                                                ()
 118
 119 2 AUTHOR
 120
 121        The  pdftotext  software  and  documentation are copyright
 122        1996-2005 Glyph & Cog, LLC.
 123
 124                                                                ()
 125
 126 2 SEE_ALSO
 127
 128        xpdf(1), pdftops(1), pdfinfo(1), pdffonts(1), pdftoppm(1),
 129        pdfimages(1), xpdfrc(5)
 130        http://www.foolabs.com/xpdf/
 131
 132                                                                ()
 133