PIA Files and Directories

Contents:

Top-Level Directories

The following table describes the directories immediately under the PIA directory.

Doc/ Complete documentation for the PIA.
Agents/ Subdirectories for standard applications and agents. Each subdirectory contains the collection of XML and HTML files (active pages) that work together to form an application.
Config/ Configuration information, including subdirectories for Makefiles and for XML site configuration files.
Samples/ Contains a few simplified active pages, which are meant to be copied and modified as templates for writing your own active pages.
Contrib/ Used for contributed agents and other files that are not a part of the standard release.
bin/ Programs that actually run the PIA software either as a web server ( pia, pia.bat or as a command line filter process. Note that pia and process run under Unix only.)
lib/ Currently not being used. This directory is meant to be used to hold class files and other libraries when the PIA is packaged as an application without its source code.
src/ src/java/ contains the Java source files used in the PIA software. The main code is in src/java/org/risource/* corresponding to org.risource.* package names. Other Java code used by the PIA is included for convenience.
CVS/ Top-level version-control directory. DO NOT EDIT! Always remove the CVS directory when you copy a PIA directory, for example from Samples/.

Standard Directories and Files

The following table describes the ``boilerplate'' directories and files that may be found anywhere in the PIA

CVS/ CVS directories exist in every directory in the PIA, for keeping track of updates and source-code versions; you shouldn't need to modify or even look in these directories, and you should remove them when copying applications to modify for your own use (e.g. copying the HelloWorld application out of PIA/Samples/).
.cvsignore Tells the CVS version control system which files not to keep under version control.
HEADER.html A header put at the top of the ``generic'' listing of a directory.
Makefile The control file for the make program, which builds
_subsite.xcf A per-directory configuration file for the PIA's site resource package: this file describes what is in the directory, and may specify agents, initialization, or virtual documents.

Copyright © 1999 Ricoh Innovations, Inc.. Open Source at <RiSource.org/PIA>.
$Id: files.html,v 1.3 2001-01-11 23:36:46 steve Exp $