From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: query-replace-interactive not documented Date: Sat, 29 May 2004 23:33:04 +0300 Organization: JURTA Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <873c5jug73.fsf@mail.jurta.org> References: <20040528.181649.25475113.wl@gnu.org> <200405291737.i4THbPJ06689@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1085863045 3756 80.91.224.253 (29 May 2004 20:37:25 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 29 May 2004 20:37:25 +0000 (UTC) Cc: wl@gnu.org, rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 29 22:37:15 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BUAZv-0008AI-00 for ; Sat, 29 May 2004 22:37:15 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BUAZv-0006Xl-00 for ; Sat, 29 May 2004 22:37:15 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BUAa1-0003hG-Im for emacs-devel@quimby.gnus.org; Sat, 29 May 2004 16:37:21 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1BUAZy-0003gv-Dh for emacs-devel@gnu.org; Sat, 29 May 2004 16:37:18 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1BUAZw-0003gV-TI for emacs-devel@gnu.org; Sat, 29 May 2004 16:37:18 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BUAZw-0003gS-QN for emacs-devel@gnu.org; Sat, 29 May 2004 16:37:16 -0400 Original-Received: from [66.33.219.4] (helo=spork.dreamhost.com) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BUAYg-0002jI-5Q; Sat, 29 May 2004 16:35:58 -0400 Original-Received: from mail.jurta.org (80-235-40-64-dsl.mus.estpak.ee [80.235.40.64]) by spork.dreamhost.com (Postfix) with ESMTP id 08CD811DC0E; Sat, 29 May 2004 13:35:55 -0700 (PDT) Original-To: Luc Teirlinck In-Reply-To: <200405291737.i4THbPJ06689@raven.dms.auburn.edu> (Luc Teirlinck's message of "Sat, 29 May 2004 12:37:25 -0500 (CDT)") User-Agent: Gnus/5.110002 (No Gnus v0.2) Emacs/21.3.50 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:24192 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24192 Luc Teirlinck writes: > `query-replace-interactive' is not a user option. It is defined using > defvar in replace.el. Its docstring does not start with a `*' either. > Of course, we can not document every single defvar either. > > Should it be a defcustom? Is it something one would want to set > permanently to t? (I would not want to, but might other people want > to?) I remember there was a discussion about changing user options defined by defvar into defcustom. At least, `query-replace-interactive' looks like a typical user option. However, I think it should not be added to the Emacs manual because there are many other similar undocumented options which don't fit into the manual. What should be documented in the Emacs manual is a very useful command `query-replace-regexp-eval'. It even deserves its own keybinding. But if there are no spare keybindings for it, then perhaps it could be invoked by a prefix arg of `query-replace-regexp' like e.g. C-u C-M-% ? -- Juri Linkov http://www.jurta.org/emacs/