summaryrefslogtreecommitdiff
path: root/Build/source/libs/paper/libpaper-1.1.24+nmu2/man
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/paper/libpaper-1.1.24+nmu2/man')
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/Makefile.am25
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapername.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/defaultpapersizefile.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconf.1.in118
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperconfig.8.in73
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperdone.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperfirst.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinfo.365
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperinit.327
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperlast.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papernext.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperprev.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsheight.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpsname.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperpswidth.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/papersize.5.in63
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/paperwithsize.32
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapername.3.in53
-rw-r--r--Build/source/libs/paper/libpaper-1.1.24+nmu2/man/systempapersizefile.31
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