GNU bug report logs - #3934
23.0.96; Document `minibuffer-history-variable'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 3934 in the body.
You can then email your comments to 3934 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.96; Document `minibuffer-history-variable'
Date: Sun, 26 Jul 2009 11:49:12 -0700

In Info node (elisp)Minibuffer History, please document (mention)
`minibuffer-history-variable'.

In GNU Emacs 23.0.96.1 (i386-mingw-nt5.1.2600)
 of 2009-07-09 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4)'
 

Message #14 received at 3934 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 3934 <at> debbugs.gnu.org
Subject: Re: 23.0.96; Document `minibuffer-history-variable'
Date: Tue, 12 Jul 2011 22:06:54 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

> In Info node (elisp)Minibuffer History, please document (mention)
> `minibuffer-history-variable'.

Reading the code and the documentation, I think this variable is for
internal use, and shouldn't be explicitly altered (normally).

So documenting it in that node would be misleading.  Closing the report.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #17 received at 3934 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>
Cc: 3934 <at> debbugs.gnu.org
Subject: RE: 23.0.96; Document `minibuffer-history-variable'
Date: Tue, 12 Jul 2011 13:41:41 -0700

> > In Info node (elisp)Minibuffer History, please document (mention)
> > `minibuffer-history-variable'.
> 
> Reading the code and the documentation, I think this variable is for
> internal use, and shouldn't be explicitly altered (normally).
> 
> So documenting it in that node would be misleading.  Closing 
> the report.

No.  It is just like `minibuffer-completion-table',
`minibuffer-completion-predicate', and `minibuffer-completion-confirm'.

It is not used only for completion - it is even more general.  That explains why
it is not introduced along with the `minibuffer-completion-*' vars in node
`Completion Commands'.

But it is no less a variable that programmers can use in their code.  This is
the Emacs-Lisp manual.  This variable is an important variable to understand
when dealing with minibuffer input.

Message #24 received at 3934-close <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 3934-close <at> debbugs.gnu.org
Subject: Re: 23.0.96; Document `minibuffer-history-variable'
Date: Tue, 02 Aug 2011 18:12:31 +0200

"Drew Adams" <drew.adams <at> oracle.com> writes:

>> > In Info node (elisp)Minibuffer History, please document (mention)
>> > `minibuffer-history-variable'.
>> 
>> Reading the code and the documentation, I think this variable is for
>> internal use, and shouldn't be explicitly altered (normally).
>> 
>> So documenting it in that node would be misleading.  Closing 
>> the report.

[...]

> But it is no less a variable that programmers can use in their code.  This is
> the Emacs-Lisp manual.  This variable is an important variable to understand
> when dealing with minibuffer input.

No, I think documenting it would be irrelevant.  Closing this report
again.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

Message #25 received at 3934-close <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>
Cc: 3934-close <at> debbugs.gnu.org
Subject: RE: 23.0.96; Document `minibuffer-history-variable'
Date: Tue, 2 Aug 2011 10:27:57 -0700

> > a variable that programmers can use in their code.
> > This is the Emacs-Lisp manual.  This variable is an
> > important variable to understand when dealing with
> > minibuffer input.
> 
> No, I think documenting it would be irrelevant.
> Closing this report again.

"You think" so, but you don't say why.
You explain nothing about what "you think".

In my own code I have 57 occurrences of it, in 5 different files.  On Emacs
Wiki, apart from my own files, there are 6 user files that use it.

Anyone doing almost anything with the minibuffer history needs to know about
this variable.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.