From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#24095: 25.1; Insufficient documentation of minibuffer-related variables Date: Thu, 28 Jul 2016 09:10:25 -0700 (PDT) Message-ID: References: <83shutrenm.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1469722616 14533 80.91.229.3 (28 Jul 2016 16:16:56 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 28 Jul 2016 16:16:56 +0000 (UTC) To: Eli Zaretskii , 24095@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 28 18:16:42 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bSnzG-0008S6-Ho for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Jul 2016 18:16:42 +0200 Original-Received: from localhost ([::1]:54450 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bSnzF-0000DB-Fh for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Jul 2016 12:16:41 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38362) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bSntp-0003WF-Tv for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2016 12:11:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bSntm-0006Tf-Fp for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2016 12:11:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52164) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bSntm-0006Ta-CR for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2016 12:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bSntm-0004uV-3M for bug-gnu-emacs@gnu.org; Thu, 28 Jul 2016 12:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 Jul 2016 16:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24095 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 24095-submit@debbugs.gnu.org id=B24095.146972223818843 (code B ref 24095); Thu, 28 Jul 2016 16:11:02 +0000 Original-Received: (at 24095) by debbugs.gnu.org; 28 Jul 2016 16:10:38 +0000 Original-Received: from localhost ([127.0.0.1]:49461 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bSntO-0004tr-2y for submit@debbugs.gnu.org; Thu, 28 Jul 2016 12:10:38 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:37980) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bSntM-0004td-Og for 24095@debbugs.gnu.org; Thu, 28 Jul 2016 12:10:37 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u6SGATPe003048 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 28 Jul 2016 16:10:30 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u6SGATWM017064 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 28 Jul 2016 16:10:29 GMT Original-Received: from abhmp0014.oracle.com (abhmp0014.oracle.com [141.146.116.20]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u6SGAQQP018107; Thu, 28 Jul 2016 16:10:26 GMT In-Reply-To: <83shutrenm.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:121626 Archived-At: +1 to everything Eli said. I think (but am not sure) that these variables were added by Stefan. Perhaps he can explain them. If not, hopefully someone else can. Here is some of what I understand about these things, in case it helps: For `minibuffer-default': I believe that its value auguments whatever default value (or list of default values) is provided directly to the function reading from the minibuffer (e.g. `read-from-minibuffer'). For `minibuffer-default-add-function': I believe that its value is a function of no args that returns a list of default values that overrides `minibuffer-default'. So, for example, if the value of `minibuffer-default-add-function' is `minibuffer-default-add-dired-shell-commands' then the result of invoking that function is to return a list of default values that includes those from `minibuffer-default' but adds also some shell commands from mailcap. For `minibuffer-default-add-completions': It is the default value of variable `minibuffer-default-add-function'. I belive that it adds the list of all possible completions of empty input ("") for `completing-read' to the list of default values, so that you can treat completions as default values (e.g. cycle using `M-n'). For example, `read-extended-command' (used by `M-x'), using `minibuffer-with-setup-hook', sets `minibuffer-default-add-function' to a function that picks up a command name at point (if there is one). This means that that command name gets added (by `minibuffer-default-add-completions', which is the value of `minibuffer-default-add-function') to the list of default values. And this means that if you use `M-x' with point on a command name then that command name is inserted in the minibuffer. For `minibuffer-avoid-prompt': It seems that it tries to make point-motion commands not put point in the prompt area. So, for example, `C-a' will not move point into the prompt area (but `C-b' will). For `minibuffer-history-case-insensitive-variables': This seems to be a list of history variables for which history-list matching ignores case. The doc string seems pretty clear in this case, except perhaps that it should say that the matching involved is matching against elements of the current history list. The rest of the doc string makes this clear, by mentioning `(next|previous)-history-element', which do just that: match against the history list. HTH. And I hope that someone more knowledgable corrects any misunderstandings on my part, and improves the doc as Eli requested.