============================================================================ mouse:~ppr/src/README.txt mouse:~ppr/src/docs/misc/README.txt (symbolic link) Last revised 11 August 2005. ============================================================================ This directory contains the source code for PPR. PPR is a print spooler for PostScript printers. The latest version of PPR may be obtained from: http://ppr-dist.trincoll.edu/pub/ppr/ ftp://ppr-dist.trincoll.edu/pub/ppr/ The PPR home page is at: http://ppr.trincoll.edu/ ============================================================================= Documentation ============================================================================= Here is a list of the documents which will help you understand what PPR is and get it up and running as quicly as possible. docs/misc/announce.txt the announcent of the release of this version and a brief description of PPR's features and the release notes docs/misc/LICENSE.txt PPR the BSD license terms and a list of files included with PPR which are licensed under other terms INSTALL.txt detailed instructions on building and installing PPR and information about upgrading from previous versions docs/misc/PORTING.txt Consult this document if PPR's has not yet been ported to the OS which you are using. docs/pprinst/pprinst.html docs/pprinst/pprinst.pdf. a getting started guide which explains how to use PPR after you have installed it Once PPR is installed, HTML versions of all the PPR documentation can be found in the /usr/share/ppr/www/docs/ directory. Man-style versions of some of the documents are also available. You can either add PPR's man page directory (/usr/share/ppr/man) to your MANPATH or use the command "ppdoc" to read them. ============================================================================= Source Code ============================================================================= templates/ Blank source code files, used as models for headers and license statements. makeprogs/ Programs and certain intermediate files used in the build process. include/ Project wide include files. libgu/ A library of General Useful functions. libppr/ Various utility functions used in more than one project program. libscript/ A library of shell and Perl scripts and of small programs for calling from shell scripts. libttf/ A library of routines for reading TrueType fonts and converting them to PostScript. fontutils/ Tools for indexing fonts and a demonstration utility for libttf. libpprdb/ Not really a library, but rather charge account database modules pprd/ Source code of the spooler daemon. pprdrv/ Source code of the program that pprd calls to actually drive a printer. ppr/ Source code for the program ppr. ppop/ Source code of the ppop command. ppad/ Source code of the ppad command. ppuser/ Source code to the ppuser utility. papd/ Source code for PPR's new AppleTalk PAP server lprsrv/ Source code of PPR's lpr/lpd server ipp/ An Internet Printing Protocol server for PPR interfaces/ Programs which pprdrv runs to communicate with printers browsers/ Programs which enumberate available printers responders/ Programs which are run to send messages to the submitter of a job commentators/ Programs for sending news to system operators. These will soon be obsolete. filters_misc/ Various small filters, most of them shell scripts, for converting other file formats to PostScript filter_lp/ Source code for line printer emulator. filter_dotmatrix/ A filter for converting Epson/IBM dot matrix printer file to PostScript filters_typeset/ A lot of Perl typesetting code that doesn't work yet filter_pcl/ A filter (written in Java) for converting HP PCL to PostScript. It is only understands a few commands. fonts/ No actual fonts, just font data, actual fonts are in nonppr_vendors/. ppd/ BSD and MIT licenced PPD files. PPD fiels under other licenses are in nonppr_vendors/. misc/ Odds and ends that are mostly small, experimental, unimportant, or included as examples encodings/ PostScript arrays for mapping various character sets to PostScript glyph names. procsets/ Procedure sets used by filters and for N-Up. nonppr_vendors/ Fonts, procedure sets, and PPD files not under the PPR license. docs/ The PPR documentation. samba/ Programs and configuration files for integrating Samba and PPR. editps/ Sed and Perl scripts for corrected the bad PostScript generated by specific applications and printer drivers. po/ Internationalization files. www/ The WWW interface to PPR. printdesk/ A basic print queue control program written in Perl/Tk. unixuser/ A series of scripts and programs to help Unix shell or X-Windows users to use PPR. cron/ Scripts to be run as Cron jobs to clean up stray PPR temporary files., update indexes of fonts and PPD files, etc. tests/ Regression tests. nonppr_misc/ Files, such as libraries taken from other projects. Many symbolic links point to this directory. ppr-tclsh/ A modified copy of Tcl 7.4. It is intended to replace /bin/sh as the language for PPR's simple scripts. z_install_start/ z_install_end/ These directories begin with z so that they will appear at the end of a directory listing. They contain build and install scripts which are run at the start and end respectively when the top level Makefile is run. The z_install_start/Makefile creates the installation directories. The z_install_end/Makefile does final tasks such as creating missing configuration files from sample configuration files.