Norbert Gruener > rcsfreeze > rcsfreeze

Download:
rcsfreeze-1.8.tar.gz

Annotate this POD

CPAN RT

Open  0
Report a bug
Source  

NAME ^

rcsfreeze - freeze a configuration of sources checked in under RCS

SYNOPSIS ^

rcsfreeze [-help] [-man] [-version] symrev

OPTIONS AND ARGUMENTS ^

-help

Print a brief help message and exit.

-man

Print the manual page and exit.

-version

Print the version number and exit.

symrev

The symbolic revision number.

DESCRIPTION ^

rcsfreeze assigns the specified symbolic revision number symrev to a set of RCS files that form a valid configuration. The symbolic revision number must be unique. It is assigned to the most recent revision of each RCS file of the main trunk.

rcsfreeze prompts for a log message. The log message must be terminated by end-of-file or by a line containing . by itself. The according lines are labeled by its symbolic revision number. This log message can be retrieved by the rlog command

This script works only on all RCS files in the current directory at one time. It is important that all changed files are checked in (there are no precautions against any error in this respect). Run rcsclean first and see whether any sources remain in the current directory.

README ^

 rcsfreeze.pl is a perl script to freeze a configuration of
 sources checked in under RCS.

 This perl script is a complete rewrite of the rcsfreeze.sh shell
 script contained in  the RCS package with its RCS ID:
       "rcsfreeze.sh,v  4.6  1993/11/03 17:42:27 eggert Exp"
 The major differences between the shell script and the perl
 script are the following:
 the input argument "symb revision number"
     - is optional for the shell script. Internally an unique
       revision number is used.
     - is mandatory for the perl script. Only this symbolic
       revision number is used.
 the log message
     - is saved by the shell script in its own file
       rcsfreeze.log. But there are no tools available to
       retrieve the log messages for a given revision number.
     - is saved by the perl script amongst the other RCS log
       messages.  Therefore they can be retrieved with the
       appropriate rlog command.

 For more information on how to use the script, see the pod
 documentation or view the man pages.

 For instructions on how to install the script, see the file
 INSTALL.

 Problems, questions, etc. may be sent to nog@MPA-Garching.MPG.DE

 For Copyright see the pod documentation.

SEE ALSO ^

rlog(1), rcsclean(1)

PREREQUISITES ^

 module IO::Dir
 module Rcs

OSNAMES ^

any UNIX system

SCRIPT CATEGORIES ^

 Version_Control
 Software Configuration Management
 Software Development

AUTHOR ^

Norbert E. Gruener <nog@MPA-Garching.MPG.DE> 

Rewrite of the shell script rcsfreeze.sh from Paul Eggert as part of the RCS package: rcsfreeze.sh,v 4.6 1993/11/03 17:42:27 eggert Exp

COPYRIGHT AND DISCLAIMER ^

© 1999-2000 Norbert E. Gruener <nog@MPA-Garching.MPG.DE>.  All rights reserved. 

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

VERSION ^

Version 1.8