Re: gnupload --help examples

[Ralf Wildenhues]

Hi Karl,

* Karl Berry wrote on Fri, Nov 27, 2009 at 04:25:37PM CET:
> First, all the existing examples in gnupload --help use automake 1.8.2b.
> This isn't either of rms' recommended version number schemes for test
> releases.  Would you agree to changing to something generic, like
> foobar-0.9.90?  I'm happy to send a patch if you like, although of
> course it is a trivial text change.

Sure.  These numbers were real Automake versions though, so maybe we
want to genericize the package name as well?

> Second, I don't understand the point of having both examples 2 and 3.
> If I am maintaining foo-latest symlinks, then surely I would want them
> for all releases on all sites.  So how about just dropping #2?  I also
> don't understand (from the help message) why #3 accomplishes this and #2
> doesn't.
> 
> For reference, here are the two examples:
> 
>     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:
> 
>       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

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

Feel free to propose a patch that makes this more clear.  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.

Thanks,
Ralf