File: pdfresurrect.1

package info (click to toggle)
pdfresurrect 0.12-5
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 336 kB
  • ctags: 115
  • sloc: ansic: 1,211; makefile: 50
file content (90 lines) | stat: -rw-r--r-- 3,743 bytes parent folder | download | duplicates (4)
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
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH PDFRESURRECT 1 "March 20, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
pdfresurrect \- tool for extracting versioning data from PDF documents
.SH SYNOPSIS

.B pdfresurrect
.RI " file.pdf " [-w] [-q] [-s] [-i]
.SH DESCRIPTION
This manual page documents briefly the
.B pdfresurrect
command.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invoke bold face and italics,
.\" respectively.
\fBpdfresurrect\fP is a tool for extracting versioning data from PDF documents.
.SH OPTIONS
A summary of options is included below.
.TP
.B \-w
Write the PDF versions and summary to disk.
.TP
.B \-q
Display only the number of versions contained in the PDF.
.TP
.B \-s
Scrub the previous history data from the specified PDF.
.TP
.B \-i
Display the creator information from the specified PDF.
.SH NOTES
The scrubbing feature (\-s) should not be trusted for any serious security
uses.  After using this feature, please verify that it in fact zero'd all
of the objects that were of concern.
.PP
This tool relies on the application reading the pdfresurrect extracted versions
to treat the last xref(cross-reference) table as the most recent in the
document.  This should typically be the case.
.PP
The verbose output, which tries to deduce the PDF object type (e.g. stream,
page), is not always accurate, and the object counts might not be 100%
accurate.  However, this should not prevent the extraction of the versions.
This output is merely to provide a hint for the user as to what might be
different between the documents.
.PP
Object counts might appear off in linearized PDF documents.  That is not truly
the case, the reason for this is that each version of the PDF consists of the
objects that compose the linear portion of the PDF plus all of the objects that
compose the version in question.  Suppose there is a linearized PDF with 59
objects in its linear portion, and suppose the PDF has a second version that
consists of 21 objects.  The total number of objects in "version 2"
would be 59 + 21 or 80 objects.
.SH COPYRIGHT
pdfresurrect is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.PP
pdfresurrect is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP 
You should have received a copy of the GNU General Public License
along with pdfresurrect.  If not, see <http://www.gnu.org/licenses/>.
.SH AUTHORS
pdfresurrect was originally written by Matt Davis <mattdavis9@gmail.com>.

The original man page and some additional configure and Makefile hackage was
contributed by Francois Marier <francois@debian.org>.
.PP
This manual page was originally written by Francois Marier
<francois@debian.org>, for the Debian project (and may be used by others).
This manual page has since been modified by Matt Davis.