> 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
+ [EMAIL PROTECTED] @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 [EMAIL PROTECTED],
--
Juri Linkov
http://www.jurta.org/emacs/
_______________________________________________
emacs-pretest-bug mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/emacs-pretest-bug
