Naming Conventions:

Once an application has been initialized, the PIA server "knows about it" and can recognize various shorthand forms of addressing the application and its constituent parts. For example, consider the agent History:
/Agents/History/
The History application's ``home directory''.
/~History/
An alias for the History application's home directory. The aliasing is performed by means of an ``agent'' contained in History's configuration file (_subsite.xcf). Note that the alias does not have to have the same name as the application's directory: the alias for /Agents/SimpleCalendar is ~Calendar.
/~History/-
A generic listing of History's home directory. This will work with any directory, not just agent homes, although it can be hidden by the site designer. For example, /- gives a generic listing of the PIA's home directory.
/~History/DATA/
Usually the application's data directory, if it has one. This is just a convention that is not universal: for example, the SimpleCalendar application keeps calendar events in a collection of subdirectories with four-digit names like /~Calendar/1999/ .
/~History/DATA/-
A generic listing of the data directory.

Copyright © 1997-1999 Ricoh Innovations, Inc.
$Id: naming.html,v 1.3 2001-01-11 23:36:46 steve Exp $