flesh out the description of co; ok xsa

1 files changed, 30 insertions, 7 deletions

diff --git a/usr.bin/rcs/co.1 b/usr.bin/rcs/co.1
index 57c8359e5b6..70547ac2326 100644
--- a/usr.bin/rcs/co.1
+++ b/usr.bin/rcs/co.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: co.1,v 1.22 2006/03/06 09:41:53 deraadt Exp $
+.\"	$OpenBSD: co.1,v 1.23 2006/04/19 10:47:22 jmc Exp $
 .\"
 .\" Copyright (c) 2005 Xavier Santolaria <xsa@openbsd.org>
 .\" All rights reserved.
@@ -38,18 +38,41 @@
 .Op Fl w Ns Op Ar user
 .Op Fl x Ns Ar suffixes
 .Op Fl z Ns Ar tz
-.Ar file ...
+.Ar
 .Ek
 .Sh DESCRIPTION
 The
 .Nm
 program is used to check out revisions from RCS files.
-It always performs keyword substitution
-(see
-.Sx KEYWORD SUBSTITUTION
-in
+.Pp
+When a file is checked out,
+a copy is taken from the RCS repository,
+minus its RCS information,
+and placed in the current working directory.
+Files may be checked out as the most recent revision
+or according to a specific revision,
+using the
+.Fl r
+option.
+.Pp
+Files are checked out in one of two possible modes:
+unlocked (the default) or locked (using the
+.Fl l
+option).
+In unlocked mode, any user may check out the file for reading.
+If changes are to be made to a file though,
+it will have to be locked using the
+.Fl l
+option.
+During this time,
+no other users may check out the file whilst it is locked.
+.Pp
+.Nm
+also supports
+keyword substitution \(en
+see the
 .Xr cvs 1
-for more information).
+man page for more information.
 .Pp
 The following options are supported:
 .Bl -tag -width Ds