bugGNU Wget - Bugs: bug #45732, Please document --ask-password in...

 
 

bug #45732: Please document --ask-password in manual section 2.1

Submitted by:  Reuben Thomas <rrt>
Submitted on:  Tue 11 Aug 2015 10:42:18 AM UTC  
 
Category: DocumentationSeverity: 3 - Normal
Priority: 5 - NormalStatus: Needs Discussion
Privacy: PublicAssigned to: None
Originator Name: Open/Closed: Closed
Release: 1.16.3Operating System: None
Reproducibility: NoneFixed Release: None
Planned Release: NoneRegression: None
Work Required: NonePatch Included: None

Add a New Comment(Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Tue 18 Aug 2015 02:45:28 PM UTC, comment #3:

That makes more sense. However, there's more than one way of doing this.

Wget also supports reading from a user's netrc file. If we start mentioning everything in there, the section will quickly degenerate into a different topic. This is mentioned as a footnote.

I think could however add a note there asking the user to refer to se3ction 2.5 which contains more information about password handling. Maybe, if someone is willing, we can also have an entire section on password handling mechanisms and workarounds.

Darshit Shah <darnir>
Project Administrator
Mon 17 Aug 2015 04:51:04 PM UTC, comment #2:

Sorry, I think I was not clear in my request.

I am not suggesting that --ask-password should be fully documented in section 2.1, just that there should be a cross-reference from section 2.1 to section 2.5. The reason is that currently section 2.1 gives the impression that the only options are either to supply the password in the URL, or to use 'wget -i -' and supply the password to stdin. In fact, this latter trick is not needed (at least, for interactive use); instead, --ask-password can be used.

Perhaps it would be good to mention --ask-password instead of the 'wget -i -' trick, for example?

Reuben Thomas <rrt>
Sat 15 Aug 2015 07:01:56 AM UTC, comment #1:

Section 2.1 of the manual is the URL format. The --ask-password option does not concern the URL Format and hence it is not required to be mentioned there.

The --ask-password option has already been correctly documented in Section 2.5, Download Options.

Darshit Shah <darnir>
Project Administrator
Tue 11 Aug 2015 10:42:18 AM UTC, original submission:

Reading just that section suggests there's no way to supply a password other than in the URL.

Reuben Thomas <rrt>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach File(s):
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by darnir (Posted a comment)
  • -unavailable- added by rrt (Submitted the item)
  •  

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 3 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Tue 18 Aug 2015 02:45:28 PM UTCdarnirStatusInvalid=>Needs Discussion
    Sat 15 Aug 2015 07:11:47 AM UTCdarnirOpen/ClosedOpen=>Closed
    Sat 15 Aug 2015 07:01:56 AM UTCdarnirStatusNone=>Invalid

    Back to the top


    Powered by Savane 3.1-cleanup1