Re: Incomplete man page on wget
Sure - I understand that info is the preferred documentation for GNU, no problem there, but this is not going to be widely known to people who have grown up on --help and man, so there is a responsibility to let it be known IN MOST PEOPLE'S DEFAULT where to get the prefered documentation. I would have a similar response to people who prefer to put the documentation online (e.g. php). There needs to be a pointer in the obvious places to lead people to the non-obvious places. You can't assume that people know that GNU => Info. - Mitra At 12:12 AM +0200 17/9/03, Hrvoje Niksic wrote: Mitra <[EMAIL PROTECTED]> writes: Hi, Thanks for the response. I've never used Info before, except for documentation of emacs and very few things are documented there. I suggest it should be presumed that people will look at "man wget" or "wget --help" and make sure the documentation is either the same, or that there is a level of indirection to "info wget" You are right. The current man page does not seem to mention that it is only an excerpt from the entire documentation, and that is a bug. As for Info, note that Wget is a GNU program, and Info is the preferred documentation format of the GNU project. -- Mitra Technology Consulting - www.mitra.biz - [EMAIL PROTECTED] home 02-6684-8096 mobile 0414-648-722 office 02-6684-6182 Byron Community Knowledge Management Project www.byronkm.com Life is a Mystery to be Lived, not a Problem to be Solved
Re: Incomplete man page on wget
Mitra <[EMAIL PROTECTED]> writes: > Hi, > > Thanks for the response. > > I've never used Info before, except for documentation of emacs and > very few things are documented there. I suggest it should be > presumed that people will look at "man wget" or "wget --help" and > make sure the documentation is either the same, or that there is a > level of indirection to "info wget" You are right. The current man page does not seem to mention that it is only an excerpt from the entire documentation, and that is a bug. As for Info, note that Wget is a GNU program, and Info is the preferred documentation format of the GNU project.
Re: Incomplete man page on wget
Hi, Thanks for the response. I've never used Info before, except for documentation of emacs and very few things are documented there. I suggest it should be presumed that people will look at "man wget" or "wget --help" and make sure the documentation is either the same, or that there is a level of indirection to "info wget" - Mitra At 12:39 PM +0200 16/9/03, Hrvoje Niksic wrote: Mitra <[EMAIL PROTECTED]> writes: The wget man page reports --proxy=on/off Turn proxy support on or off. The proxy is on by default if the appropriate environmental variable is defined. Which is of course incomplete as it doesn't say WHAT the appropriate environmental variable is! Thanks for the report. Note that the real Wget documentation is in Info format. The Info manual names the proxy environment variables in the "Proxies" node. -- Mitra Technology Consulting - www.mitra.biz - [EMAIL PROTECTED] home 02-6684-8096 mobile 0414-648-722 office 02-6684-6182 Byron Community Knowledge Management Project www.byronkm.com Life is a Mystery to be Lived, not a Problem to be Solved
Re: Incomplete man page on wget
Mitra <[EMAIL PROTECTED]> writes: > The wget man page reports > > --proxy=on/off > Turn proxy support on or off. The proxy is on by > default if the appropriate environmental variable is > defined. > > Which is of course incomplete as it doesn't say WHAT the appropriate > environmental variable is! Thanks for the report. Note that the real Wget documentation is in Info format. The Info manual names the proxy environment variables in the "Proxies" node.
Incomplete man page on wget
The wget man page reports --proxy=on/off Turn proxy support on or off. The proxy is on by default if the appropriate environmental variable is defined. Which is of course incomplete as it doesn't say WHAT the appropriate environmental variable is! - Mitra -- Mitra Technology Consulting - www.mitra.biz - [EMAIL PROTECTED] home 02-6684-8096 mobile 0414-648-722 office 02-6684-6182 Byron Community Knowledge Management Project www.byronkm.com Life is a Mystery to be Lived, not a Problem to be Solved