Return to co.1 CVS log

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

Annotation of src/usr.bin/rcs/co.1, Revision 1.21

1.21    ! jmc         1: .\"     $OpenBSD: co.1,v 1.20 2005/12/02 11:45:02 xsa Exp $
1.1       xsa         2: .\"
                      3: .\" Copyright (c) 2005 Xavier Santolaria <xsa@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.
1.2       jmc        17: .Dd October 03, 2005
1.1       xsa        18: .Dt CO 1
                     19: .Os
                     20: .Sh NAME
                     21: .Nm co
                     22: .Nd check out RCS revisions
                     23: .Sh SYNOPSIS
                     24: .Nm
                     25: .Bk -words
1.15      xsa        26: .Op Fl TV
1.7       niallo     27: .Op Fl d Ns Ar date
1.13      xsa        28: .Op Fl f Ns Op Ar rev
                     29: .Op Fl I Ns Op Ar rev
1.7       niallo     30: .Op Fl k Ns Ar mode
                     31: .Op Fl l Ns Op Ar rev
1.10      niallo     32: .Op Fl M Ns Op Ar rev
1.9       niallo     33: .Op Fl p Ns Op Ar rev
1.13      xsa        34: .Op Fl q Ns Op Ar rev
1.7       niallo     35: .Op Fl r Ns Op Ar rev
                     36: .Op Fl s Ns Ar state
                     37: .Op Fl u Ns Op Ar rev
1.17      xsa        38: .Op Fl w Ns Op Ar user
1.7       niallo     39: .Op Fl x Ns Ar suffixes
                     40: .Op Fl z Ns Ar tz
1.1       xsa        41: .Ar file ...
                     42: .Ek
                     43: .Sh DESCRIPTION
1.21    ! jmc        44: The
1.1       xsa        45: .Nm
1.21    ! jmc        46: program is used to check out revisions from RCS files.
        !            47: It always performs keyword substitution
        !            48: (see
        !            49: .Sx KEYWORD SUBSTITUTION
        !            50: in
        !            51: .Xr cvs 1
        !            52: for more information).
1.1       xsa        53: .Pp
                     54: The following options are supported:
                     55: .Bl -tag -width Ds
1.7       niallo     56: .It Fl d Ns Ar date
1.1       xsa        57: Retrieve revision as of the latest revision no later than
                     58: .Ar date .
1.13      xsa        59: .It Fl f Ns Op Ar rev
1.1       xsa        60: Force the overwriting of the working file.
1.13      xsa        61: .It Fl I Ns Op Ar rev
1.1       xsa        62: Interactive mode.
1.7       niallo     63: .It Fl k Ns Ar mode
1.1       xsa        64: Specify the keyword substitution mode.
1.7       niallo     65: .It Fl l Ns Op Ar rev
1.1       xsa        66: The same as
                     67: .Fl r ,
1.2       jmc        68: but also locks the revision.
1.10      niallo     69: .It Fl M Ns Op Ar rev
1.2       jmc        70: Set the modification time of the file to the date of the
1.1       xsa        71: retrieved revision.
1.9       niallo     72: .It Fl p Ns Op Ar rev
                     73: Print the latest revision no later than
                     74: .Ar rev
                     75: to standard output.
                     76: If
                     77: .Ar rev
                     78: is not specified, print HEAD.
1.14      jmc        79: .It Fl q Ns Op Ar rev
1.1       xsa        80: Be quiet about reporting.
1.7       niallo     81: .It Fl r Ns Op Ar rev
1.1       xsa        82: Retrieve the latest revision no later than
                     83: .Ar rev .
1.5       niallo     84: If
                     85: .Ar rev
                     86: is not specified, retrieve HEAD.
1.7       niallo     87: .It Fl s Ns Ar state
1.1       xsa        88: Retrieve revision of the specified
                     89: .Ar state
                     90: only.
1.19      xsa        91: .It Fl T
                     92: Preserve the modification time of RCS files.
1.7       niallo     93: .It Fl u Ns Op Ar rev
1.1       xsa        94: The same as
                     95: .Fl r ,
1.2       jmc        96: but also unlocks the retrieved revision if it was locked.
1.1       xsa        97: .It Fl V
                     98: Print RCS's version number.
1.17      xsa        99: .It Fl w Ns Op Ar user
1.1       xsa       100: Retrieve the latest revision which was checked in by the specified
                    101: .Ar user .
                    102: If the
                    103: .Ar user
1.2       jmc       104: argument is omitted, the login of the user issuing the command
1.1       xsa       105: is assumed.
1.7       niallo    106: .It Fl x Ns Ar suffixes
1.1       xsa       107: Specifies the suffixes for RCS files.
                    108: Suffixes should be separated by the
                    109: .Sq /
                    110: character.
1.7       niallo    111: .It Fl z Ns Ar tz
1.1       xsa       112: Specify the date output format in keyword substitution, and the
1.18      xsa       113: default time zone for
1.1       xsa       114: .Ar date
                    115: used in the
                    116: .Fl d
                    117: option.
                    118: .El
                    119: .Sh ENVIRONMENT
                    120: .Bl -tag -width RCSINIT
                    121: .It Ev RCSINIT
                    122: If set, this variable should contain a list of space-delimited options that
                    123: are prepended to the argument list.
                    124: .El
1.11      xsa       125: .Sh EXAMPLES
                    126: Retrieve the latest revision of file
                    127: .Pa foo.c
                    128: and lock it for further editing:
                    129: .Pp
                    130: .Dl $ co -l foo.c
                    131: .Pp
                    132: Retrieve revision 1.5 of file
                    133: .Pa foo.c :
                    134: .Pp
                    135: .Dl $ co -r1.5 foo.c
1.1       xsa       136: .Sh SEE ALSO
                    137: .Xr ci 1 ,
1.4       jmc       138: .Xr ident 1 ,
1.1       xsa       139: .Xr rcs 1 ,
                    140: .Xr rcsclean 1 ,
                    141: .Xr rcsdiff 1 ,
1.8       xsa       142: .Xr rcsmerge 1 ,
1.6       xsa       143: .Xr rlog 1