opt/paper/paper.1

75 lines
2.1 KiB
Groff
Raw Normal View History

2022-05-16 16:10:38 +02:00
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.1.
.TH PAPER "1" "Mai 2022" "paper 1.2.0" "User Commands"
2020-04-20 14:38:50 +02:00
.SH NAME
paper - print paper size information
.SH SYNOPSIS
2022-05-16 16:10:38 +02:00
.B (null)
2020-04-20 14:38:50 +02:00
[\fI\,OPTION\/\fR...] [\fI\,PAPER\/\fR...\fI\,|--all\/\fR]
.SH DESCRIPTION
Print paper size information.
.TP
\fB\-\-all\fR
2022-05-16 16:10:38 +02:00
show information about all known paper sizes
2020-04-20 14:38:50 +02:00
.TP
2022-05-16 16:10:38 +02:00
\fB\-\-no\-size\fR
do not show paper sizes (width followed by height)
2020-04-20 14:38:50 +02:00
.TP
2022-05-16 16:10:38 +02:00
\fB\-\-unit\fR UNIT
unit in which to show sizes [pt, mm, in; default: natural units]
2020-04-20 14:38:50 +02:00
.TP
\fB\-\-help\fR
2022-05-16 16:10:38 +02:00
display this help message and exit
2020-04-20 14:38:50 +02:00
.TP
\fB\-\-version\fR
display version information and exit
.PP
.B paper
prints information about the given paper sizes, which can include the
2022-05-16 16:10:38 +02:00
standard form of its name, its width and height. The output is designed
to be both human- and machine-readable.
2020-04-20 14:38:50 +02:00
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.
2022-05-16 16:10:38 +02:00
.SH "REPORTING BUGS"
Report bugs at https://github.com/rrthomas/paper
2020-04-20 14:38:50 +02:00
.SH COPYRIGHT
2022-05-16 16:10:38 +02:00
Copyright \(co 2013\-2021 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.
For more information about these matters, see the file named COPYING.
2020-04-20 14:38:50 +02:00
.SH "SEE ALSO"
.BR paperspecs (5)