bug-wget
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: Tom Mizutani
Subject: [Bug-wget] --random-wait command-line option: inconsistency in documents
Date: Fri, 18 Jun 2010 21:08:53 +0900

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,



reply via email to

[Prev in Thread] Current Thread [Next in Thread]