Re: gnupload --help examples

[Karl Berry]

    Sure.  These numbers were real Automake versions though, 

I know.

    want to genericize the package name as well?

Yep, that's what I meant to suggest.

    --symlink also allows you to pass target names other than
    *-latest.tar.gz I guess, so #2 shows how --symlink-regex works while
    #3 shows how --symlink works?

I see.  But since the examples are equivalent, it's not a very
interesting thing to show for --symlink.  I think the examples should be
practical, not theoretical.

I guess I don't see the point in explaining --symlink, since
--symlink-regex already does what's desired, if symlinks are desired at
all.  It's not like we are duty-bound to show an example for every
option.  There are plenty of options already without examples.

Also, I think that a separate example should show uploading multiple
formats, instead of throwing it in with all the test uploads.  In
general, I think all the examples should try to show just one new thing,
not many things mixed together.

I altered the last example to be about a mistaken upload, instead of
retiring an existing release.  In general, it seems to me that we don't
want to suggest that it's a good idea to delete test (or any) releases.
I also didn't see any purpose to the "--" here, so I removed it.

  0. Upload foobar-1.0.tar.gz to ftp.gnu.org:gnu/foobar
    gnupload --to ftp.gnu.org:foobar foobar-1.0.tar.gz

Indeed, just goes to show why simple examples, and testing, are needed :).

    Feel free to propose a patch that makes this more clear.  

See below for my new text.  If you want a patch instead, that's fine, I
just thought this would be easier to read.

    If you know of a painless way to test these options, then I'm all
    ears.  I'm a big fan of testing all code.

I know of no easy (or even not so easy) way to test anything related to
ftp uploads, especially not with hypothetical package names and versions :(.
I think this is one case where you just have to take it
on faith/inspection and let users report the problems when they actually
try to instantiate them.

Thanks,
k

--------------------------------------------------
1. Upload foobar-1.0.tar.gz to ftp.gnu.org:
  gnupload --to ftp.gnu.org:foobar foobar-1.0.tar.gz

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

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:
  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