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