diff options
author | Boyuan Yang <byang@debian.org> | 2023-06-24 16:40:32 -0400 |
---|---|---|
committer | Boyuan Yang <byang@debian.org> | 2023-06-24 16:40:32 -0400 |
commit | 1110cfafc6b92837549bcc4f74f670adc46c1241 (patch) | |
tree | 7ee15ef253826a26fe6add510f707f0eb675adac /README |
Import a2ps_4.15.5.orig.tar.gz
[dgit import orig a2ps_4.15.5.orig.tar.gz]
Diffstat (limited to 'README')
-rw-r--r-- | README | 115 |
1 files changed, 115 insertions, 0 deletions
@@ -0,0 +1,115 @@ + a2ps README + + (or PRINTME if a2ps runs fine :) + + +Please send problem reports to bug-a2ps@gnu.org. Ask questions on +a2ps@gnu.org. Submit changes on a2ps-patches@gnu.org. + +See the file ANNOUNCE for a presentation of a2ps, if you're still +unsure it is indeed a filter from Anything To Probably Something. + + +Contents: +========= + +1. Installation +2. Distribution content +3. More? + + +1. Installation +=============== + +*NOTE* If you are installing from a git clone, see README-git. + +The following dependencies are required to build a2ps: + + - BDW GC (libgc): https://www.hboehm.info/gc + - libpaper: https://github.com/rrthomas/libpaper + - help2man: https://www.gnu.org/software/help2man + +The following dependencies are highly recommended: + + - psutils: https://github.com/rrthomas/psutils + - GNU roff: https://www.gnu.org/software/groff + +Most of the work for the installation is done by ./configure. If you +never ever read the file `INSTALL', then you really should do it +*now*. + +Some key options for ./configure are: + + --disable-nls + if you do not want to use Native Language Support + (i.e. the ability to speak another tongue than English) + --with-gnu-gettext + if you want to use the GNU gettext library for + NLS, instead of available NLS services. I recommend it. + --without-extensions + Fewer files will get installed. a2ps is still usable + for Western Europe and American. You should avoid unless + you are really short on disk. This does not imply + --disable-nls, you have to add it yourself. + +The following choices *are not irreversible*. They just correspond to +settings in the file etc/a2ps-site.cfg: + + --with-encoding=ENCODING + define the default encoding (ascii, latin1..., latin6, + hp, mac, ibmpc, pcg, cp1250). + +Note (for novices). If you are not root, you should give +./configure the option --prefix=$HOME to be able to install. + +Remember that `make install' is mandatory for a2ps to work correctly. +Once the `make install' is done, you may remove the build directory (the +one which has been extracted from the .gz, which you can also remove, +BTW). + + +2. Distribution content +======================= + +Some interesting files/directories you might want to look at are: + +README This file +README-git Instructions for installing directly from git +INSTALL Information on the installation process +ABOUT_NLS A presentation of GNU's Native Language Support + project +TODO Some things to be done +afm/ Files that describe the width of the chars of a font +doc/ The whole documentation +encoding/ Description of the encodings. +etc/a2ps_cfg The default configuration (after configure/make) +po/ Files for the translation +sheets/ Style sheets for pretty printing support +tests/ Sanity checks of a2ps +contrib/emacs/ Useful emacs files for a2ps +ogonkify/ The full distribution of the fantastic + ogonkify package, that fixes a font designed for + Latin1 so that other Latin encodings are supported. + + +3. More? +======== + +a2ps has a home page where the latest version may be found. + + https://www.gnu.org/software/a2ps/ + +There, you will also find the documentation in various formats. + +Bug reports should be sent to bug-a2ps@gnu.org + +There is also a mailing list, to subscribe please see + + https://lists.gnu.org/mailman/listinfo/a2ps + +*NOTE* The mailing list is for discussion about a2ps, and for +announcements. + +Local Variables: +mode: indented-text +End: |