NAME

qrcs - quick and dirty front-end to RCS


SYNOPSIS

qrcs [options] <filename>+


DESCRIPTION

qrcs is a quick and dirty front-end to RCS, allowing multiple users to manage important configuration files without fear of getting in each other's way.


Options

-c

Change lock status of a checked out file (must also use either -l or -u).

-e

Invoke editor after checking out file.

-h

Display this documentation.

-i

Check in a file to RCS (must use -m and -w).

This also does an implicit check-out of the file after check-in, making the file once again available to whatever parts of the system require it. The UID & GID of the file are preserved, along with the read and execute permissions.

Unless -n is used, the file's immutable attribute is also set, effectively making it impossible to write to the file without explicitly checking it out.

The RCS directory will be created if it doesn't already exist.

-l

Lock file.

-m ltmessagegt

Check in file using this log message.

-n

Don't set file's immutable attribute. Operations that require the attribute to be unset will still clear it as required.

-o

Check out a file from RCS (must also use either -l or -u). The file's immutable attribute will be set if checked out without lock, unless -n is used.

-r

Show file's RCS log.

-t ltdescriptiongt

Descriptive text used for initial check-in. Ignored on subsequent check-ins.

-u

Unlock file.

-v

Print version number of qrcs and exit.

-w ltusergt

Check in file as this user.


EXAMPLES

qrcs -i -w dilbert -m 'Added MX host' /var/named/db.isp.com

Check in db.isp.com with an informative log message as user dilbert.

qrcs -o -l /var/named/db.isp.com

Check out db.isp.com, locking the file in the process.

qrcs -r /var/named/db.isp.com

Inspect the log file for db.isp.com.

qrcs -c -l db.isp.com

Change db.isp.com's status to locked after checking it out without lock.

qrcs -c -u -n db.isp.com

Change db.isp.com's locked status to unlocked, but without setting the immutable attribute.


AUTHOR

Ian Macdonald <ian@caliban.org>


BUGS

Probably. Send me your diffs.


SEE ALSO

ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1)


ENVIRONMENT VARIABLES

EDITOR

Name of editor to invoke.


LICENCE

Copyright (C) Ian Macdonald <ian@caliban.org>

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, 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.