Table of Contents
RPSL utility files
All of the RPSL utility files are in the directory $RPSL_HOME/usr/share/utl.
To begin with, this directory contains the default class skeletons. These can
be edited for a particular installation (i.e. to add a standard company
or personal or GNU copyright to source files):
ClassName.cpp.rpsl
ClassName.h.rpsl
TemplateClassName.h.rpsl
TemplateClassName.tpl.rpsl
Additionally the group or an individual user can provide a custom set in a group
or user path that overrides those in the home path, with, say, the project name.
The newclass scripts look for class skeletons in $RPSL_USER/usr/share/utl,
$RPSL_PROJ/usr/share/utl and $RPSL_HOME/usr/share/utl in that order and take
the first set found.
Proceeding, the files
configure.ac.lib.rpsl
configure.ac.exec.rpsl
are the prototypes for the RPSL-generated configure.ac for library and executable
modules, respectively.
The default prototype for configure.ac can also be overridden locally by
putting a custom one in the top-level module directory with the same name
(configure.ac.lib.rpsl or configure.ac.exec.rpsl). Changing these files, however, requires
some understanding of the autoconf and automake macros.
The files
Makefile.am.lib.top.rpsl
Makefile.am.lib.lib.rpsl
Makefile.am.lib.sub.rpsl
are prototypes for the top-level. main library level, and subdirectory
RPSL-generated Makefile.am's. If a Makefile.am.lib.sub.rpsl exists locally in a
subdirectory RPSL will not generate a new Makefile.am there, and the local
file will be copied to Makefile.am. This permits customization of the
compilation for special cases that are contained in a source subdirectory.
There is no override feature for the lib and top levels or for an executable.
A skeleton RPSL/autotools sandbox directory structure is tarred up in:
rpslSandbox.tar
The files
thelibname.h.rpsl
thelibnamever.pc.in.rpsl
are prototyes for their root names, respectively.
The default prototype for thelibname.h can be overridden locally by putting
a custom file called "thelibname.h.rpsl" in the source directory. This file
must be complete and is simply copied to thelibname.h (and renamed to the
actual library name). This is useful to specify a particular set of classes
that are the public "API" for the library. Any headers omitted from this
file and appearing only in implementation files in the library source will
not be visible to the library user.
The default prototype for thelibnamever.pc.in can also be overridden locally
by putting a custom file called "thelibnamever.pc.in.rpsl" in the top-level
module directory.
Finally,
thelibname/
theexecname/
are prototype directory trees for rpslNewLibTree and rpslNewExecTree, respectively,
to copy to a new name locally and modify.
top
Table of Contents
William Snyder
Last modified: Wed Nov 30 23:47:13 EST 2005