Added date version and title

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@11814 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
CaS 2001-12-18 16:54:15 +00:00
parent e1b5e01915
commit d4b9683acf
74 changed files with 234 additions and 8 deletions

View file

@ -1,6 +1,7 @@
2001-12-18 Richard Frith-Macdonald <rfm@gnu.org>
* Tools/AGSHtml.m: Fix 'standards' output.
Many source files modified to contain date, version, and title info.
* Tools/AGSHtml.m: Fix 'standards' output. Implement date and version.
* Tools/AGSOutput.m: Add 'standards' support for class, category,
and protocol. Use new standards info from parser.
* Tools/AGSParser.h: New method to set current standards.

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSArchiver class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -24,6 +24,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSArray class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSAssertionHandler class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -28,6 +28,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSAttributedString class reference</title>
$Date$ $Revision$
*/
/* Warning - [-initWithString:attributes:] is the designated initialiser,

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSAutoreleasePool class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSBitmapCharSet class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -23,6 +23,9 @@
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSBundle class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSCalendarDate class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
<title>NSCallBacks class reference</title>
$Date$ $Revision$
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
/**** Included Headers *******************************************************/

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSCharacterSet class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSClassDescription class reference</title>
$Date$ $Revision$
*/
#include <Foundation/NSClassDescription.h>

View file

@ -20,6 +20,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSCoder class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -23,6 +23,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSConnection class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSCopyObject class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSCountedSet class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSData class reference</title>
$Date$ $Revision$
*/
/* NOTES - Richard Frith-Macdonald 1997

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDate class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDateFormatter class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDebug class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -20,6 +20,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDecimal class reference</title>
$Date$ $Revision$
*/
#include <math.h>

View file

@ -20,6 +20,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDecimalNumber class reference</title>
$Date$ $Revision$
*/
#include <Foundation/NSException.h>

View file

@ -20,6 +20,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDictionary class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -20,6 +20,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDistantObject class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDistributedLock class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSDistributedNotificationCenter class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSEnumerator class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSException class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSFileHandle class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -27,6 +27,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSFileManager class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSFormatter class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -18,7 +18,11 @@
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSGeometry class reference</title>
$Date$ $Revision$
*/
/**** Included Headers *******************************************************/

View file

@ -20,7 +20,11 @@
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSHashTable class reference</title>
$Date$ $Revision$
*/
/**** Included Headers *******************************************************/

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSHost class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -20,6 +20,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSInvocation class reference</title>
$Date$ $Revision$
*/
#include <Foundation/NSException.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSLock class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSLog class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -20,7 +20,11 @@
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSMapTable class reference</title>
$Date$ $Revision$
*/
/**** Included Headers *******************************************************/

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSMethodSignature class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSNotification class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -23,6 +23,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSNotificationCenter class reference</title>
$Date$ $Revision$
*/
#include "config.h"

View file

@ -20,6 +20,9 @@
damages whatsoever resulting from loss of use, data or profits, whether in
an action of contract, negligence or other tortious action, arising out of
or in connection with the use or performance of this software.
<title>NSNotificationQueue class reference</title>
$Date$ $Revision$
*/
/* Implementation for NSNotificationQueue for GNUStep

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSNull class reference</title>
$Date$ $Revision$
*/
/*

View file

@ -22,6 +22,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSNumber class reference</title>
$Date$ $Revision$
*/
#include <string.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSNumberFormatter class reference</title>
$Date$ $Revision$
*/
#include <Foundation/NSDictionary.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSObjCRuntime class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSObject class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSPage class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSPipe class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSPort class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -27,6 +27,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSPortCoder class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSPortMessage class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSPortNameServer class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSProcessInfo class reference</title>
$Date$ $Revision$
*/
/*************************************************************************

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSProtocolChecker class reference</title>
$Date$ $Revision$
*/
#include "config.h"

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSProxy class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -18,7 +18,11 @@
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSRange class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSRunLoop class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSScanner class reference</title>
$Date$ $Revision$
*/
#include <config.h>
@ -54,7 +57,7 @@ static Class GSUnicodeStringClass;
static Class GSMutableStringClass;
static Class GSPlaceholderStringClass;
static Class NSConstantStringClass;
static id *_holder;
static id _holder;
static NSCharacterSet *defaultSkipSet;
static SEL memSel;

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSSerializer class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSSet class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -25,6 +25,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSString class reference</title>
$Date$ $Revision$
*/
/* Caveats:

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSTask class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -25,6 +25,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSThread class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -18,7 +18,11 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSTimeZone class reference</title>
$Date$ $Revision$
*/
/* We use a implementation independent of the system, since POSIX
functions for time zones are woefully inadequate for implementing

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSTimer class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSURL class reference</title>
$Date$ $Revision$
*/
/*

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSURLHandle class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSUnarchiver class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -18,6 +18,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSUndoManager class reference</title>
$Date$ $Revision$
*/
#include "config.h"

View file

@ -19,6 +19,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSUser class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSUserDefaults class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -21,6 +21,9 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSValue class reference</title>
$Date$ $Revision$
*/
#include <config.h>

View file

@ -19,7 +19,11 @@
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA. */
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA.
<title>NSZone class reference</title>
$Date$ $Revision$
*/
/* Design goals: