opt/paper/paper.1

74 lines
1.9 KiB
Groff

.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.13.
.TH PAPER "1" "April 2020" "paper 2.2" "User Commands"
.SH NAME
paper - print paper size information
.SH SYNOPSIS
.B paper
[\fI\,OPTION\/\fR...] [\fI\,PAPER\/\fR...\fI\,|--all\/\fR]
.SH DESCRIPTION
Print paper size information.
.TP
\fB\-\-all\fR
print information about all known paper sizes
.TP
\fB\-\-name\fR
print paper names (by default, the name is not
printed when only one paper argument is given)
.TP
\fB\-\-size\fR
print paper sizes (width followed by height)
.TP
\fB\-\-unit\fR=\fI\,UNIT\/\fR
print dimensions in the given unit
[default: PostScript points]
.TP
\fB\-\-help\fR
display this help 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 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 COPYRIGHT
Copyright \(co 2013\-2020 Reuben Thomas <rrt@sc3d.org>.
Released under the GPL version 3, or (at your option) any later version.
.SH "SEE ALSO"
.BR paperspecs (5)