.\" 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 Lesser General Public License as published by
.\"the Free Software Foundation; either version 2.1 of the License, 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 Lesser General Public License for more details.
.\"
.\"You should have received a copy of the GNU Lesser General Public License
.\"along with this program.  If not, see
.\"<https://www.gnu.org/licenses/lgpl-2.1.html>.
.TH PAPERSPECS 5 "11 ژانویه 2014"
.SH "نام (NAME)"
.B paperspecs
\- مشخصات اندازه‌های کاغذ
.SH "توضیحات (DESCRIPTION)"
فهرستی با قالب CSV از مشخصات ابعاد کاغذ که توسط \fBpaper\fR استفاده می‌شود.
هر خط شامل فیلدهای زیر است:
.TP
NAME,WIDTH,HEIGHT,UNIT
.PP
واحدهای معتبر عبارتند از: \fBpt\fR (پوینت‌های پست‌اسکریپت)، \fBmm\fR، \fBin\fR.
.PP
یک اندازه ممکن است بیش از یک بار تعریف شود. معمولاً فقط نخستین تعریف استفاده
می‌شود. این بدان معناست که فایل paperspecs کاربر، تعاریف اندازه‌های موجود در
فایل سیستمی را بازنویسی (override) می‌کند (زیر را ببینید).
.PP
همچنین تعاریف چندگانه برای این به کار می‌روند که امکان جستجوی تعاریف غیردقیق بر اساس
اندازه فراهم شود. برای نمونه، سازوکار \fBLC_PAPER\fR که در برخی سیستم‌ها وجود دارد،
اندازه‌های کاغذ را به صورت اعداد صحیح بر حسب میلی‌متر تعریف می‌کند که در نتیجه
تعریف اندازه Letter دقیقاً با تعریف آن بر حسب اینچ مطابقت نخواهد داشت.
.SH "فایل‌ها (FILES)"
.TP
.B /etc/paperspecs
فهرست سیستمی اندازه‌های کاغذ.
.TP
.B $XDG_CONFIG_HOME/paperspecs
فهرست اندازه‌های کاغذ متعلق به کاربر. این فهرست پیش از فهرست سیستم در نظر گرفته می‌شود.
.SH "گزارش باگ‌ها (BUGS)"
قالب CSV دارای محدودیت است: علامت‌های نقل‌قول (کوتیشن) مجاز نیستند؛ بنابراین، امکان
گریزدهی (escape) فیلدها وجود ندارد.
.SH "قدردانی‌ها (CREDITS)"
فهرست اصلی نام‌های کاغذ از فایل gs_stadt.ps در Ghostscript 3.68 برگرفته شده است.
.SH "نویسندگان (AUTHORS)"
Reuben Thomas <rrt@sc3d.org>
.SH "همچنین ببینید (SEE ALSO)"
.BR paper (1)