Re: coreutils FAQ link in manpages and/or --help output

[Pádraig Brady]

On 02/25/2013 02:53 PM, Ondrej Oprala wrote:
> Hi,
> to reduce the amount of questions about date, sort and anything 
> multibyte-related, I think
> it'd be a good idea to add a link to the coreutils FAQ to the man pages 
> (and/or --help output), maybe something like
> "Report TOOL bugs to address@hidden but please make sure the behaviour is not 
> listed in FAQ: link"
> What do you think?

There are already too many links in --help for each command:

$ truncate --help | tail -n4
Report truncate bugs to address@hidden
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
General help using GNU software: <http://www.gnu.org/gethelp/>
For complete documentation, run: info coreutils 'truncate invocation'

How about we assume people have a web browser and instead have:

$ truncate --help | tail -n4
GNU coreutils online help: <http://www.gnu.org/software/coreutils/#help>
For complete documentation, run: info coreutils 'truncate invocation'

Then the "online help section" can verbosely list,
bug email, faq, online manual, ... without restrictions to screen width etc.

cheers,
Pádraig.