Bug#760861: bug#18428: Bug#760861: bug#18428: Bug#760861: bug#18428: coreutils binary breaks coreutils documentation
On 09/09/2014 10:52 AM, Michael Stone wrote: On Tue, Sep 09, 2014 at 03:31:35PM +0100, Pádraig Brady wrote: It's useful to many, but I agree most don't bother with it due to the awkward non intuitive default info reader _interface_ (though pinfo is a bit better in that regard). Right. I've heard the argument for 15 years that info docs are really good, it's just the interface. :) In all that time, a better interface hasn't really caught on, and the web happened. Though it would be better to have direct links. Now the above full node URL is too long/awkward, so I've just now setup redirects, so the following proposed new trailers for ls --help and man pages should work: ls --help: ... Full documentation online at: http://www.gnu.org/software/coreutils/ls Full installed documentation: info '(coreutils) ls invocation' A huge improvement. I suspect that this might also help the info docs show up in google, instead of being below the fold. Alternative wording: Full documentation online at: http://www.gnu.org/software/coreutils/ls or available locally via: info '(coreutils) ls invocation' BTW, http://gnu.org/s/; redirects to http://www.gnu.org/software/; , so http://gnu.org/s/coreutils/ls also works. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#760861: bug#18428: Bug#760861: bug#18428: Bug#760861: bug#18428: coreutils binary breaks coreutils documentation
On 2014-09-09 12:58:14 -0400, Assaf Gordon wrote: BTW, http://gnu.org/s/; redirects to http://www.gnu.org/software/; , so http://gnu.org/s/coreutils/ls also works. But isn't it better to avoid a redirection (if possible)? -- Vincent Lefèvre vinc...@vinc17.net - Web: https://www.vinc17.net/ 100% accessible validated (X)HTML - Blog: https://www.vinc17.net/blog/ Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon) -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#760861: bug#18428: Bug#760861: bug#18428: Bug#760861: bug#18428: coreutils binary breaks coreutils documentation
Vincent Lefevre wrote: Assaf Gordon wrote: BTW, http://gnu.org/s/; redirects to http://www.gnu.org/software/; , so http://gnu.org/s/coreutils/ls also works. But isn't it better to avoid a redirection (if possible)? I think it is better to use the canonical form. This will be the documented interface. The short redirect in this case is really a typing aide. But the reason it redirects is so that the canonical form is presented to the user for bookmarking and other purposes. If we are playing golf and trying to reduce the number of characters at the expense of readability then the logical conclusion is that we should use a tinyurl such as http://tinyurl.com/osczpn8 or http://bit.ly/1p3QK7a and that obviously isn't good. Let's use the canonical form. Bob -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org