Re: should query-replace-regexp-eval be in the manual?

["Robert J. Chassell" <bob@rattlesnake.com>]

The discussion of query-replace-regexp presumes using it
interactively.  That does not necessarily follow, although I suppose
interactive use is most common.

For example

    M-C-% or.*ry RET \,(format "strange %s" \#)

is

    (query-replace-regexp "or.*ry"
                          '(replace-eval-replacement
                            replace-quote
                            (format "strange %s" replace-count)))

[i.e., convert "ordinary" or something like it to "strange" plus a number]

When you are writing Emacs Lisp expressions, it is simpler to use
`query-replace-regexp-eval'.  The same result will come from invoking

    (query-replace-regexp-eval "or.*ary"
                               '(format "strange %s" replace-count))

I recommend leaving it in the source.  Perhaps (a short) mention in
the manual is useful, although I do not feel strongly about that.

--
    Robert J. Chassell                          GnuPG Key ID: 004B4AC8
    bob@rattlesnake.com                         bob@gnu.org
    http://www.rattlesnake.com                  http://www.teak.cc