summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/pnmmargin.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/mageia-cauldron/man1/pnmmargin.1')
-rw-r--r--upstream/mageia-cauldron/man1/pnmmargin.1114
1 files changed, 114 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/pnmmargin.1 b/upstream/mageia-cauldron/man1/pnmmargin.1
new file mode 100644
index 00000000..aae3634c
--- /dev/null
+++ b/upstream/mageia-cauldron/man1/pnmmargin.1
@@ -0,0 +1,114 @@
+\
+.\" 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 "Pnmmargin User Manual" 0 "12 November 2014" "netpbm documentation"
+
+.SH NAME
+
+pnmmargin - add borders to a PNM image
+
+.UN synopsis
+.SH SYNOPSIS
+
+\fBpnmmargin\fP
+[\fB-white\fP|\fB-black\fP|\fB-color\fP \fIcolorspec\fP] \fIsize\fP
+[\fIpnmfile\fP]
+
+.UN description
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBpnmmargin\fP adds a border around a PNM image.
+
+
+.UN arguments
+.SH ARGUMENTS
+.PP
+\fIpnmfile\fP is the name of the input file. If you don't specify this
+argument, \fBpnmmargin\fP reads the input image from its Standard Input.
+
+
+.UN options
+.SH OPTIONS
+.PP
+In addition to the options common to all programs based on libnetpbm
+(most notably \fB-plain\fP, see
+.UR index.html#commonoptions
+ Common Options
+.UE
+\&), \fBpnmmargin\fP recognizes the following
+command line options:
+.PP
+You can specify the border color with the \fB-white\fP,
+\fB-black\fP, and \fB-color\fP options. If you don't specify a color, the
+program makes a guess.
+.PP
+The value of \fB-color\fP is like the
+.UR libnetpbm_image.html#colorname
+argument of the \fBpnm_parsecolor()\fP library routine
+.UE
+\&.
+.PP
+The \fB-plain\fP common option was implemented beginning with Netpbm
+version 10.40 (September 2007).
+.PP
+The \fB-quiet\fP common option is not implemented.
+
+.UN notes
+.SH NOTES
+.PP
+To remove a border of a specified size from an image, use
+\fBpamcut\fP. \fBpnmcrop\fP also removes borders, but determines by itself
+what is border and what is subject.
+.PP
+For lower level control, including to add different size borders to
+different sides of the image, look at \fBpnmcat\fP.
+.PP
+If all you're trying to do is get the image up to a certain required
+size, \fBpamcut\fP may be what you want.
+.PP
+\fBpnmpad\fP does essentially the same thing, but gives you more control
+over the individual margins and does only black and white margins.
+
+
+.UN seealso
+.SH SEE ALSO
+
+
+.IP \(bu
+
+.BR "pamcut" (1)\c
+\&
+.IP \(bu
+
+.BR "pnmcrop" (1)\c
+\&
+.IP \(bu
+
+.BR "pnmcat" (1)\c
+\&
+.IP \(bu
+
+.BR "pnmpad" (1)\c
+\&
+.IP \(bu
+
+.BR "pnm" (1)\c
+\&
+
+
+.UN author
+.SH AUTHOR
+
+Copyright (C) 1991 by Jef Poskanzer.
+.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/pnmmargin.html
+.PP \ No newline at end of file