You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by es...@thyrsus.com on 2003/12/09 19:29:09 UTC

problems in one or more man pages you maintain

(My apologies if you get this twice.  My first run of sends had a bug.)

This is automatically generated email about problems in a man page for which
you appear to be responsible.  If you are not the right person or list, tell
me and I will attempt to correct my database.

See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.

Problems with svn.1:
1. Unknown or invalid macro.  That is, one that does not fit in the
macro set that the man page seems to be using.  This is a serious
error; it often means part of your text is being lost or rendered
incorrectly.

--- svn.1-orig	2003-11-26 12:21:54.000000000 -0500
+++ svn.1	2003-11-26 12:22:53.000000000 -0500
@@ -273,7 +273,7 @@
 WCPATH is the working-copy path that will receive the changes.
 If omitted, a default value of '.' is assumed.  If PATH2 is omitted the revision
 option must be passed to identify two versions of PATH1, for example:
-.SP
+.sp
 .in +0.2i
 .ft B
 .nf
@@ -281,7 +281,7 @@
 .fi
 .ft P
 .in -0.2i
-.SP
+.sp
 
 .TP
 \fBmkdir\fP [\fIdirectory...\fP] [\fI--username name\fP] [\fI--password pass\fP] [\fI--no-auth-cache\fP] [\fI--encoding\fP] [\fI-mFq\fP]
@@ -344,7 +344,7 @@
 .IP svn:externals 
 A newline separated list of module specifiers, each of which consists of a
 relative directory path, optional revision flags, and an URL.  For example :
-.SP
+.sp
 .in +0.2i
 .ft B
 .nf
@@ -353,7 +353,7 @@
 .fi
 .ft P
 .in -0.2i
-.SP
+.sp
 .RE
 .TP
 \fBrevert\fP [\fIfile\fP\|.\|.\|.] [\fI--targets file\fP] [\fI-Rq\fP]
Problems with svnadmin.1:
1. Unknown or invalid macro.  That is, one that does not fit in the
macro set that the man page seems to be using.  This is a serious
error; it often means part of your text is being lost or rendered
incorrectly.

--- svnadmin.1-orig	2003-11-26 12:23:34.000000000 -0500
+++ svnadmin.1	2003-11-26 12:23:43.000000000 -0500
@@ -21,7 +21,7 @@
 .IR repos-path .
 For example, a repository can be created with the command:
 
-.SP
+.sp
 .in +1i
 .ft B
 .nf
@@ -29,14 +29,14 @@
 .fi
 .ft P
 .in -1i
-.SP
+.sp
 
 Importing a source tree into the repository created above is possible
 with the 
 .BR svn (1)
 command :
 
-.SP
+.sp
 .in +1i
 .ft B
 .nf
@@ -44,7 +44,7 @@
 .fi
 .ft P
 .in -1i
-.SP
+.sp
 .TP
 .BI createtxn " repos-path \-rbase_rev"
 Create a new transaction based on

--
                             Eric S. Raymond

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by Greg Hudson <gh...@MIT.EDU>.
On Wed, 2003-12-10 at 13:23, Ben Collins-Sussman wrote:
> Argh.  I bet Fedora is going to get a *lot* more attention now.  RedHat9
> ships with a Subversion that's nearly a year old.  I wonder if that same
> ancient package is in Fedora.  I think we need a real maintainer now,
> someone who can keep Fedora's Subversion rpms up-to-date.

Fedora Core 1 shipped with svn 0.32.1.

(I'd be happier if they didn't ship anything before svn 1.0 is out, but
they are keeping reasonably current, so no need to lose sleep at night.)


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by "Eric S. Raymond" <es...@thyrsus.com>.
Ben Collins-Sussman <su...@collab.net>:
> Argh.  I bet Fedora is going to get a *lot* more attention now.  RedHat9
> ships with a Subversion that's nearly a year old.  I wonder if that same
> ancient package is in Fedora.  I think we need a real maintainer now,
> someone who can keep Fedora's Subversion rpms up-to-date.

Yes, I think you do.  I expect that Fedora is going to eat all the other 
RPM-based distributions alive and give the Debian people big troubles.
The combination of wins they have going will be very hard to compete against:
(1) apt-get, (2) the most popular binary-package format, (3) the Red 
Hat name.
-- 
		<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by Ben Collins-Sussman <su...@collab.net>.
