~ubuntu-branches/ubuntu/wily/luatex/wily

« back to all changes in this revision

Viewing changes to source/libs/xpdf/xpdf-3.02/doc/pdftotext.hlp

  • Committer: Bazaar Package Importer
  • Author(s): Norbert Preining
  • Date: 2010-04-29 00:47:19 UTC
  • mfrom: (1.1.10 upstream)
  • Revision ID: james.westby@ubuntu.com-20100429004719-o42etkqe90n97b9e
Tags: 0.60.1-1
* new upstream release, adapt build-script patch
* disable patch: upstream-epstopdf_cc_no_xpdf_patching, included upstream
* disable patch: libpoppler-0.12, not needed anymore

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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-2007 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