/usr/share/doc/libpaper-1.1.24/ Current File: //usr/share/doc/libpaper-1.1.24/README
The paper library and accompanying files are intended to provide a simple
way for applications to take actions based on a system- or user-specified
paper size.

This release is quite minimal, its purpose being to provide really basic
functions (obtaining the system paper name and getting the height and
width of a given kond of paper) that applications can immediately
integrate.
A more complete library, using a capabilities file for papers (giving,
in addition to the size, informations like paper weigth, color, etc)
will be released later.

See the sources for paperconf(1) in src/paper.c for how to use the library.

Adding new paper sizes
======================

If a paper format is missing, one need to add it to lib/paperspecs.  The
format of this file is one paper format per line, with the name of the
format, the width and height of the format separated with space.  You
may add an option measurement unit among in, ft, pt, m, dm, cm, mm or you
may leave the default unit of "point".  By defaults the width and height
are specified in the "point" unit, which is 1/72 inch (2.54 cm).  This
is the A4 entry:

  a4 210 297 mm

that was previously written as

  a4 595 842

The sizes here are 595 points / 72 points pr inch * 2.54 cm per
inch = 20.99 cm and 842/72*2.54 = 29.70 cm.  The A4 format
is 210x297 mm so this is a good approximation.  (Source:
<URL:http://en.wikipedia.org/wiki/A4_paper_size>)

Copyright (C) Yves Arrouye <yves@debian.org>, 1996
              Adrian Bunk  <bunk@fs.tum.de> , 2000