edits(1) manual page

NAME

edits - check out the slist for editing

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

edits checks out the slist into the top level directory of a product for editing.

OPTIONS

-f: forces the overwriting of the working file; useful in connection with -q. See also getf(1) FILE MODES for details.
-kkv: Generate keyword strings using the default form, e.g. $Revision: 1.1.6.2 $ for the Revision keyword. This is the default.
-kk: Generate only keyword names in keyword strings; omit their values. See also getf(1) KEYWORD SUBSTITUTION for details. For example, for the Revision keyword, generate the string $Revision$ instead of $Revision: 1.1.6.2 $. This option is useful to ignore differences due to keyword substitution when comparing different revisions of a file.
-ko: Generate the old keyword string, present in the working file just before it was checked in. For example, for the Revision keyword, generate the string $Revision: 1.1 $ instead of $Revision: 1.1.6.2 $ if that is how the string appeared when the file was checked in. This can be useful for binary file formats that cannot tolerate any changes to substrings that happen to take the form of keyword strings.
-kv: Generate only keyword values for keyword strings. For example, for the Revision keyword, generate the string 1.1.6.2 instead of $Revision: 1.1.6.2 $. This can help generate files in programming languages where it is hard to strip keyword delimiters like $Revision: $ from a string. However, further keyword substitution cannot be performed once the keyword names are removed, so this option should be used with care.
-q: quiet mode; diagnostics are not printed.
-I: interactive mode; the user is prompted and questioned even if the standard input is not a terminal.
-ddate: retrieves the latest revision on the selected branch whose checkin date/time is less than or equal to date. The date and time may be given in free format. The time zone LT stands for local time; other common time zone names are understood. For example, the following dates are equivalent if local time is January 11, 1990, 8pm Pacific Standard Time, eight hours west of Coordinated Universal Time (UTC):

8:00 pm lt
4:00 AM, Jan. 12, 1990 note: default is UTC
1990/01/12 04:00:00 PRECS date format
Thu Jan 11 20:00:00 1990 LT output of ctime(3) + LT
Thu Jan 11 20:00:00 PST 1990 output of date(1)
Fri Jan 12 04:00:00 GMT 1990
Thu, 11 Jan 1990 20:00:00 -0800
Fri-JST, 1990, 1pm Jan 12
12-January-1990, 04:00-WET

Most fields in the date and time may be defaulted. The default time zone is UTC. The other defaults are determined in the order year, month, day, hour, minute, and second (most to least significant). At least one of these fields must be provided. For omitted fields that are of higher significance than the highest provided field, the time zone's current values are assumed. For all other omitted fields, the lowest possible values are assumed. For example, the date 20, 10:30 defaults to 10:30:00 UTC of the 20th of the UTC time zone's current month and year. The date/time must be quoted if it contains spaces.

-M: Set the modification time on the new working file to be the date of the retrieved revision. Use this option with care; it can confuse make(1).
-sstate: retrieves the latest revision on the selected branch whose state is set to state.
-w[login]: retrieves the latest revision on the selected branch which was checked in by the user with login name login. If the argument login is omitted, the caller's login is assumed.
-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 PRECS pathname, the working pathname, and the revision number retrieved are written to the diagnostic output. The exit status is zero if and only if all operations were successful.

IDENTIFICATION

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