summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man1/pamfixtrunc.1
blob: f0fdb36f0a3f6db652df06c2c344ee46f125f487 (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
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamfixtrunc User Manual" 1 "" "netpbm documentation"

.SH NAME

pamfixtrunc - replaced by pamfix

.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamfixtrunc\fP was replaced in Netpbm 10.66 (March 2014) by
.BR "pamfix" (1)\c
\&.
.PP
\fBpamfix\fP with a \fB-truncate\fP option is the same thing as
\fBpamfixtrunc\fP.  But \fBpamfix\fP has other options to repair other
kinds of corruption.
.PP
Another change that came with Netpbm 10.66 is that an invalid sample value
(a value greater than the maxval the image declares in its header) is
considered by the common Netpbm image reading facility (in libnetpbm) to be
unreadable, which means the file is essentially truncated.  In older Netpbm,
the invalid sample value propagates to the output in a program such as
\fBpamfixtrunc\fP.  Thus, in older Netpbm a file with 100 rows and an invalid
sample value in the 3rd row would pass through \fBpamfixtrunc\fP unchanged.
But in Netpbm 10.66, \fBpamfix -truncate\fP with the same input would produce
an output image with only 2 rows.  While it is not possible in 10.66 to
cause \fBpamfix\fP to generate an invalid Netpbm image, you can
use \fB-clip\fP and \fB-changemaxval\fP options to avoid truncating the
file in a case like this.
.PP
You should not make any new use of \fBpamfixtrunc\fP and if you modify an
existing use, you should upgrade to \fBpamfixtrunc\fP.  But note that if you
write a program that might have to be used with very old
Netpbm, \fBpamfixtrunc\fP is the only way to do that.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamfixtrunc.html
.PP