aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref
diff options
context:
space:
mode:
authorGlenn Morris <[email protected]>2014-06-08 00:41:27 -0700
committerGlenn Morris <[email protected]>2014-06-08 00:41:27 -0700
commit99d8aedf0d6ab3fff025f72daf1f9bd28b07a8d2 (patch)
tree98f15969887d9453ae88fd66eb4d1d1fa3eafa01 /doc/lispref
parentb6542afeae56abe6b20019df63b76539728fca54 (diff)
Doc edits re uniquify
* doc/emacs/buffers.texi (Uniquify): Copyedits. * doc/emacs/files.texi (Visiting): Update for uniquify changes. * doc/lispref/files.texi (Subroutines of Visiting): Mention uniquify. * doc/misc/vip.texi (Files): Defer to Emacs manual for uniquify details. * lisp/bookmark.el (bookmark-load): Doc fix. * lisp/uniquify.el (uniquify-buffer-name-style): Doc fix. * lisp/files.el: Comment. * etc/NEWS: Related edit.
Diffstat (limited to 'doc/lispref')
-rw-r--r--doc/lispref/ChangeLog2
-rw-r--r--doc/lispref/files.texi5
2 files changed, 7 insertions, 0 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 1a4c9c3a57..aa5589e1c1 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,5 +1,7 @@
2014-06-08 Glenn Morris <[email protected]>
+ * files.texi (Subroutines of Visiting): Mention uniquify.
+
* numbers.texi (Comparison of Numbers): Copyedits.
2014-06-06 Glenn Morris <[email protected]>
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 278b49e51e..b071c6a8f3 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -254,11 +254,16 @@ is permanent local, so it is unaffected by changes of major modes.
which are sometimes useful in user Lisp code: @code{create-file-buffer}
and @code{after-find-file}. This section explains how to use them.
+@c FIXME This does not describe the default behavior, because
+@c uniquify is enabled by default and advises this function.
+@c This is confusing. uniquify should be folded into the function proper.
@defun create-file-buffer filename
This function creates a suitably named buffer for visiting
@var{filename}, and returns it. It uses @var{filename} (sans directory)
as the name if that name is free; otherwise, it appends a string such as
@samp{<2>} to get an unused name. See also @ref{Creating Buffers}.
+Note that the @file{uniquify} library affects the result of this
+function. @xref{Uniquify,,, emacs, The GNU Emacs Manual}.
@strong{Please note:} @code{create-file-buffer} does @emph{not}
associate the new buffer with a file and does not select the buffer.