deltaf(1) manual page

NAME

deltaf - checks files into the version database

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Kansas University not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Kansas University makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

DESCRIPTION

deltaf checks files into the version database. The files must already belong to the product, and must have been checked out for editing with one of the edit commands before it can be checked back in.

CHECK IN PROCEDURE: For deltaf to work, the caller's login must be on the access list, except if the access list is empty or the caller is the superuser or the owner of the file.

Unless the -f option is given, deltaf checks whether the revision to be deposited differs from the preceding one. If not, instead of creating a new revision deltaf reverts to the preceding one. To revert, deltaf removes the working file. When reverting, any -n and -s options apply to the preceding revision.

For each revision deposited, deltaf prompts for a log message. The log message should summarize the change and must be terminated by end-of-file or by a line containing . by itself. If several files are checked in deltaf asks whether to reuse the previous log message. If the standard input is not a terminal, deltaf suppresses the prompt and uses the same log message for all files. See also -m.

The number rev of the deposited revision can be given by -r. rev may be symbolic, numeric, or mixed. If rev is $, deltaf determines the revision number from keyword values in the working file.

If rev is a revision number, it must be higher than the latest one on the branch to which rev belongs, or must start a new branch.

If rev is a branch rather than a revision number, the new revision is appended to that branch. The level number is obtained by incrementing the tip revision number of that branch. If rev indicates a non-existing branch, that branch is created with the initial revision numbered

If rev is omitted then the revision is appended to the default branch (normally the trunk; see the -b option of precs(1)).

Note: deltag(1), deltap(1), and deltas(1) function the same as deltaf when checking in the individual files.

Exception: On the trunk, revisions can be appended to the end, but not inserted.

OPTIONS

-a: checks in the file even if another user checked it out
-rrev: attempts to check in the file with revision rev. If that revision is already used, the next available revision will be used instead. -r may be specified with each file to be checked in by placing it before the filename as in: deltaf -r 1.2 file1 -r 1.3 file2 file3. In this example, file1 will be checked in as revision 1.2, file2 will be checked in as 1.3, and file3 will be checked in as its next available revision.
-k: searches the working file for keyword values to determine its revision number, creation date, state, and author (see getf(1)), and assigns these values to the deposited revision, rather than computing them locally. It also generates a default login message noting the login of the caller and the actual checkin date. This option is useful for software distribution. A revision that is sent to several sites should be checked in with the -k option at these sites to preserve the original number, date, author, and state. The extracted keyword values and the default log message may be overridden with the options -d, -m, -s, -w, and any option that carries a revision number.
-q: quiet mode; diagnostic output is not printed. A revision that is not different from the preceding one is not deposited.
-I: interactive mode; the user is prompted and questioned even if the standard input is not a terminal.
-d[date]: uses date for the checkin date and time. The date is specified in free format as explained in getf(1). This is useful for lying about the checkin date, and for -k if no date is available. If date is empty, the working file's time of last modification is used.
-M: Set the modification time on any new working file to be the date of the retrieved revision. For example, deltaf -d -M f does not alter f's modification time, even if f's contents change due to keyword substitution. Use this option with care; it can confuse make(1).
-mmsg: uses the string msg as the log message for all revisions checked in.
-nname: assigns the symbolic name name to the number of the checked-in revision. deltaf prints an error message if name is already assigned to another number.
-Nname: same as -n, except that it overrides a previous assignment of name.
-sstate: sets the state of the checked-in revision to the identifier state. The default state is Exp.
-tfile: writes descriptive text from the contents of the named file into the PRECS file, deleting the existing text. The file may not begin with -.
-t-string: Write descriptive text from the string into the PRECS file, deleting the existing text.

The -t option, in both its forms, has effect only during an initial checkin; it is silently ignored otherwise.

During the initial checkin, if -t is not given, deltaf obtains the text from standard input, terminated by end-of-file or by a line containing . by itself. The user is prompted for the text if interaction is possible; see -I.

For backward compatibility with older versions of RCS, a bare -t option is ignored.

-wlogin: uses login for the author field of the deposited revision. Useful for lying about the author, and for -k if no author is available.
-Vn: Emulate RCS version n. See getf(1) for details.

ENVIRONMENT

RCSINIT: options prepended to the argument list, separated by spaces. See getf(1) for details.

DIAGNOSTICS

The exit status is zero if and only if all operations were successful.

IDENTIFICATION

Author: Robert Hill $Id: precs/docs:deltaf.1 1.2 $