Hello Bernhard,
On 2019-03-05 4:57 p.m., Bernhard Voelker wrote:
Older makeinfo-4.13a seems to have problems with the addition of the
macro '@{hashchar}' of commit v8.30-33-g2f438fa9f:
I believe some time ago (ca. 2017) there was a change to require
texinfo/makeinfo of at least version 6.1:
https://git.savannah.gnu.org/cgit/coreutils.git/commit/?id=ddbe4b7a3756356bfb6af3ebd6ee39a5fe592da5
(makeinfo version 4.13a being fom 2008 - it's rather old)
I'm guessing you are building from tarball (not from git),
so "bootstrap.conf" is not checked for minimal versions -
but then "coreutils.info" should already be per-packaged
in the tarball - there should not be a need to rebuild it.
All that being said, the fix is easy (suggestion attached).
I only briefly tested it makeinfo 6.3 and makeinfo 4.12 - both seem
to work (or at least not fail - but I guess makeinfo 4.12 still
generates bad HTML, as mentioned in the git commit above).
comments welcomed,
-assaf
>From 27e8b89f3bce4c238ee576e2987478f433d012aa Mon Sep 17 00:00:00 2001
From: Assaf Gordon <[email protected]>
Date: Tue, 5 Mar 2019 23:32:34 -0700
Subject: [PATCH] doc: replace @hashchar{} with actual hash character
Very old makeinfo-4.13 fails with:
./doc/coreutils.texi:2286: Unknown command `hashchar'.
./doc/coreutils.texi:2286: Misplaced {.
./doc/coreutils.texi:2286: Misplaced }.
Reported Bernhard Voelker in
https://lists.gnu.org/r/coreutils/2019-03/msg00016.html .
* doc/coreutils.texi (basenc invocation): Replace @hashchar{} with
actual hash character.
---
doc/coreutils.texi | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 097f04ca3..bd021f49d 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -2291,7 +2291,7 @@ Supported @var{encoding}s are:
@opindex --base64
Encode into (or decode from with @option{-d/--decode}) base64 form.
The format conforms to
-@uref{https://tools.ietf.org/search/rfc4648#section-4, RFC 4648@hashchar{}4}.
+@uref{https://tools.ietf.org/search/rfc4648#section-4, RFC 4648#4}.
Equivalent to the @command{base64} command.
@item --base64url
@@ -2299,14 +2299,14 @@ Equivalent to the @command{base64} command.
Encode into (or decode from with @option{-d/--decode}) file-and-url-safe
base64 form (using @samp{_} and @samp{-} instead of @samp{+} and @samp{/}).
The format conforms to
-@uref{https://tools.ietf.org/search/rfc4648#section-5, RFC 4648@hashchar{}5}.
+@uref{https://tools.ietf.org/search/rfc4648#section-5, RFC 4648#5}.
@item --base32
@opindex --base32
Encode into (or decode from with @option{-d/--decode}) base32 form.
The encoded data uses the @samp{ABCDEFGHIJKLMNOPQRSTUVWXYZ234567=} characters.
The format conforms to
-@uref{https://tools.ietf.org/search/rfc4648#section-6, RFC 4648@hashchar{}6}.
+@uref{https://tools.ietf.org/search/rfc4648#section-6, RFC 4648#6}.
Equivalent to the @command{base32} command.
@item --base32hex
@@ -2314,14 +2314,14 @@ Equivalent to the @command{base32} command.
Encode into (or decode from with @option{-d/--decode}) Extended Hex Alphabet
base32 form. The encoded data uses the
@samp{0123456789ABCDEFGHIJKLMNOPQRSTUV=} characters. The format conforms to
-@uref{https://tools.ietf.org/search/rfc4648#section-7, RFC 4648@hashchar{}7}.
+@uref{https://tools.ietf.org/search/rfc4648#section-7, RFC 4648#7}.
@item --base16
@opindex --base16
Encode into (or decode from with @option{-d/--decode}) base16 (hexadecimal)
form. The encoded data uses the @samp{0123456789ABCDEF} characters. The format
conforms to
-@uref{https://tools.ietf.org/search/rfc4648#section-8, RFC 4648@hashchar{}8}.
+@uref{https://tools.ietf.org/search/rfc4648#section-8, RFC 4648#8}.
@item --base2lsbf
@opindex --base2lsbf
--
2.11.0
