Return to co.1 CVS log

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

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

1.8     ! xsa         1: .\"     $OpenBSD: co.1,v 1.7 2005/10/16 11:53:37 niallo 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.5       niallo     26: .Op Fl fIMpqV
1.1       xsa        27: .Op Ar rev
1.7       niallo     28: .Op Fl d Ns Ar date
                     29: .Op Fl k Ns Ar mode
                     30: .Op Fl l Ns Op Ar rev
                     31: .Op Fl m Ns Ar msg
                     32: .Op Fl r Ns Op Ar rev
                     33: .Op Fl s Ns Ar state
                     34: .Op Fl u Ns Op Ar rev
                     35: .Op Fl w Ns Ar user
                     36: .Op Fl x Ns Ar suffixes
                     37: .Op Fl z Ns Ar tz
1.1       xsa        38: .Ar file ...
                     39: .Ek
                     40: .Sh DESCRIPTION
                     41: .Nm
                     42: always performs keyword substitution.
                     43: .Pp
                     44: The following options are supported:
                     45: .Bl -tag -width Ds
1.7       niallo     46: .It Fl d Ns Ar date
1.1       xsa        47: Retrieve revision as of the latest revision no later than
                     48: .Ar date .
                     49: .It Fl f
                     50: Force the overwriting of the working file.
                     51: .It Fl I
                     52: Interactive mode.
1.7       niallo     53: .It Fl k Ns Ar mode
1.1       xsa        54: Specify the keyword substitution mode.
1.7       niallo     55: .It Fl l Ns Op Ar rev
1.1       xsa        56: The same as
                     57: .Fl r ,
1.2       jmc        58: but also locks the revision.
1.1       xsa        59: .It Fl M
1.2       jmc        60: Set the modification time of the file to the date of the
1.1       xsa        61: retrieved revision.
1.7       niallo     62: .It Fl m Ns Ar msg
1.1       xsa        63: Specify a log message.
                     64: A line beginning with a hash character
                     65: .Pq Sq #
                     66: is considered a comment and ignored.
                     67: .It Fl p
                     68: Print the retrieved revision to standard output.
                     69: .It Fl q
                     70: Be quiet about reporting.
1.7       niallo     71: .It Fl r Ns Op Ar rev
1.1       xsa        72: Retrieve the latest revision no later than
                     73: .Ar rev .
1.5       niallo     74: If
                     75: .Ar rev
                     76: is not specified, retrieve HEAD.
1.7       niallo     77: .It Fl s Ns Ar state
1.1       xsa        78: Retrieve revision of the specified
                     79: .Ar state
                     80: only.
1.7       niallo     81: .It Fl u Ns Op Ar rev
1.1       xsa        82: The same as
                     83: .Fl r ,
1.2       jmc        84: but also unlocks the retrieved revision if it was locked.
1.1       xsa        85: .It Fl V
                     86: Print RCS's version number.
1.7       niallo     87: .It Fl w Ns Ar user
1.1       xsa        88: Retrieve the latest revision which was checked in by the specified
                     89: .Ar user .
                     90: If the
                     91: .Ar user
1.2       jmc        92: argument is omitted, the login of the user issuing the command
1.1       xsa        93: is assumed.
1.7       niallo     94: .It Fl x Ns Ar suffixes
1.1       xsa        95: Specifies the suffixes for RCS files.
                     96: Suffixes should be separated by the
                     97: .Sq /
                     98: character.
1.7       niallo     99: .It Fl z Ns Ar tz
1.1       xsa       100: Specify the date output format in keyword substitution, and the
                    101: default timezone for
                    102: .Ar date
                    103: used in the
                    104: .Fl d
                    105: option.
                    106: .El
                    107: .Sh ENVIRONMENT
                    108: .Bl -tag -width RCSINIT
                    109: .It Ev RCSINIT
                    110: If set, this variable should contain a list of space-delimited options that
                    111: are prepended to the argument list.
                    112: .El
                    113: .Sh SEE ALSO
                    114: .Xr ci 1 ,
1.4       jmc       115: .Xr ident 1 ,
1.1       xsa       116: .Xr rcs 1 ,
                    117: .Xr rcsclean 1 ,
                    118: .Xr rcsdiff 1 ,
1.8     ! xsa       119: .Xr rcsmerge 1 ,
1.6       xsa       120: .Xr rlog 1