CI(1)                      OpenBSD Reference Manual                      CI(1)

NAME
     ci - check in RCS revisions

SYNOPSIS
     ci [-qV] [-d[date]] [-f[rev]] [-I[rev]] [-i[rev]] [-j[rev]] [-k[rev]]
        [-l[rev]] [-M[rev]] [-mmsg] [-Nsymbol] [-nsymbol] [-r[rev]] [-sstate]
        [-tstr] [-u[rev]] [-wusername] [-xsuffixes] [-ztz] file ...

DESCRIPTION
     The ci program is used to check in new revisions to RCS files.

     When a file is checked in, it is stored in the RCS directory with a spe-
     cific revision number, and the original file itself is deleted.  The RCS
     file is stored with the same name, but with `,v' appended.  ci will
     prompt for a check-in message, to be stored with the file, which can be
     displayed using rlog(1).

     Revision numbering starts at 1.1 and increases logically.  Numbering can
     be altered using the -k option, however.  The `,v' suffix can also be al-
     tered, using the -x option.

     ci also supports keyword substitution - see the rcs(1) man page for more
     information.

     The following options are supported:

     -d[date]
             Uses date for check-in date and time.  If date is not specified,
             use the working file's last modification time.

     -f[rev]
             Force check-in - even if no changes have been made to the working
             file.

     -I[rev]
             Interactive mode.

     -i[rev]
             Only do initial check-in.  Print error and refuse to do check-in
             if the RCS file already exists.

     -j[rev]
             Only do update check-in.  Print error and refuse to do check-in
             if the RCS file does not already exist.

     -k[rev]
             Search the working file for keywords and set the revision number,
             creation date, state and author to the values found in these key-
             words instead of computing them.

     -l[rev]
             The same as -r, but also immediately checks out the deposited re-
             vision and locks it.  This is useful if you wish to continue to
             edit the working file after check-in.

     -M[rev]
             Set the modification time of the file to the date of the re-
             trieved revision.

     -mmsg   Specify a log message.  A line beginning with a hash character
             (`#') is considered a comment and ignored.

     -Nsymbol
             Assign the symbolic name symbol to the checked in revision, over-
             writing any previous assignment of symbol.

     -nsymbol
             The same as -N except it does not overwrite previous symbols.

     -q      Be quiet about reporting.

     -r[rev]
             Check in revision rev.  However, if rev is not specified the
             meaning is completely different - override any -l or -u options,
             ensuring the default behaviour of releasing a lock and removing
             the working file.

     -sstate
             Sets the state of the deposited revision to the identifier state.
             The specified value may not contain a space character.

     -tstr   Change the descriptive text.  The argument str is interpreted as
             the name of a file containing the descriptive text or, if pre-
             fixed with a `-', the actual descriptive text itself.  If no ar-
             gument is given, this option is ignored (for compatibility rea-
             sons).

     -u[rev]
             The same as -r, but also immediately checks out the deposited re-
             vision read-only.  Useful if you wish to read the working file
             after check-in.

     -V      Print RCS's version number.

     -wusername
             Uses username as the author field of the deposited revision.

     -xsuffixes
             Specifies the suffixes for RCS files.  Suffixes should be sepa-
             rated by the `/' character.

     -ztz    Specify the date output format in keyword substitution, and the
             default time zone for date used in the -d option.

     The ci utility exits 0 on success, and >0 if an error occurs.

ENVIRONMENT
     RCSINIT  If set, this variable should contain a list of space-delimited
              options that are prepended to the argument list.

     TMPDIR   When set, this variable specifies the directory where temporary
              files are to be created.  The default is set to /tmp.

SEE ALSO
     co(1), ident(1), rcs(1), rcsclean(1), rcsdiff(1), rcsmerge(1), rlog(1)

OpenBSD 4.7                     August 26, 2007                              2
