A test release is created within a user's file tree for development and debugging purposes. No packages are initially included within it - the user is expected to use addpkg to include the particular subset of all packages that are needed for development.
A production release is created in $SRT_DIST/releases, and is how code is "published" for use by the collaboration. If the -f option is specified, newrel reads a list of packages and versions from file pfile, and uses the same version as in the base release for each package that isn't listed in pfile. If the -f option is not specified, newrel goes through the list of packages in the base release, and prompts for which version of each to use in the new release.
newrel sources the file $SRT_DIST/srt/srtrc for directory creation preferences. If the variable ``extra_dirs'' is defined, it is merged with the list of directories to be created. It should be in the form of a space-separated list of directory names. extra_dirs has two purposes:
1. Extra directories can be created.
2. Directories can be made into links to other
areas. The syntax for this is ``foo>/tmp/bar'',
which means that the directory foo will be made
into a link to /tmp/bar. If /tmp/bar does not
exist, newrel will (attempt to) create it.
As in other places, srtrc is really a script which is sourced, so shell logic can be used. All that matters is the final value of extra_dirs. If ``extra_dirs'' is not defined, newrel looks for ``stddirs'' for backward compatibility with the old SoftRelTools.
The variable ``release'' (the name of the new release) is guaranteed to be available when srtrc is sourced.
newrel also sources the file $HOME/.srtrc (note the leading dot) for directory creation preferences. See above for details. The following example .srtrc file is useful:
extra_dirs="$extra_dirs tmp>/tmp/$release/tmp bin>/tmp/$release/bin lib>/tmp/$release/lib "
It redirects all the directories containing large binary files to /tmp in such a way as not to interfere with other releases. Adding to the previous value of $extra_dirs makes certain that system-level defaults are also respected.
-?, --help
-p, -r, --frozen
-d, --development
-t, --test
-e, --empty
--boot
-g <path>
-f <file>
Use the version file specified by <file>,
which should have format:
example% newrel --test development foobar example% cd foobar example% addpkg --head Hello