libpaper
                              ========

             (c) Reuben Thomas <[email protected]>, 2013-2022
                 https://github.com/rrthomas/libpaper


The libpaper package enables users to indicate their preferred paper
size, provides the paper(1) utility to find the user's preferred
default paper size and give information about known sizes, and
specifies system-wide and per-user paper size catalogues, which can be
can also be used directly (see paperspecs(5)).

The paperconfig(1) utility is provided to allow other systems that
have their own paper size configuration systems paper sizes, such as
TeXLive, to interoperate with paper(1).

Libpaper is distributed under the GNU General Public License version
3, or, at your option, any later version; see the file COPYING.

The C library libpaper is distributed under the GNU Lesser General
Public License version 3, or, at your option, any later version; see
the file COPYING-LGPL. The file ‘paperspecs’ is in the public domain.

Libpaper was developed by Reuben Thomas <[email protected]>, based on the
design of libpaper by Yves Arrouye <[email protected]>, improved by
Adrian Bunk <[email protected]>. It also supersedes the earlier “paper”
package developed by Reuben Thomas.


Installation from source
------------------------

To build, you need a standard POSIX environment and C compiler. Run:

  ./configure --enable-relocatable && make && [sudo] make install

The --enable-relocatable option builds libpaper as a relocatable
package that can be copied anywhere once built and installed. Note
that if you do not use it, the tests (“make check”) will not work.

For installation options, see ./configure --help; see INSTALL for more
information.


Building from git
-----------------

To build from git, you need the following extra programs installed:

  automake, autoconf, git

Then run:

  ./bootstrap

Then follow the instructions for building from source.