buildref 1.4.2

The "buildref" package implements a "build reference" mechanism in which
two or more projects negotiate a search protocol for different types of files,
typically provided in baseline builds or installed products.  Each baseline
build provides a description of how it is searched.  Development areas refer
to one or more baseline builds, which are searched according to their
descriptions.  References to baseline builds are created by the owners of the
development areas.  The "buildref" package provides the "bldref" program to
manipulate references to baseline builds, and the "paths" program that searches
referenced builds.

The search mechanism is quite general.  Search descriptions provided by
baseline builds list directories relative to the root of the build and
categories of files that can be found there.  For example, it could indicate
that C header files are found in a directory named "include".  When a
build is performed in a development area, the build procedure initiates a
search for all directories containing files of a certain category, or for a
specific file of a given category.  The result of the search can be used as
a search path or as an argument for additional tools.

The buildref package requires Software ChipSet and an XPG3 message catalog
system as prerequisites.  Software ChipSet is a public domain library,
available at <A HREF="http://www.wakawaka.com/source.html">http://www.wakawaka.com/source.html</A> or
<A HREF="ftp://ftp.wakawaka.com/pub">ftp://ftp.wakawaka.com/pub</A>.  XPG3 is part of the X/Open
Program Guidelines and is available on most recent releases of Unix.
(Kee Hinckley's free message catalog implementation can also be used if
the target system does not provide one.  It's also available at the Web and
FTP sites above and others.)

To install the buildref package, edit the Makefile to specify the correct
locations to install the binaries, message catalogs, and man pages.  Then
invoke "make all" to build the programs.  Then invoke "make install" to copy
the executables, message catalogs, and man pages to the appropriate places.

This software is donated to the public domain by its author, Paul Sander
(paul@wakawaka.com).

History:

1.0 -- Initial release

1.1 -- Ported to A/UX 3.0.1 and tidied up the man pages.

1.2 -- Removed default behavior of copying buildrefs from build areas listed
       on the command line.  Reinstated this behavior with the -A option.

1.3 -- Repaired "paths" program coredump when a blank line is encountered in
       the search file.

1.4 -- Added the "-S separator" option to specify separator strings between
       listed paths, and the "-l" option to list available search classes.

1.4.1 -- Repaired fputs-related portability problem in bldref program, made
         minor changes to Makefile, changed order of separator assignment in
         paths for safety.

1.4.2 -- Repaired the effect of the -p, -s, and -S options in the presence
         of files given on the command line.

 Name                    Last modified       Size  Description

 Parent Directory        13-Aug-2005 12:37      -  
 buildref.tar.Z          13-Aug-2005 12:36    21k