Re: gnupload --help examples

[Ralf Wildenhues]

* Karl Berry wrote on Sat, Nov 28, 2009 at 11:46:40PM CET:
>     Erm, the --rmsymlink and --delete options work on all remaining files up
>     to the net --rmsymlink, --delete, or -- option.  So that -- really needs
>     to be there.  Or we need to change the semantics of these optinos.
> 
> Ok, my mistake.  I think that should be pointed out explicitly.
> (See below.)

Thanks, that's a good idea.

>     Kind of thinking that all GNU developers should
>     be able to test upload functionality there.
> 
> That would be ideal, but it seems like a major departure from the way
> uploads work now.  I don't want to ask the FSF sysadmins to devote time
> to such an idea.

OK.

> However, it occurs to me that we can ask Sergey if he could easily set
> up such a thing at his hosting site.  I'll do that.

Great!

>     It's more of a question whether the work required to actually make
>     it work exceeds the potential benefits.
> 
> Indeed.  Anyway, let's not wait to push the new help message, ok?

Yes.  I've queued the patch below to the 'maint' branch, to be merged to
branch-1.11 and master soonish (later tonight).

> By the way, is there any documentation anywhere beyond the help message?
> (I'm not volunteering, just wondering. :)

Not yet, but it would be a good idea.

Thanks,
Ralf

2009-11-29  Karl Berry  <address@hidden>

        Rewrite `gnupload --help' examples.
        * lib/gnupload: Use GNU style version numbers, a generic package
        name, and more useful examples.

diff --git a/lib/gnupload b/lib/gnupload
index 8320b58..104f8ad 100755
--- a/lib/gnupload
+++ b/lib/gnupload
@@ -1,7 +1,7 @@
 #!/bin/sh
 # Sign files and upload them.
 
-scriptversion=2009-04-28.21; # UTC
+scriptversion=2009-11-29.20; # UTC
 
 # Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation
 #
@@ -73,34 +73,28 @@ actual command line options.  Use this to keep your 
defaults.  Comments
 (#) and empty lines in $conffile are allowed.
 
 Examples:
-1. Upload automake-1.8.2b.tar.gz and automake-1.8.2b.tar.bz2 to two sites:
-  gnupload --to sources.redhat.com:~ftp/pub/automake \\
-           --to alpha.gnu.org:automake \\
-           automake-1.8.2b.tar.gz automake-1.8.2b.tar.bz2
-
-2. Same as above, but also create symbolic links to automake-latest.tar.*:
-  gnupload --to sources.redhat.com:~ftp/pub/automake \\
-           --to alpha.gnu.org:automake \\
-           --symlink-regex \\
-           automake-1.8.2b.tar.gz automake-1.8.2b.tar.bz2
-
-3. Symlink automake-1.8.2b.tar.gz to automake-latest.tar.gz and
-automake-1.8.2b.tar.bz2 to automake-latest.tar.bz2 on both sites:
+1. Upload foobar-1.0.tar.gz to ftp.gnu.org:
+  gnupload --to ftp.gnu.org:foobar foobar-1.0.tar.gz
 
-  gnupload --to sources.redhat.com:~ftp/pub/automake \\
-           --to alpha.gnu.org:automake \\
-           --symlink automake-1.8.2b.tar.gz automake-latest.tar.gz \\
-                     automake-1.8.2b.tar.bz2 automake-latest.tar.bz2
+2. Upload foobar-1.0.tar.gz and foobar-1.0.tar.xz to ftp.gnu.org:
+  gnupload --to ftp.gnu.org:foobar foobar-1.0.tar.gz foobar-1.0.tar.xz
 
-4. Delete automake-1.8.2a.tar.gz and .bz2, remove symlink
-automake-latest.tar.gz and upload automake-1.8.2b.tar.gz:
-
-  gnupload --to sources.redhat.com:~ftp/pub/automake \\
-           --to alpha.gnu.org:automake \\
-           --delete automake-1.8.2a.tar.gz automake-1.8.2a.tar.bz2 \\
-           --rmsymlink automake-latest.tar.gz \\
-           -- \\
-           automake-1.8.2b.tar.gz automake-1.8.2b.tar.bz2
+3. Same as above, and also create symbolic links to foobar-latest.tar.*:
+  gnupload --to ftp.gnu.org:foobar \\
+           --symlink-regex \\
+           foobar-1.0.tar.gz foobar-1.0.tar.xz
+
+4. Upload foobar-0.9.90.tar.gz to two sites:
+  gnupload --to alpha.gnu.org:foobar \\
+           --to sources.redhat.com:~ftp/pub/foobar \\
+           foobar-0.9.90.tar.gz
+
+5. Delete oopsbar-0.9.91.tar.gz and upload foobar-0.9.91.tar.gz
+   (the -- terminates the list of files to delete):
+  gnupload --to alpha.gnu.org:foobar \\
+           --to sources.redhat.com:~ftp/pub/foobar \\
+           --delete oopsbar-0.9.91.tar.gz \\
+           -- foobar-0.9.91.tar.gz
 
 Report bugs to <address@hidden>.
 Send patches to <address@hidden>."