On Wed, 2003-12-10 at 12:19, Eric S. Raymond wrote:
> kfogel@collab.net <kf...@collab.net>:
> > Er, okay, but it's not pending, it's solved, as far as we're
> > concerned.  The version of Subversion shipped with Red Hat 9 is so far
> > behind modern Subversion that you need space-based telescopy just to
> > see it from here...  (And since Red Hat is not releasing another
> > distribution in that line anyway, I'm not sure what would ever make
> > this issue get out of the "pending" state.)
> 
> When I see it in an apt-get update from the Fedora repository, basically.
> I run Fedora Core 1 with *everything* installed and do daily updates;
> my predicate for when something hits the streeet is when it shows up
> in my bitstream.

Argh.  I bet Fedora is going to get a *lot* more attention now.  RedHat9
ships with a Subversion that's nearly a year old.  I wonder if that same
ancient package is in Fedora.  I think we need a real maintainer now,
someone who can keep Fedora's Subversion rpms up-to-date.



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by "Eric S. Raymond" <es...@thyrsus.com>.
kfogel@collab.net <kf...@collab.net>:
> Er, okay, but it's not pending, it's solved, as far as we're
> concerned.  The version of Subversion shipped with Red Hat 9 is so far
> behind modern Subversion that you need space-based telescopy just to
> see it from here...  (And since Red Hat is not releasing another
> distribution in that line anyway, I'm not sure what would ever make
> this issue get out of the "pending" state.)

When I see it in an apt-get update from the Fedora repository, basically.
I run Fedora Core 1 with *everything* installed and do daily updates;
my predicate for when something hits the streeet is when it shows up
in my bitstream.
-- 
		<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by kf...@collab.net.
"Eric S. Raymond" <es...@thyrsus.com> writes:
> > These do not appear to suffer from the above problem (they also
> > contain far less information as they now simply refer to the builtin
> > documentation and to the Subversion book).
> 
> Hm.  They're what shipped in Red Hat 9.
> 
> I'll mark this "pending", then.

Er, okay, but it's not pending, it's solved, as far as we're
concerned.  The version of Subversion shipped with Red Hat 9 is so far
behind modern Subversion that you need space-based telescopy just to
see it from here...  (And since Red Hat is not releasing another
distribution in that line anyway, I'm not sure what would ever make
this issue get out of the "pending" state.)

Best,
-Karl

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by "Eric S. Raymond" <es...@thyrsus.com>.
Philip Martin <ph...@codematters.co.uk>:
> You are using old, unmaintained versions of the man pages.  More
> recent versions are available, for example 
> 
> http://svn.collab.net/repos/svn/tags/0.34.0/subversion/clients/cmdline/svn.1
> http://svn.collab.net/repos/svn/tags/0.34.0/subversion/svnadmin/svnadmin.1
> 
> These do not appear to suffer from the above problem (they also
> contain far less information as they now simply refer to the builtin
> documentation and to the Subversion book).

Hm.  They're what shipped in Red Hat 9.

I'll mark this "pending", then.
-- 
		<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: problems in one or more man pages you maintain

Posted by Philip Martin <ph...@codematters.co.uk>.
esr@thyrsus.com writes:

> --- svn.1-orig	2003-11-26 12:21:54.000000000 -0500
> +++ svn.1	2003-11-26 12:22:53.000000000 -0500
> @@ -273,7 +273,7 @@
>  WCPATH is the working-copy path that will receive the changes.
>  If omitted, a default value of '.' is assumed.  If PATH2 is omitted the revision
>  option must be passed to identify two versions of PATH1, for example:
> -.SP
> +.sp

You are using old, unmaintained versions of the man pages.  More
recent versions are available, for example 

http://svn.collab.net/repos/svn/tags/0.34.0/subversion/clients/cmdline/svn.1
http://svn.collab.net/repos/svn/tags/0.34.0/subversion/svnadmin/svnadmin.1

These do not appear to suffer from the above problem (they also
contain far less information as they now simply refer to the builtin
documentation and to the Subversion book).

-- 
Philip Martin

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org