[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#18428: Bug#760861: bug#18428: Bug#760861: bug#18428: coreutils binar

From: Bernhard Voelker
Subject: bug#18428: Bug#760861: bug#18428: Bug#760861: bug#18428: coreutils binary breaks coreutils documentation
Date: Thu, 11 Sep 2014 10:54:28 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.7.0

On 09/11/2014 02:31 AM, Pádraig Brady wrote:

> Subject: [PATCH 1/2] doc: adjust reference to info nodes in man pages


Subject: [PATCH 2/2] doc: reference online info pages directly from man pages

The result of both patches looks almost good:

--- a/share/man/man1/basename.1
+++ b/share/man/man1/basename.1
@@ -43,11 +43,12 @@ basename \-s .h include/stdio.h
 basename \-a any/str1 any/str2
 \-> "str1" followed by "str2"
-GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
-Report basename translation bugs to <http://translationproject.org/team/>
 Written by David MacKenzie.
+GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
+Report basename translation bugs to <http://translationproject.org/team/>
 Copyright \(co 2014 Free Software Foundation, Inc.
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
@@ -57,14 +58,7 @@ There is NO WARRANTY, to the extent permitted by law.
 dirname(1), readlink(1)
-The full documentation for
-.B basename
-is maintained as a Texinfo manual.  If the
-.B info
-.B basename
-programs are properly installed at your site, the command
-.B info coreutils \(aqbasename invocation\(aq
-should give you access to the complete manual.
+Full documentation at: <http://www.gnu.org/software/coreutils/basename>
+or available locally via: info '(coreutils) basename invocation'

I think we need the \aq instead of ' here, don't we?

* help2man: Adjust to add the "online help" link (and subsequent
translation bugs link) to a "REPORTING BUGS" section.
Also add the concise links for further information in --help
to the "SEE ALSO" section, and dispense with the more verbose
default for that.

With this, we'd deviate from stock GNU help2man again.
I haven't looked into http://www.gnu.org/software/help2man/
too much yet, but are you sure we can't do the same with
the original upstream help2man?
BTW: we are using 1.43.3 while 1.46.2 is already available.
Maybe there are a few new options which may help.

Thanks & have a nice day,

reply via email to

[Prev in Thread] Current Thread [Next in Thread]