Return to ci.1 CVS log

Up to [local] / src / usr.bin / rcs

Annotation of src/usr.bin/rcs/ci.1, Revision 1.12

1.12    ! jmc         1: .\"     $OpenBSD: ci.1,v 1.11 2005/10/18 11:10:56 niallo Exp $
1.1       niallo      2: .\"
                      3: .\" Copyright (c) 2005 Niall O'Higgins <niallo@openbsd.org>
                      4: .\" All rights reserved.
                      5: .\"
                      6: .\" Permission to use, copy, modify, and distribute this software for any
                      7: .\" purpose with or without fee is hereby granted, provided that the above
                      8: .\" copyright notice and this permission notice appear in all copies.
                      9: .\"
                     10: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
                     11: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
                     12: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
                     13: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     14: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     15: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     16: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
                     17: .Dd October 08, 2005
                     18: .Dt CI 1
                     19: .Os
                     20: .Sh NAME
                     21: .Nm ci
                     22: .Nd check in RCS revisions
                     23: .Sh SYNOPSIS
                     24: .Nm
                     25: .Bk -words
1.5       niallo     26: .Op Fl jMNqV
1.9       niallo     27: .Op Fl d Ns Op Ar date
                     28: .Op Fl f Ns Op Ar rev
                     29: .Op Fl k Ns Ar mode
                     30: .Op Fl l Ns Op Ar rev
                     31: .Op Fl m Ns Ar msg
1.11      niallo     32: .Op Fl N Ns Ar symbol
1.10      niallo     33: .Op Fl n Ns Ar symbol
1.9       niallo     34: .Op Fl r Ns Op Ar rev
                     35: .Op Fl u Ns Op Ar rev
                     36: .Op Fl w Ns Ar username
1.1       niallo     37: .Ar file ...
                     38: .Ek
                     39: .Sh DESCRIPTION
                     40: The
                     41: .Nm
                     42: program is used to check new revisions into RCS files.
                     43: .Pp
                     44: The following options are supported:
                     45: .Bl -tag -width Ds
1.9       niallo     46: .It Fl d Ns Op Ar date
1.1       niallo     47: Uses
                     48: .Ar date
                     49: for check-in date and time.
1.7       niallo     50: If
                     51: .Ar date
                     52: is not specified, use the working file's last modification time.
1.9       niallo     53: .It Fl f Ns Op Ar rev
1.8       niallo     54: Force check in - optionally to
                     55: .Ar rev
                     56: - even if no changes have been made to the working file.
1.1       niallo     57: .It Fl I
                     58: Interactive mode.
1.9       niallo     59: .It Fl k Ns Ar mode
1.1       niallo     60: Specify the keyword substitution mode.
1.9       niallo     61: .It Fl l Ns Op Ar rev
1.1       niallo     62: The same as
                     63: .Fl r ,
1.3       jmc        64: but also immediately checks out the deposited revision and locks it.
                     65: This is useful if you wish to continue to edit the working file after check-in.
1.1       niallo     66: .It Fl M
                     67: Set the modification time of the file to the date of the
                     68: retrieved revision.
1.9       niallo     69: .It Fl m Ns Ar msg
1.1       niallo     70: Specify a log message.
                     71: A line beginning with a hash character
                     72: .Pq Sq #
                     73: is considered a comment and ignored.
1.12    ! jmc        74: .It Fl N Ns Ar symbol
        !            75: The same as
        !            76: .Fl n
        !            77: except it overwrites any previous assignment of
        !            78: .Ar symbol .
1.10      niallo     79: .It Fl n Ns Ar symbol
                     80: Assign the symbolic name
                     81: .Ar symbol
                     82: to the checked in revision.
1.1       niallo     83: .It Fl q
                     84: Be quiet about reporting.
1.9       niallo     85: .It Fl r Ns Op Ar rev
1.1       niallo     86: Check in revision
                     87: .Ar rev .
1.4       niallo     88: However, if
                     89: .Ar rev
                     90: is not specified the meaning is completely different \- override any
                     91: .Fl l
                     92: or
1.5       niallo     93: .Fl u Op Ar rev
1.4       niallo     94: options, ensuring the default behaviour of releasing a lock and removing the
                     95: working file.
1.9       niallo     96: .It Fl s Ns Ar state
1.1       niallo     97: Sets the state of the deposited revision to the identifier
                     98: .Ar state .
                     99: .It Fl u
                    100: The same as
                    101: .Fl r ,
1.3       jmc       102: but also immediately checks out the deposited revision read-only.
                    103: Useful if you wish to read the working file after check-in.
1.1       niallo    104: .It Fl V
                    105: Print RCS's version number.
1.9       niallo    106: .It Fl w Ns Ar user
1.1       niallo    107: Uses
                    108: .Ar user
                    109: as the author field of the deposited revision.
                    110: .El
                    111: .Sh ENVIRONMENT
                    112: .Bl -tag -width RCSINIT
                    113: .It Ev RCSINIT
                    114: If set, this variable should contain a list of space-delimited options that
                    115: are prepended to the argument list.
                    116: .El
                    117: .Sh SEE ALSO
                    118: .Xr co 1 ,
1.2       niallo    119: .Xr ident 1 ,
1.1       niallo    120: .Xr rcs 1 ,
                    121: .Xr rcsclean 1 ,
                    122: .Xr rcsdiff 1 ,
1.6       xsa       123: .Xr rlog 1