Re: wget on gnu.org: Report a Bug

2007-07-07 Thread Micah Cowan
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA256

Micah Cowan wrote:
> Tony Lewis wrote:
>> The “Report a Bug” section of http://www.gnu.org/software/wget/ should
>> encourage submitters to send as much relevant information as possible
>> including wget version, operating system, and command line. The
>> submitter should also either send or at least save a copy of the --debug
>> output.
> 
> This information is currently in the bug submitting form at Savannah:
> https://savannah.gnu.org/bugs/?func=additem&group=wget
> 
> But should probably be duplicated at the website as well... let me know
> if the current text could use improvement.

I've copied the text to the website, along with a link to Simon Tatham's
essay on reporting bugs.

I also added a small section regarding the IRC #wget channel on FreeNode.

- --
Micah J. Cowan
Programmer, musician, typesetting enthusiast, gamer...
http://micah.cowan.name/

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGkDhh7M8hyUobTrERCDBQAJ4ln3eWsbdbsa5ahfB7kv5tHIc1wACeLSIj
uXkezPuzt7GMoiXvUemMT9U=
=2dVK
-END PGP SIGNATURE-


RE: wget on gnu.org: Report a Bug

2007-07-07 Thread Tony Lewis
Micah Cowan wrote:

> This information is currently in the bug submitting form at Savannah:

That looks good.

> I think perhaps such things as the wget version and operating system
> ought to be emitted by default anyway (except when -q is given).

I'm not convinced that wget should ordinarily emit the operating system. It's 
really only useful to someone other than the person running the command.

> Other than that, what kinds of things would --bug provide above and
> beyond --debug?

It should echo the command line and the contents of .wgetrc to the bug output, 
which even the --debug option does not do. Perhaps we will think of other 
things to include in the output if this option gets added.

However, the big difference would be where the output was directed. When 
invoked as:
wget ... --bug bug_report

all interesting (but sanitized) information would be written to the file 
bug_report whether or not the command included --debug, which would also direct 
the debugging output to STDOUT.

The main reason I had for suggesting this option is that it would be easy to 
tell newbies with problems to run the exact same command with "--bug 
bug_report" and send the file bug_report to the list (or to whomever is working 
on the problem). The user wouldn't see the command behave any differently, but 
we'd have the information we need to investigate the report.

It might even be that most of us would choose to run with --bug most of the 
time relying on the normal wget output except when something appears to have 
gone wrong and then checking the file when it does.

Tony



Re: wget on gnu.org: Report a Bug

2007-07-07 Thread Micah Cowan
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA256

Tony Lewis wrote:
> The “Report a Bug” section of http://www.gnu.org/software/wget/ should
> encourage submitters to send as much relevant information as possible
> including wget version, operating system, and command line. The
> submitter should also either send or at least save a copy of the --debug
> output.

This information is currently in the bug submitting form at Savannah:
https://savannah.gnu.org/bugs/?func=additem&group=wget

But should probably be duplicated at the website as well... let me know
if the current text could use improvement.

> Perhaps we need a --bug option for the command line that runs the
> command and saves important information in a file that can be submitted
> along with the bug report. The saved information would have to be
> sanitized to remove things like user IDs and passwords but could include
> things like the wget version, command line options, and what the command
> tried to do.

I think perhaps such things as the wget version and operating system
ought to be emitted by default anyway (except when -q is given).

Other than that, what kinds of things would --bug provide above and
beyond --debug?

- --
Micah J. Cowan
Programmer, musician, typesetting enthusiast, gamer...
http://micah.cowan.name/

-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGj+hk7M8hyUobTrERCHqtAJ9HTIFd3hOJ2R9aQBUqCtsvW2xJ1wCePOfo
67Olfti9HtI+1pYkNiCj7rc=
=/Rhd
-END PGP SIGNATURE-