Re: [Emacs-diffs] master d88fed6: Document custom-variable-history

Re: [Emacs-diffs] master d88fed6: Document custom-variable-history

[Charles A. Roelli]

> Date: Tue,  3 Apr 2018 07:31:45 -0400 (EDT)
> From: eliz@gnu.org (Eli Zaretskii)
> 
> branch: master
> commit d88fed61f0d65a4231fa987ba12e3df55de31974
> Author: Eli Zaretskii <eliz@gnu.org>
> Commit: Eli Zaretskii <eliz@gnu.org>
> 
>     Document custom-variable-history
>     
>     * etc/NEWS:
>     * doc/lispref/minibuf.texi (Minibuffer History): Document
>     'custom-variable-history'.
> ---
>  doc/lispref/minibuf.texi | 6 ++++++
>  etc/NEWS                 | 5 +++++
>  2 files changed, 11 insertions(+)
> 
> diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
> index 1d1c93d..338e03e 100644
> --- a/doc/lispref/minibuf.texi
> +++ b/doc/lispref/minibuf.texi
> @@ -634,6 +634,12 @@ A history list for arguments that are Lisp expressions to evaluate.
>  A history list for arguments that are faces.
>  @end defvar
>  
> +@findex read-variable@r{, history list}
> +@defvar custom-variable-history
> +A history list for variable-name arguments read by
> +@code{read-variable}.
> +@end defvar
> +
>  @c Less common: coding-system-history, input-method-history,
>  @c command-history, grep-history, grep-find-history,
>  @c read-envvar-name-history, setenv-history, yes-or-no-p-history.
> diff --git a/etc/NEWS b/etc/NEWS
> index b3fee08..a510c03 100644
> --- a/etc/NEWS
> +++ b/etc/NEWS
> @@ -474,6 +474,11 @@ depending on the new customizable variable 'read-answer-short'.
>  Specifically, it puts the module name into 'load-history', prints
>  loading messages if requested, and protects against recursive loads.
>  
> ++++
> +** The function 'read-variable' now uses its own history list.
> +The history of variable names read by 'read-variable' is recorded in
> +the new variable 'custom-variable-history'.

Thanks!  I was not sure whether adding 'custom-variable-history' would
need a doc update; I will ask next time.

Re: [Emacs-diffs] master d88fed6: Document custom-variable-history

[Eli Zaretskii]

> Date: Wed, 04 Apr 2018 21:59:21 +0200
> From: charles@aurox.ch (Charles A. Roelli)
> Cc: eliz@gnu.org, emacs-devel@gnu.org
> 
> Thanks!  I was not sure whether adding 'custom-variable-history' would
> need a doc update; I will ask next time.

In general, any change that is not a bugfix needs to be in NEWS.
Whether it also needs to be in the manuals depends on (a) whether
related features are already described there, and (b) whether it
changes user-visible or Lisp-level behavior in some significant way.

When in doubt, please do ask.

Thanks.