Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Open sidebar
emacs
emacs
Commits
b4d52acc
Commit
b4d52acc
authored
May 28, 2011
by
Chong Yidong
Browse files
* doc/lispref/minibuf.texi (Reading File Names): Clarify (Bug#8480).
parent
2b1e1a22
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
13 additions
and
13 deletions
+13
-13
doc/lispref/ChangeLog
doc/lispref/ChangeLog
+2
-0
doc/lispref/minibuf.texi
doc/lispref/minibuf.texi
+11
-13
No files found.
doc/lispref/ChangeLog
View file @
b4d52acc
2011-05-28 Chong Yidong <cyd@stupidchicken.com>
* minibuf.texi (Reading File Names): Clarify (Bug#8480).
* tips.texi (Coding Conventions): Remove antediluvian filename
limit recommendation (Bug#8538).
...
...
doc/lispref/minibuf.texi
View file @
b4d52acc
...
...
@@ -1383,17 +1383,19 @@ Files, emacs, The GNU Emacs Manual}). The exact behavior when using a
graphical file dialog is platform-dependent. Here, we simply document
the behavior when using the minibuffer.
The optional argument @var{require-match} has the same meaning as in
@code{completing-read}. @xref{Minibuffer Completion}.
@code{read-file-name} does not automatically expand the returned file
name. You must call @code{expand-file-name} yourself if an absolute
file name is required.
@code{read-file-name} uses
@code{minibuffer-local-filename-completion-map} as the keymap if
@var{require-match} is @code{nil}, and uses
@code{minibuffer-local-filename-must-match-map} if @var{require-match}
is non-@code{nil}. @xref{Completion Commands}.
The optional argument @var{require-match} has the same meaning as in
@code{completing-read}. @xref{Minibuffer Completion}. If
@var{require-match} is @code{nil}, the local keymap in the minibuffer
is @code{minibuffer-local-filename-completion-map}; otherwise, it is
@code{minibuffer-local-filename-must-match-map}. @xref{Completion
Commands}.
The argument @var{directory} specifies the directory to use for
completi
on of
relative file names. It should be an absolute directory
completi
ng
relative file names. It should be an absolute directory
name. If @code{insert-default-directory} is non-@code{nil},
@var{directory} is also inserted in the minibuffer as initial input.
It defaults to the current buffer's value of @code{default-directory}.
...
...
@@ -1441,11 +1443,7 @@ argument that decides which file names are acceptable completion
possibilities. A file name is an acceptable value if @var{predicate}
returns non-@code{nil} for it.
@code{read-file-name} does not automatically expand file names. You
must call @code{expand-file-name} yourself if an absolute file name is
required.
Here is an example:
Here is an example of using @code{read-file-name}:
@example
@group
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment