[Emacs-diffs] Changes to emacs/lispref/minibuf.texi

[Masatake YAMATO]

Index: emacs/lispref/minibuf.texi
diff -c emacs/lispref/minibuf.texi:1.65 emacs/lispref/minibuf.texi:1.66
*** emacs/lispref/minibuf.texi:1.65     Fri Sep 30 18:29:01 2005
--- emacs/lispref/minibuf.texi  Thu Oct 27 05:43:37 2005
***************
*** 949,955 ****
  @samp{*Completions*}.
  @end deffn
  
! @defun display-completion-list completions
  This function displays @var{completions} to the stream in
  @code{standard-output}, usually a buffer.  (@xref{Read and Print}, for more
  information about streams.)  The argument @var{completions} is normally
--- 949,955 ----
  @samp{*Completions*}.
  @end deffn
  
! @defun display-completion-list completions &optional common-substring
  This function displays @var{completions} to the stream in
  @code{standard-output}, usually a buffer.  (@xref{Read and Print}, for more
  information about streams.)  The argument @var{completions} is normally
***************
*** 960,973 ****
  the two strings is the actual completion, the second string serves as
  annotation.
  
! This function is called by @code{minibuffer-completion-help}.  The
  most common way to use it is together with
  @code{with-output-to-temp-buffer}, like this:
  
  @example
  (with-output-to-temp-buffer "*Completions*"
    (display-completion-list
!     (all-completions (buffer-string) my-alist)))
  @end example
  @end defun
  
--- 960,981 ----
  the two strings is the actual completion, the second string serves as
  annotation.
  
! @var{common-substring} represents a string common prefix between all 
! completions.  @var{common-substring} is used to put faces on 
! @samp{*Completions*} to enhance visual feedback of the buffer; 
! @code{display-completion-list} use faces to highlight what all completions 
! have in common and where they begin to differ.  @var{common-substring}
! specifies the common part.
! 
! This function is called by @code{minibuffer-completion-help}.  The 
  most common way to use it is together with
  @code{with-output-to-temp-buffer}, like this:
  
  @example
  (with-output-to-temp-buffer "*Completions*"
    (display-completion-list
!     (all-completions (buffer-string) my-alist)
!     (buffer-string)))
  @end example
  @end defun