summaryrefslogtreecommitdiff
path: root/Build/source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp
blob: f527172504c9a0f5edc6f588f5892491d676d41a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
! Generated automatically by mantohlp
1 pdftotext

       pdftotext  -  Portable  Document Format (PDF) to text con-
       verter

       pdftotext [options] [PDF-file [text-file]]

       Pdftotext converts Portable Document Format (PDF) files to
       plain text.

       Pdftotext  reads the PDF file, PDF-file, and writes a text
       file, text-file.  If text-file is not specified, pdftotext
       converts  file.pdf  to file.txt.  If text-file is '-', the
       text is sent to stdout.

                                                               ()

2 ONFIGURATION_FIL

       Pdftotext reads a configuration file at startup.  It first
       tries to find the user's private config  file,  ~/.xpdfrc.
       If  that  doesn't exist, it looks for a system-wide config
       file, typically /usr/local/etc/xpdfrc (but  this  location
       can   be  changed  when  pdftotext  is  built).   See  the
       xpdfrc(5) man page for details.

                                                               ()

2 OPTIONS

       Many  of  the following options can be set with configura-
       tion file commands.  These are listed in  square  brackets
       with  the  description  of  the corresponding command line
       option.

       -f number
              Specifies the first page to convert.

       -l number
              Specifies the last page to convert.

       -layout
              Maintain (as best as possible) the original  physi-
              cal  layout  of the text.  The default is to 'undo'
              physical layout (columns,  hyphenation,  etc.)  and
              output the text in reading order.

       -raw   Keep  the  text in content stream order.  This is a
              hack which often "undoes" column  formatting,  etc.
              Use of raw mode is no longer recommended.

       -htmlmeta
              Generate  a  simple  HTML  file, including the meta
              information.  This simply wraps the text  in  <pre>
              and </pre> and prepends the meta headers.

       -enc encoding-name
              Sets  the  encoding  to  use  for text output.  The
              encoding-name must be defined with  the  unicodeMap
              command  (see  xpdfrc(5)).   The  encoding  name is
              case-sensitive.  This defaults to  "Latin1"  (which
              is  a built-in encoding).  [config file: textEncod-
              ing]

       -eol unix | dos | mac
              Sets the end-of-line convention  to  use  for  text
              output.  [config file: textEOL]

       -nopgbrk
              Don't  insert  page  breaks  (form feed characters)
              between pages.  [config file: textPageBreaks]

       -opw password
              Specify the owner password for the PDF file.   Pro-
              viding  this will bypass all security restrictions.

       -upw password
              Specify the user password for the PDF file.

       -q     Don't print any messages or errors.  [config  file:
              errQuiet]

       -cfg config-file
              Read  config-file in place of ~/.xpdfrc or the sys-
              tem-wide config file.

       -v     Print copyright and version information.

       -h     Print usage information.   (-help  and  --help  are
              equivalent.)

                                                               ()

2 BUGS

       Some  PDF  files  contain  fonts whose encodings have been
       mangled beyond recognition.  There is  no  way  (short  of
       OCR) to extract text from these files.

                                                               ()

2 XIT_CODE

       The Xpdf tools use the following exit codes:

       0      No error.

       1      Error opening a PDF file.

       2      Error opening an output file.

       3      Error related to PDF permissions.

       99     Other error.

                                                               ()

2 AUTHOR

       The  pdftotext  software  and  documentation are copyright
       1996-2007 Glyph & Cog, LLC.

                                                               ()

2 SEE_ALSO

       xpdf(1), pdftops(1), pdfinfo(1), pdffonts(1), pdftoppm(1),
       pdfimages(1), xpdfrc(5)
       http://www.foolabs.com/xpdf/

                                                               ()