RCSIFY

Section: User Commands (1)
Updated:
Index Return to Main Contents

NAME

rcsify - Convert files/directories to use RCS.

SYNOPSIS

rcsify [ -aflmNnqruv ] [ files... ]

DESCRIPTION

Rcsify inserts RCS Log and Header fields into files, creates an RCS directory (if one is not already present) and checks in the files. By default it will check in only files with a recognised suffix (see below). Files that already contain RCS Header or Log information are checked in with ci -k. Rcsify also determines the comment type appropriate to the files and uses rcs -c to set the correct string.

file will usually be a file in the current directory, but it is also possible to give a filename containing path information. In this case rcsify will create the RCS revision group in the appropriate directory. Use the -v and -n options (see below) if you are unsure about the action(s) that rcsify will take.

FILE TYPES

Rcsify currently recognises the following file suffixes:

,v: RCS revision group files. These are moved to the RCS directory if they are not already there.
.awk: Awk scripts.
.c: C files.
.c++: C++ files.
.cl: Common lisp files.
.el: Emacs lisp files.
.gperf: GNU gperf files.
.h: C language header files.
.latex: Latex files.
.lex: Lex files.
.lisp: Lisp files.
.lsp: Lisp files.
.man: Troff man pages.
.[1-6]: Troff man pages.
.me: Troff me macro files.
.mm: Troff mm macro files.
.ms: Troff ms macro files.
.perl: Perl scripts.
.s: Assembler files.
.scm: Scheme files.
.sh: Shell scripts.
.ss: Scheme files.
.tex: Tex files.
.texinfo: GNU texinfo files.
.ti: Terminfo files.
.y: Yacc files.

OPTIONS

Rcsify takes a variety of options which can be used to control various aspects of its behaviour, such as check in style, file type recognition, diagnostic output and more. The meaning of each of the options is explained below.

-a: All files. Normally rcsify does not consider files that start with a leading dot. This option (similar to the -a option on ls) tells rcsify to consider all files. However, "." and ".." are always ignored unless present on the command line that rcsify was invoked with.
-f: Use file(1). Normally rcsify recognises files based solely on their suffixes, as given in the above list. The -f option tells rcsify to use file(1) to try to determine the file type in the event that the above suffix recognition fails. If file(1) recognises the file as being of one of the above types then it is checked in in exactly the same fashion as it would have been had it had the suffix. This is useful to force rcsify to recognise (for example) troff source manual pages, or shell scripts whose names do not end with .sh.
-l: Check in with -l. Normally rcsify checks the files in with ci -q (quiet). This option adds -l to the check in flags. This results in an immediate co -l being done by ci. See the -l option for ci(1).
-m: This causes rcsify to recognise makefiles. If a file named "makefile", "Makefile", "GNUmakefile", "Imakefile" or "*.mk" is encountered, then it is treated as a makefile, the appropriate header and log information is added and the file is checked in.
-N: No check in. Rcsify will add the header and log fields to the files and create an RCS directory if necessary, but will not check in any files.
-n: This is essentially the same as the -n option for make(1). No actions are actually performed but the usual diagnostic messages appear as though rcsify were actually doing the work. This is very useful to check that what rcsify would do is sensible, before actually doing it.
-q: Quiet mode. Rcsify will not print diagnostic messages to show what it is doing. Error messages will still appear.
-r: Recursive. Normally, when rcsify encounters a directory it is ignored. With the -r option, rcsify calls itself on the subdirectory.
-u: Check in with -u. Normally rcsify checks the files in with ci -q (quiet). This option adds -u to the check in flags. This results in an immediate co being done by ci. See the -u option for ci(1).
-v: Verbose output. With this option rcsify gives alot of information about what it is doing. This is very useful with the -n option.

NOTES

Rcsify attempts to do the right thing to shell scripts, awk scripts and perl scripts which begin with the #! directive. It also deals with .lex, .y and .gperf files in a sensible fashion. Check the results if you have any worries.

AUTHOR

Terry Jones
Center for Research on Concepts & Cognition
510 North Fess
Indiana University
Bloomington IN 47405 USA

This document was created by man2html, using the manual pages.
Time: 06:17:59 GMT, December 12, 2024