bug-gnu-utils
[Top][All Lists]
Advanced

[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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]