minibuf.texi updates for display-completion-list

[Masatake YAMATO]

I've written about what I changed on `display-completion-list'.
Could you review this?

Masatake YAMATO

Index: lispref/minibuf.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/minibuf.texi,v
retrieving revision 1.65
diff -u -r1.65 minibuf.texi
--- lispref/minibuf.texi        30 Sep 2005 18:29:01 -0000      1.65
+++ lispref/minibuf.texi        26 Oct 2005 02:24:41 -0000
@@ -949,7 +949,7 @@
 @samp{*Completions*}.
 @end deffn
 
address@hidden display-completion-list completions
address@hidden 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,14 +960,22 @@
 the two strings is the actual completion, the second string serves as
 annotation.
 
-This function is called by @code{minibuffer-completion-help}.  The
address@hidden represents a string common prefix between all 
+completions.  @var{common-substring} is used to put faces on 
address@hidden to enhance visual feedback of the buffer; 
address@hidden 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)))
+    (all-completions (buffer-string) my-alist)
+    (buffer-string)))
 @end example
 @end defun