Eli Zaretskii writes: >> From: Eshel Yaron >> Cc: 66303@debbugs.gnu.org >> Date: Sat, 14 Oct 2023 12:02:20 +0200 >> >> > Here and elsewhere you mention regexp sub-expressions. Please add in >> > those places a cross-reference to where sub-expressions are described >> > in the manual, since this is an advanced aspect of regexps with which >> > some readers might not be well acquainted. >> >> Sure, I've added cross-references to the "Regular Expressions" node in >> the Elisp manual. Alternatively, we could link to "Regexp Backslash" in >> the Emacs manual, if you think that's preferable. > > It is better to cross-reference to the same manual, assuming it does > document the sub-expressions. Only if it doesn't document them well > enough should we cross-reference to ELisp. Neither manual documents the concept of sub-expressions in detail AFAICT, both only describe the relevant syntax. The text in the Elisp manual seems a bit more relevant to me, but I can see how sticking to the Emacs manual may be preferable. I'm attaching a revised (v5) patch that refers to "Regexp Backslash" in the Emacs manual instead. I've also added a reference to this bug number in the commit message: