opt/paper/paper.1

75 lines
2.1 KiB
Groff

.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.2.
.TH PAPER "1" "November 2022" "paper 2.0.4" "User Commands"
.SH NAME
paper - print paper size information
.SH SYNOPSIS
.B (null)
[\fI\,OPTION\/\fR...] [\fI\,PAPER\/\fR...\fI\,|--all\/\fR]
.SH DESCRIPTION
Print paper size information.
.TP
\fB\-\-all\fR
show information about all known paper sizes
.TP
\fB\-\-no\-size\fR
do not show paper sizes (width followed by height)
.TP
\fB\-\-unit\fR UNIT
unit in which to show sizes [pt, mm, in; default: natural units]
.TP
\fB\-\-help\fR
display this help message and exit
.TP
\fB\-\-version\fR
display version information and exit
.PP
.B paper
prints information about the given paper sizes, which can include the
standard form of its name, its width and height. The output is designed
to be both human- and machine-readable.
The name is matched case-insensitively, and ignoring spaces.
.PP
If neither a paper size nor the \fB\-\-all\fR option is given, the current
paper size is used.
.PP
The current paper size is obtained by looking in order at the following
values until a non-empty value is found.
If no paper size is configured, paper exits with an error.
.IP \[bu]
The \fBPAPERSIZE\fR environment variable
.IP \[bu]
The user's default paper size in
.B $XDG_CONFIG_HOME/papersize
.IP \[bu]
The \fBLC_PAPER\fR environment variable (if supported by the system)
.IP \[bu]
The system default paper size in
.B /etc/papersize
.IP \[bu]
The first paper size in the system list
.IP \[bu]
The first paper size in the user's list
.SH "ENVIRONMENT VARIABLES"
.TP
.B PAPERSIZE
Paper size to use.
.SH FILES
.TP
.B /etc/papersize
System default paper size.
.TP
.B $XDG_CONFIG_HOME/papersize
User's default paper size.
.SH AUTHOR
Written by Reuben Thomas.
.SH "REPORTING BUGS"
Report bugs at https://github.com/rrthomas/libpaper
.SH COPYRIGHT
Copyright \(co 2013\-2022 Reuben Thomas <rrt@sc3d.org>.
paper comes with ABSOLUTELY NO WARRANTY.
You may redistribute copies of paper
under the terms of the GNU General Public License
version 3, or, at your option, any later version.See <https://www.gnu.org/licenses/gpl\-3.0.html>.
.SH "SEE ALSO"
.BR paperspecs (5)