On 23-05-26 19:25, Paul Eggert wrote: | On 2023-05-25 03:25, Luke Mewburn wrote: | > I think that the autoconf and m4 manuals could have improved | > cross-references to the regular expression syntax actually supported | > in autoconf via GNU m4: | | Perhaps specific patches? | | Cross-manual links are a bit of a pain to maintain, but if it's important | we can put them in. How's this? I checked the output with "make web-manual" and checking the generated HTML; the links in both the full manual and the node manual seem to work. cheers, Luke.
From 356c17493cc38c1a0c04c45e30f4a923342aa0b4 Mon Sep 17 00:00:00 2001
From: Luke Mewburn <Luke@xxxxxxxxxxx>
Date: Sun, 4 Jun 2023 01:10:30 +1000
Subject: [PATCH] doc: cross-reference m4 and gnulib regexp
* doc/autoconf.texi: Add cross-references to the GNU M4 patsubst and
regexp macros, and to the GNU Gnulib emacs regex section (since M4 is
implemented using that, which is slightly different to the actual GNU
Emacs regex syntax).
---
doc/autoconf.texi | 16 ++++++++++++++--
1 file changed, 14 insertions(+), 2 deletions(-)
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 0f3047b3..d03296d5 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -12023,14 +12023,26 @@ This macro kept its original name: no @code{m4_dnl} is defined.
@defmac m4_bpatsubst (@var{string}, @var{regexp}, @ovar{replacement})
@msindex{bpatsubst}
-This macro corresponds to @code{patsubst}. The name @code{m4_patsubst}
+This macro corresponds to @code{patsubst} (@pxref{Patsubst,,Substituting
+text by regular expression,m4,GNU m4 macro processor}).
+GNU M4 1.x is implemented with GNU Gnulib @samp{emacs} regular expression
+syntax (@pxref{emacs regular expression syntax,,@samp{emacs} regular
+expression syntax,gnulib,GNU Gnulib}).
+
+The name @code{m4_patsubst}
is kept for future versions of M4sugar, once GNU M4 2.0 is
released and supports extended regular expression syntax.
@end defmac
@defmac m4_bregexp (@var{string}, @var{regexp}, @ovar{replacement})
@msindex{bregexp}
-This macro corresponds to @code{regexp}. The name @code{m4_regexp}
+This macro corresponds to @code{regexp} (@pxref{Regexp,,Searching for
+regular expressions,m4,GNU m4 macro processor}).
+GNU M4 1.x is implemented with GNU Gnulib @samp{emacs} regular expression
+syntax (@pxref{emacs regular expression syntax,,@samp{emacs} regular
+expression syntax,gnulib,GNU Gnulib}).
+
+The name @code{m4_regexp}
is kept for future versions of M4sugar, once GNU M4 2.0 is
released and supports extended regular expression syntax.
@end defmac
--
2.39.1
Attachment:
signature.asc
Description: PGP signature
