Re: completion in find-file

[Juri Linkov]

>     I thought that the node (info "(elisp)Reading File Names")
>     is more suitable place to document filename completion maps
>     than (info "(elisp)Completion Commands").
>
> Yes, that does seem better.  Would you please move those @defvars?

I now think your original change was better because the node
"Completion Commands" is the place for all completion-related
variables.  What is missing is a xref from "Reading File Names" to
"Completion Commands" pointing to filename completion maps active when
reading filenames.  The patch below adds references that are similar how
normal keymaps are referenced from the documentation of completing-read.

Index: lispref/minibuf.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/lispref/minibuf.texi,v
retrieving revision 1.69
diff -c -r1.69 minibuf.texi
*** lispref/minibuf.texi        9 Dec 2005 04:38:40 -0000       1.69
--- lispref/minibuf.texi        10 Dec 2005 01:04:36 -0000
***************
*** 1023,1034 ****
  
  @defvar minibuffer-local-filename-completion-map
  This is like @code{minibuffer-local-completion-map}
! except that it does not bind @key{SPC}.
  @end defvar
  
  @defvar minibuffer-local-must-match-filename-map
  This is like @code{minibuffer-local-must-match-map}
! except that it does not bind @key{SPC}.
  @end defvar
  
  @node High-Level Completion
--- 1023,1036 ----
  
  @defvar minibuffer-local-filename-completion-map
  This is like @code{minibuffer-local-completion-map}
! except that it does not bind @key{SPC}.  This keymap is used by the
! function @code{read-file-name}.
  @end defvar
  
  @defvar minibuffer-local-must-match-filename-map
  This is like @code{minibuffer-local-must-match-map}
! except that it does not bind @key{SPC}.  This keymap is used by the
! function @code{read-file-name}.
  @end defvar
  
  @node High-Level Completion
***************
*** 1212,1217 ****
--- 1214,1225 ----
  @var{existing} is @code{nil}, then the name of a nonexistent file is
  acceptable.
  
+ The function @code{read-file-name} uses
+ @code{minibuffer-local-filename-completion-map} as the keymap if
+ @var{existing} is @code{nil}, and uses
+ @code{minibuffer-local-must-match-filename-map} if @var{existing} is
+ address@hidden  @xref{Completion Commands}.
+ 
  The argument @var{directory} specifies the directory to use for
  completion of relative file names.  It should be an absolute directory
  name.  If @code{insert-default-directory} is address@hidden,

-- 
Juri Linkov
http://www.jurta.org/emacs/