flesh out the description of ci; ok xsa

1 files changed, 33 insertions, 2 deletions

diff --git a/usr.bin/rcs/ci.1 b/usr.bin/rcs/ci.1
index a7c0822aeb7..bddbc175d6f 100644
--- a/usr.bin/rcs/ci.1
+++ b/usr.bin/rcs/ci.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ci.1,v 1.25 2006/03/06 09:41:53 deraadt Exp $
+.\"	$OpenBSD: ci.1,v 1.26 2006/04/19 10:49:41 jmc Exp $
 .\"
 .\" Copyright (c) 2005 Niall O'Higgins <niallo@openbsd.org>
 .\" All rights reserved.
@@ -41,13 +41,44 @@
 .Op Fl u Ns Op Ar rev
 .Op Fl w Ns Ar username
 .Op Fl x Ns Ar suffixes
-.Ar file ...
+.Ar
 .Ek
 .Sh DESCRIPTION
 The
 .Nm
 program is used to check in new revisions to RCS files.
 .Pp
+When a file is checked in,
+it is stored in the RCS directory with a specific revision number,
+and the original file itself is deleted.
+The RCS file is stored with the same name, but with
+.Sq ,v
+appended.
+.Nm
+will prompt for a check-in message,
+to be stored with the file,
+which can be displayed using
+.Xr rlog 1 .
+.Pp
+Revision numbering starts at 1.1
+and increases logically.
+Numbering can be altered using the
+.Fl k
+option, however.
+The
+.Sq ,v
+suffix can also be altered,
+using the
+.Fl x
+option.
+.Pp
+.Nm
+also supports
+keyword substitution \(en
+see the
+.Xr cvs 1
+man page for more information.
+.Pp
 The following options are supported:
 .Bl -tag -width Ds
 .It Fl d Ns Op Ar date