Software: rcss

While I realize the audience will be limited, today I released a revision control tool “rcss”, on sourceforege and github.

“rcss” is basically a wrapper around the rcs utility.
It is designed to simplify rcs and add features to make rcs easy to use.

I wrote an article on RCS years ago for an archlinux monthly newsletter, if you don’t know what RCS is, then it might be useful: ArchLinux-Newsletter-August-2009.

Normally I’m working on my own projects/server/programs, and this is a very simple way to deal with revision control of files I change that I need to be able to revert back if something goes awry. The utility also gives you the ability to view two different revisions on one screen with changes highlighted in color via vimdiff. This has proven to be an extremely handy tool for me as a systems administrator, so I thought I would share it. There should be two files on sourceforge and github, on shell script and one .deb file. The .deb file works on debian/mint to install the shell script into /usr/local/bin giving it the correct permissions. The shell script you can do the same thing with or put it in your $PATH somewhere. After installing “rcss -h” will give you the help file.

OS: Linux, Solaris, Freebsd
Requirements: vim, rcs, awk, coreutils

Normal Usage: rcss

-h or –help
Example: rcss -h
Shows this help file

Example: rcss -l test.txt
Shows the rcs log file for test.txt
NOTE: Parsed through “less”, so hit “q” when finished ! πŸ™‚

Example: rcss -d 1.5 1.7 test.txt
This shows (via vimdiff) a diff of version 1.5 and version 1.7 of test.txt

Example: rcss -v 1.5 test.txt
This shows (via view) version 1.5 of file test.txt

Example: rcss -R 1.5 test.txt
This will revert test.txt back to version 1.5

Example: rcss 777
This will set permissions on back to 777

Files CREATED with rcss will also have some helpful rcs header information already put there for you.
> cat
# $RCSfile:,v $
# $Revision: 1.1 $
# $Date: 2014/07/28 16:49:01 $
# $Source: /home/davec/RCSS/RCS/,v $
# $Author: davec $

# CREATED BY: davec
# DATE: Mon Jul 28 11:47:07 CDT 2014

Let me know what you think, other than… “Why don’t you just use git?” I really don’t want to get into revision control wars, rcs is useful for ME. ymmv.

3 thoughts on “Software: rcss

  1. yourname

    I searched for a “rcs cat” for a vimdiff with older and current version without an “overwrite”. Found yours, but this overwrites, did an strace and found -kkvl and have no idea what this mean and what a keyword is, but it works:
    vimdiff <(/usr/bin/rcs co -q -p1.24 -kkvl ,v)



Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.