[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Problems omn the co.1 man page
From: |
Eric S. Raymond |
Subject: |
Problems omn the co.1 man page |
Date: |
Fri, 26 Jul 2002 12:52:03 -0400 |
Please pass this to the RCS maintainers. I can't find a bug address
for that project.
This patch fixes some dubious troff and conversts .in/.ta markup to
tables. The purpose is to facilitate automatic translationj to DocBook.
--- co.1 2002/07/26 13:52:47 1.1
+++ co.1 2002/07/26 14:05:30
@@ -87,7 +87,7 @@
always performs keyword substitution (see below).
.SH OPTIONS
.TP
-.BR \-r [\f2rev\fP]
+.BR \-r [\fIrev\fP]
retrieves the latest revision whose number is less than or equal to
.IR rev .
If
@@ -126,13 +126,13 @@
and
.BR rcs (1).
.TP
-.BR \-l [\f2rev\fP]
+.BR \-l [\fIrev\fP]
same as
.BR \-r ,
except that it also locks the retrieved revision for
the caller.
.TP
-.BR \-u [\f2rev\fP]
+.BR \-u [\fIrev\fP]
same as
.BR \-r ,
except that it unlocks the retrieved revision if it was
@@ -143,7 +143,7 @@
retrieves the revision locked by the caller, if there is one; otherwise,
it retrieves the latest revision on the default branch.
.TP
-.BR \-f [\f2rev\fP]
+.BR \-f [\fIrev\fP]
forces the overwriting of the working file;
useful in connection with
.BR \-q .
@@ -246,17 +246,17 @@
to edit the file later, check it out again without
.BR \-kv .
.TP
-.BR \-p [\f2rev\fP]
+.BR \-p [\fIrev\fP]
prints the retrieved revision on the standard output rather than storing it
in the working file.
This option is useful when
.B co
is part of a pipe.
.TP
-.BR \-q [\f2rev\fP]
+.BR \-q [\fIrev\fP]
quiet mode; diagnostics are not printed.
.TP
-.BR \-I [\f2rev\fP]
+.BR \-I [\fIrev\fP]
interactive mode;
the user is prompted and questioned
even if the standard input is not a terminal.
@@ -275,25 +275,20 @@
are equivalent
if local time is January 11, 1990, 8pm Pacific Standard Time,
eight hours west of Coordinated Universal Time (\*u):
-.RS
.LP
-.RS
-.nf
-.ta \w'\f3Thu, 11 Jan 1990 20:00:00 \-0800\fP 'u
-.ne 10
-\f38:00 pm lt\fP
-\f34:00 AM, Jan. 12, 1990\fP default is \*u
-\f31990-01-12 04:00:00+00\fP \*i 8601 (\*u)
-\f31990-01-11 20:00:00\-08\fP \*i 8601 (local time)
-\f31990/01/12 04:00:00\fP traditional \*r format
-\f3Thu Jan 11 20:00:00 1990 LT\fP output of \f3ctime\fP(3) + \f3LT\fP
-\f3Thu Jan 11 20:00:00 PST 1990\fP output of \f3date\fP(1)
-\f3Fri Jan 12 04:00:00 GMT 1990\fP
-\f3Thu, 11 Jan 1990 20:00:00 \-0800\fP Internet RFC 822
-\f312-January-1990, 04:00 WET\fP
-.ta 4n +4n +4n +4n
-.fi
-.RE
+.TS
+l l l.
+\fB8:00 pm lt\fP
+\fB4:00 AM, Jan. 12, 1990\fP default is \*u
+\fB1990-01-12 04:00:00+00\fP \*i 8601 (\*u)
+\fB1990-01-11 20:00:00\-08\fP \*i 8601 (local time)
+\fB1990/01/12 04:00:00\fP traditional \*r format
+\fBThu Jan 11 20:00:00 1990 LT\fP output of \fBctime\fP(3) + \fBLT\fP
+\fBThu Jan 11 20:00:00 PST 1990\fP output of \fBdate\fP(1)
+\fBFri Jan 12 04:00:00 GMT 1990\fP
+\fBThu, 11 Jan 1990 20:00:00 \-0800\fP Internet RFC 822
+\fB12-January-1990, 04:00 WET\fP
+.TE
.LP
Most fields in the date and time can be defaulted.
The default time zone is normally \*u, but this can be overridden by the
@@ -314,7 +309,7 @@
The date/time must be quoted if it contains spaces.
.RE
.TP
-.BR \-M [\f2rev\fP]
+.BR \-M [\fIrev\fP]
Set the modification time on the new working file
to be the date of the retrieved revision.
Use this option with care; it can confuse
@@ -334,7 +329,7 @@
i.e. when the change of lock
would mean a change to keyword strings in the other working file.
.TP
-.BR \-w [\f2login\fP]
+.BR \-w [\fIlogin\fP]
retrieves the latest revision on the selected branch which was checked in
by the user with login name
.IR login .
@@ -494,19 +489,13 @@
For example, if local time is January 11, 1990, 8pm Pacific Standard Time,
eight hours west of \*u,
then the time is output as follows:
-.RS
-.LP
-.RS
-.nf
-.ta \w'\f3\-z+05:30\fP 'u +\w'\f31990-01-11 09:30:00+05:30\fP 'u
-.ne 4
-\f2option\fP \f2time output\fP
-\f3\-z\fP \f31990/01/12 04:00:00\fP \f2(default)\fP
-\f3\-zLT\fP \f31990-01-11 20:00:00\-08\fP
-\f3\-z+05:30\fP \f31990-01-12 09:30:00+05:30\fP
-.ta 4n +4n +4n +4n
-.fi
-.RE
+.TS
+l l l.
+\fIoption\fP \fItime output\fP
+\fB\-z\fP \fB1990/01/12 04:00:00\fP \fI(default)\fP
+\fB\-zLT\fP \fB1990-01-11 20:00:00\-08\fP
+\fB\-z+05:30\fP \fB1990-01-12 09:30:00+05:30\fP
+.TE
.LP
The
.B \-z
@@ -604,13 +593,12 @@
.RS
.LP
.nf
-.ft 3
-.ne 3
+.ft CW
+
/\(**
-.in +\w'/'u
-\(** $\&Log$
-\(**/
-.in
+ \(** $\&Log$
+ \(**/
+
.ft
.fi
.RE
@@ -658,18 +646,15 @@
The following characters in keyword values are represented by escape sequences
to keep keyword strings well-formed.
.LP
-.RS
-.nf
-.ne 6
-.ta \w'newline 'u
-\f2char escape sequence\fP
-tab \f3\et\fP
-newline \f3\en\fP
-space \f3\e040
+.TS
+l l l.
+\fIchar escape sequence\fP
+tab \fB\et\fP
+newline \fB\en\fP
+space \fB\e040
$ \e044
\e \e\e\fP
-.fi
-.RE
+.TE
.SH "FILE MODES"
The working file inherits the read and execute permissions from the \*r
file. In addition, the owner write permission is turned on, unless
--
<a href="http://www.tuxedo.org/~esr/">Eric S. Raymond</a>
"Since there is no such entity as 'the public,' since the public is merely a
number of individuals, the idea that 'the public interest' supersedes private
interests and rights can have but one meaning: that the interests and rights of
some individuals take precedence over the interests and rights of others."
-- Ayn Rand
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- Problems omn the co.1 man page,
Eric S. Raymond <=