mirror of
git://git.sv.gnu.org/coreutils.git
synced 2026-08-07 17:19:18 +02:00
doc: ensure the correct texinfo nodes are referenced in --help
* src/system.h (emit_ancillary_info): For commands that don't have a 1:1 mapping with the texinfo node names, provide a mapping to the correct node. * doc/coreutils.texi: Add some extra cross references noticed while checking this. Fixes http://bugs.debian.org/762092
This commit is contained in:
+4
-1
@@ -4206,7 +4206,8 @@ The commands @command{sha224sum}, @command{sha256sum},
|
||||
@command{sha384sum} and @command{sha512sum} compute checksums of
|
||||
various lengths (respectively 224, 256, 384 and 512 bits),
|
||||
collectively known as the SHA-2 hashes. The usage and options of
|
||||
these commands are precisely the same as for @command{md5sum}.
|
||||
these commands are precisely the same as for @command{md5sum}
|
||||
and @command{sha1sum}.
|
||||
@xref{md5sum invocation}.
|
||||
|
||||
Note: The SHA384 and SHA512 digests are considerably slower to
|
||||
@@ -7961,6 +7962,8 @@ and special characters are represented by backslash escape sequences.
|
||||
-b}; that is, by default files are listed in long format and special
|
||||
characters are represented by backslash escape sequences.
|
||||
|
||||
@xref{ls invocation, @command{ls}}.
|
||||
|
||||
@node dircolors invocation
|
||||
@section @command{dircolors}: Color setup for @command{ls}
|
||||
|
||||
|
||||
+22
-3
@@ -567,7 +567,26 @@ Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).\n\
|
||||
static inline void
|
||||
emit_ancillary_info (void)
|
||||
{
|
||||
char const * program = last_component (program_name);
|
||||
char const *program = last_component (program_name);
|
||||
|
||||
struct infomap { char const *program; char const *node; } const infomap[] = {
|
||||
{ "[", "test invocation" },
|
||||
{ "coreutils", "Multi-call invocation" },
|
||||
{ "sha224sum", "sha2 utilities" },
|
||||
{ "sha256sum", "sha2 utilities" },
|
||||
{ "sha384sum", "sha2 utilities" },
|
||||
{ "sha512sum", "sha2 utilities" },
|
||||
{ NULL, NULL }
|
||||
};
|
||||
|
||||
char const *node = program;
|
||||
struct infomap const *map_prog = infomap;
|
||||
|
||||
while (map_prog->program && ! STREQ (program, map_prog->program))
|
||||
map_prog++;
|
||||
|
||||
if (map_prog->node)
|
||||
node = map_prog->node;
|
||||
|
||||
printf (_("\n%s online help: <%s>\n"), PACKAGE_NAME, PACKAGE_URL);
|
||||
|
||||
@@ -585,8 +604,8 @@ emit_ancillary_info (void)
|
||||
}
|
||||
printf (_("Full documentation at: <%s%s>\n"),
|
||||
PACKAGE_URL, program);
|
||||
printf (_("or available locally via: info '(coreutils) %s invocation'\n"),
|
||||
program);
|
||||
printf (_("or available locally via: info '(coreutils) %s%s'\n"),
|
||||
node, node == program ? " invocation" : "");
|
||||
}
|
||||
|
||||
static inline void
|
||||
|
||||
Reference in New Issue
Block a user