diff options
Diffstat (limited to 'Build/source/libs/paper/libpaper-1.1.24+nmu2/man')
19 files changed, 447 insertions, 0 deletions
diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/Makefile.am b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/Makefile.am new file mode 100644 index 00000000000..f9d579a645c --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/Makefile.am @@ -0,0 +1,25 @@ +man_MANS = \ + paperconf.1 \ + defaultpapername.3 \ + defaultpapersizefile.3 \ + paperdone.3 \ + paperfirst.3 \ + paperinfo.3 \ + paperinit.3 \ + paperlast.3 \ + papernext.3 \ + paperprev.3 \ + paperpsheight.3 \ + paperpsname.3 \ + paperpswidth.3 \ + paperwithsize.3 \ + systempapername.3 \ + systempapersizefile.3 \ + papersize.5 \ + paperconfig.8 + +EXTRA_DIST = \ + paperconf.1.in \ + systempapername.3.in \ + papersize.5.in \ + paperconfig.8.in diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapername.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapername.3 new file mode 100644 index 00000000000..882f4bbf27e --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapername.3 @@ -0,0 +1,2 @@ +.so man3/systempapername.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapersizefile.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapersizefile.3 new file mode 100644 index 00000000000..390a56bdfeb --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapersizefile.3 @@ -0,0 +1,2 @@ +.so man3/systempapersizefile.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconf.1.in b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconf.1.in new file mode 100644 index 00000000000..6be58eb6867 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconf.1.in @@ -0,0 +1,118 @@ +.TH PAPERCONF 1 "24 April 2001" +.SH NAME +.B paperconf +\- print paper configuration information +.SH SYNOPSIS +.B paperconf +[ +[ +.B \-p +] +.I paper +| +.B \-d +| +.B \-a +] +[ +.B \-z +] +[ +.B \-n +| +.B \-N +] +[ +.B \-s +| +.B \-w +| +.B \-h +] +[ +.B \-c +| +.B \-m +| +.B \-i +] +.SH DESCRIPTION +.B paperconf +prints information about a given paper. +The information that can be obtained is the name of the paper, its +size and its width or height. +When called without arguments, +.B paperconf +prints the name of the system- or user-specified paper, obtained by +looking in order at the +.B @PAPERSIZEVAR@ +environment variable, at the contents of the file specified by the +.B @PAPERCONFVAR@ +environment variable, at the contents of +.B @PAPERCONF@ +or by using +.B letter +as a fall-back value if none of the other alternatives are successful. +By default, width and height of the paper are printed in PostScript points. +.SH OPTIONS +.TP +.BI \-p " paper" +Specify the name of the +.I paper +about which information is asked. +.TP +.B \-d +Use the default builtin paper name. +.TP +.B \-a +Consider all known paper names. +.TP +.B \-z +If the paper name is unknown, print it but issue a message on the +standard error and exit with a non-zero code. +.TP +.B \-n +Print the name of the paper. +.TP +.B \-N +Print the name of the paper with the first letter capitalized. +.TP +.B \-s +Print the size (width followed by height) of the paper. +.TP +.B \-w +Print the width of the paper. +.TP +.B \-h +Print the height of the paper. +.TP +.B \-c +Use centimetres as unit for paper size. +.TP +.B \-m +Use millimetres as unit for paper size. +.TP +.B \-i +Use inches as unit for paper size. + +.SH ENVIRONMENT +.TP 20 +.B @PAPERSIZEVAR@ +Paper size to use regardless of what the papersize file contains. +.TP 20 +.B @PAPERCONFVAR@ +Full path to a file containing the paper size to use. +.SH FILES +.TP 20 +.B @PAPERCONF@ +Contains the name of the system-wide default paper size to be used +if the +.B @PAPERSIZEVAR@ +and +.B @PAPERCONFVAR@ +variables are not set. +.SH AUTHOR +Yves Arrouye <arrouye@debian.org> +.SH SEE ALSO +.BR papersize (5) + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconfig.8.in b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconfig.8.in new file mode 100644 index 00000000000..1c7ce4d9159 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconfig.8.in @@ -0,0 +1,73 @@ +.\" paperconfig.8, Copyright (C) 1996, Yves Arrouye <arrouye@debian.org> +.TH PAPERCONFIG 8 "5 January 2005" "Debian/Linux" "Linux Administrator's Manual" +.SH NAME +.B paperconfig +\- configure the system default paper size +.SH SYNOPSIS +.B paperconfig +[ +.BR \-v\fP, \fB\-\-version +] +[ +.BR \-h\fP, \fB\-\-help +] +[ +.BI "\-p\fP, \fB\-\-paper" " papername" +| +.B \-\-force +] +.SH DESCRIPTION +.B paperconfig +sets the system (or default) paper to be used by tools using the +.B papersize +file. +It can either ask interactively for the paper to use or be called +non-interactively by scripts. +.PP +When the paper size has been changed, +.B paperconfig +notifies other packages of the change by running the scripts in the +.I @RUNPARTSDIR@ +directory. +.SH OPTIONS +.TP +.BR \-v\fP, \fB\-\-version +Print the version of +.B paperconfig +and exit. +.TP +.BR \-h\fP, \fB\-\-help +Print help about usage and exit. +.TP +.BI "\-p\fP, \fB\-\-paper" " papername" +Use +.I papername +if possible. If +.I papername +is not a valid paper, print an error message and exit. +.TP +.B \-\-force +Force interactive selection of the system paper even if the actual paper +is a valid one. +.SH ENVIRONMENT +.B PAPERCONF +Full path to a file containing the paper size to use; this file will +be rewritten with the system paper size. +.SH FILES +.TP 20 +.B @PAPERCONF@ +Contains the name of the system-wide default paper size to be used +if the +.B @PAPERSIZEVAR@ +variable is not set. +.TP 20 +.B @RUNPARTSDIR@ +Directory of scripts to run after the paper size has been changed. +This package puts no scripts here, but other packages may. +.SH AUTHOR +Yves Arrouye <arrouye@debian.org> +.SH SEE ALSO +.BR paperconf (1) +.br +.BR papersize (5) + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperdone.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperdone.3 new file mode 100644 index 00000000000..d1098b8c116 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperdone.3 @@ -0,0 +1,2 @@ +.so man3/paperinit.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperfirst.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperfirst.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperfirst.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinfo.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinfo.3 new file mode 100644 index 00000000000..68f5bf75f98 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinfo.3 @@ -0,0 +1,65 @@ +.TH PAPERINFO 3 "24 September 1996" +.SH NAME +paperinfo, paperwithsize, paperfirst, paperlast, papernext, paperprev +\- return informations about a paper +.SH SYNOPSYS +.nf +.B #include <paper.h> +.sp +.B "const struct paper* paperinfo(const char* papername)" +.B "const struct paper* paperwithsize(double psw, double psh)" +.sp +.B "char* papername(const struct paper*)" +.B "double paperpswidth(const struct paper*)" +.B "double paperpsheigth(const struct paper*)" +.sp +.B "const struct paper* paperfirst(void)" +.B "const struct paper* papernext(const struct paper* pinfo)" +.B "const struct paper* paperprev(const struct paper* pinfo)" +.B "const struct paper* paperlast(void)" +.fi +.SH DESCRIPTION +.B paperinfo() +returns a pointer to a +.B struct paper +containing informations about the paper with name +.B papername +. +.B paperwithsize() +looks for a paper whose width and height is +.B psw +and +.B psh +in PostScript points, and return a pointer to a +.B struct paper +corresponding to the paper found. +.PP +.B papername() +returns the name of a paper described by an opaque struct paper object +. +.B paperpswidth() +returns the width, in PostScript points, of a paper described by an +opaque struct paper object +. +.B paperpsheight() +returns the height, in PostScript points, of a paper described by an +opaque struct paper object +. +.PP +.B paperfirst() +and +.B paperlast() +return the first and last entries for papers. +Iteration from one entry to the next or the previous one can be done +with +.B papernext() +and +.B paperprev() +respectively. +.SH SEE ALSO +.BR paperinit (3), +.BR paperdone (3) +.BR defaultpapername (3) +.br +.BR papersize (5) + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinit.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinit.3 new file mode 100644 index 00000000000..e1f71dfdf99 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinit.3 @@ -0,0 +1,27 @@ +.TH PAPERINIT 3 "24 September 1996" +.SH NAME +paperinit, paperdone \- begin and end using the paper library +.SH SYNOPSYS +.nf +.B #include <paper.h> +.sp +.B "void paperinit(void)" +.B "void paperdone(void)" +.fi +.SH DESCRIPTION +.B paperinit() +initializes the paper library, allocating any resources that are +necessary for its use. +This function must be called before any other function of the paper +library is used. +.PP +.B paperdone() +frees any resources that were allocated for the paper library. +No function of the library should be called after a call to this +function. +.SH SEE ALSO +.BR defaultpapername (3), +.BR paperinfo (3) +.br +.BR papersize (5) + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperlast.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperlast.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperlast.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papernext.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papernext.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papernext.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperprev.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperprev.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperprev.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsheight.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsheight.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsheight.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsname.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsname.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsname.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpswidth.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpswidth.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpswidth.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papersize.5.in b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papersize.5.in new file mode 100644 index 00000000000..f0f71934890 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papersize.5.in @@ -0,0 +1,63 @@ +.TH PAPERSIZE 5 +.SH NAME +.B papersize +\- specify preferred paper size +.SH SYNOPSYS +.B @PAPERCONF@ +.SH DESCRIPTION +The +.B papersize +file is used to specify the preferred paper size to use by available +commands and programs generating documents. +.PP +The format of this file is extremely simple: whitespace and anything +starting with `#' is ignored, and the name of the paper is the first +string found; the case in the name of the paper does not import (see +.B CAVEATS +section however). +.SH "PAPER NAMES" +The following names are commonly understood by programs: +.B a3\fP,\fB a4\fP,\fB a5\fP, +.B b5\fP,\fB letter\fP,\fB legal\fP,\fB executive\fP,\fB note\fP +and +.BR 11x17 . +.PP +Additional paper names that one may encounter are: +.B a0\fP,\fB a1\fP,\fB a2\fP,\fB a6\fP,\fB a7\fP,\fB a8\fP,\fB a9\fP,\fB a10\fP, +.B b0\fP,\fB b1\fP,\fB b2\fP,\fB b3\fP,\fB b4\fP,\fB tabloid\fP, +.B statement\fP,\fB note\fP, +.B halfletter\fP,\fB halfexecutive\fP,\fB folio\fP,\fB quarto\fP,\fB ledger\fP, +.B archA\fP,\fB archB\fP,\fB archC\fP,\fB archD\fP,\fB archE\fP,\fB flsa\fP, +.B flse\fP,\fB csheet\fP,\fB dsheet\fP,\fB esheet\fP +and +.BR 10x14 . +.PP +The value of the +.B papersize +file can be overrideen by +looking in order at the +.B @PAPERSIZEVAR@ +environment variable, then at the contents of the file specified by the +.B @PAPERCONFVAR@ +environment variable. If the +.B papersize +file does not exist, programs using the paper library default to using +.B letter +as a fall-back value +.SH CAVEATS +This manual page documents the format of the +.B papersize +file that is read by the +.B libpaper +library. +Some programs that read this file do not yet use the library and may have +trouble ignoring whitespace and comments in the file; they may also +require that the paper names use a specific capitalization. +.SH DOCUMENTATION +Yves Arrouye <arrouye@debian.org> +.SH SEE ALSO +.BR paperconf (1) +.br +.BR paperconfig (8) + + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperwithsize.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperwithsize.3 new file mode 100644 index 00000000000..0ba4c23059d --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperwithsize.3 @@ -0,0 +1,2 @@ +.so man3/paperinfo.3 + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapername.3.in b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapername.3.in new file mode 100644 index 00000000000..033e0309756 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapername.3.in @@ -0,0 +1,53 @@ +.TH SYSTEMPAPERNAME 3 "17 September 2001" +.SH NAME +systempapername, defaultpapername, systempapersizefile, +defaultpapersizefile \- return names for managing system paper +information +.SH SYNOPSYS +.nf +.B #include <paper.h> +.sp +.B "const char* systempapername(void)" +.B "const char* defaultpapername(void)" +.sp +.B "const char* systempapersizefile(void)" +.B "const char* defaultpapersizefile(void)" +.fi +.SH DESCRIPTION +.B systempapername() +returns the name of the default paper to be used by a program. +This name is obtained by looking in that order at the +.B @PAPERCONFVAR@ +environment variable, at the contents of the file returned by +.B systempapersizefile() +or by using +.B defaultpapername() +as a last chance. +.PP +.B defaultpapername() +returns the name of the default paper to use if it is impossible to get +its name from the environment. +.PP +.B systempapersizefile() +returns the path of the papersize file to use. +This path is obtained by looking at the +.B @PAPERCONFVAR@ +environment variable or by calling +.BR defaultpapersizefile() . +.PP +.B defaultpapersizefile +returns the path of the default papersize file. +.SH ENVIRONMENT +.TP 20 +.B @PAPERSIZEVAR@ +Paper size to use regardless of what the papersize file contains. +.TP 20 +.B @PAPERCONFVAR@ +Full path to a file containing the paper size to use. +.SH FILES +.TP 20 +.B @PAPERCONF@ +Contains the name of the system-wide default paper size to be used. +.SH SEE ALSO +.BR papersize (5) + diff --git a/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapersizefile.3 b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapersizefile.3 new file mode 100644 index 00000000000..42182084272 --- /dev/null +++ b/Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapersizefile.3 @@ -0,0 +1 @@ +.so man3/systempapername.3 |