Re: [Bug-wget] --random-wait command-line option: inconsistency in documents

[Giuseppe Scrivano]

Thanks for your report!  I have updated the help string for
--random-wait.

Cheers,
Giuseppe



Tom Mizutani <address@hidden> writes:

> I recently look into Wget documentations and found the
> specification of "--random-wait" option seems to have been
>  changed, but not explicitly announced in "ChangeLog"s.
> To make things worse, help messages included
>  in src/main.c  and po/*.po are obsolete.
>
> I suggest to update main.c and *.po files and show changes
> in --random-wait option explicitly in ChangeLogs.
>
> In the latest version Wget 1.12, doc/wget.texi, which comes
>  with http://ftp.gnu.org/pub/gnu/wget/wget-1.12.tar.lzma, says:
>>This option causes the time between requests
>>to vary between 0.5 and 1.5 * wait seconds...
> It was changed from what I knew.
>
> I dug into GNU archives and found that doc/wget.texi included
>  in http://ftp.gnu.org/pub/gnu/wget-1.10.2.tar.gz says;
>>This option causes the time between requests
>>to vary between 0 and 2 * wait seconds...
>
> I also found a comment in src/retr.c of version 1.10.2 says:
> /* Sleep a random amount of time averaging in opt.wait
>   seconds.  The sleeping amount ranges from 0 to
>   opt.wait*2, inclusive.  */
> and comments in src/retr.c in versions 1.11.1 and 1.12 say:
> /* Sleep a random amount of time averaging in opt.wait
>   seconds.  The sleeping amount ranges from 0.5*opt.wait to
>   1.5*opt.wait.  */
>
> On the other hand, help messages in src/main.c
> in Wget-1.12 archive still says:
>>--random-wait             wait from 0...2*WAIT secs >between retrievals
> and corresponding messages in *.po files say such
> (All I understand is en_US.po,en_GB.po,ja.po, though).
>
> This inconsistency is confusing and the help message
> should be updated.  I also suggest the changes should be
> reflected in the ChangeLog file.
>
> Regards,