55 lines
1.9 KiB
Groff
55 lines
1.9 KiB
Groff
.\" Copyright (c) 2013-2021 Reuben Thomas <rrt@sc3d.org>
|
|
.\"
|
|
.\" This file is part of libpaper.
|
|
.\"
|
|
.\" This program is free software; you can redistribute it and/or modify it
|
|
.\" under the terms of the GNU General Public License as published by the Free
|
|
.\" Software Foundation; either version 3, or (at your option) any later
|
|
.\" version.
|
|
.\"
|
|
.\" This program is distributed in the hope that it will be useful, but
|
|
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
.\" or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
.\" for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License along
|
|
.\" with this program; if not, see <https://www.gnu.org/licenses/>.
|
|
.TH PAPERSPECS 5 "11 January 2014"
|
|
.SH NAME
|
|
.B paperspecs
|
|
\- paper size specifications
|
|
.SH DESCRIPTION
|
|
A CSV format list of the paper size specifications used by paper.
|
|
Each line contains the following fields:
|
|
.TP
|
|
NAME,WIDTH,HEIGHT,UNIT
|
|
.PP
|
|
Valid units are: \fBpt\fR (PostScript points), \fBmm\fR, \fBin\fR.
|
|
.PP
|
|
A size may be defined more than once. Only the first definition is
|
|
normally used. This means that the user's paperspecs file overrides
|
|
sizes in the system file (see below).
|
|
.PP
|
|
Multiple definitions are also used to allow inexact definitions to be
|
|
looked up by size. For example, the \fBLC_PAPER\fR mechanism available
|
|
on some systems defines paper sizes in whole numbers of millimetres,
|
|
which results in a definition for Letter size that does not exactly
|
|
match the definition in inches.
|
|
.SH FILES
|
|
.TP
|
|
.B /etc/paperspecs
|
|
System list of paper sizes.
|
|
.TP
|
|
.B $XDG_CONFIG_HOME/paperspecs
|
|
User's list of paper sizes. This is prepended to the system list.
|
|
.SH BUGS
|
|
The CSV format is restricted: quotes are not allowed; hence, fields
|
|
cannot be escaped.
|
|
.SH CREDITS
|
|
The original list of paper names came from Ghostscript 3.68's
|
|
gs_stadt.ps.
|
|
.SH AUTHOR
|
|
Reuben Thomas <rrt@sc3d.org>
|
|
.SH SEE ALSO
|
|
paper(1)
|