summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJimmy Aguilar Mena <spacibba@aol.com>2020-09-15 13:19:13 +0200
committerJimmy Aguilar Mena <spacibba@aol.com>2020-09-15 13:19:13 +0200
commit4409ef6deade193058ad74f80c41eb72265645d0 (patch)
tree7d79481aa12256ae0ffcbce8f5bf5af2aa72da27
parent5a19bd834ef8d33716b65cbf2c0ca93b3aa9c618 (diff)
downloademacs-feature/uniquify-as-function.tar.gz
Document use of uniquify-buffer-name-style as a function.feature/uniquify-as-function
-rw-r--r--doc/emacs/buffers.texi11
-rw-r--r--etc/NEWS6
2 files changed, 17 insertions, 0 deletions
diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index 89ed470c055..aad91207151 100644
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -697,6 +697,17 @@ forward order after the file name, as in @samp{file|top/middle}. If
@code{uniquify-buffer-name-style} is set to @code{nil}, the buffer
names simply get @samp{<2>}, @samp{<3>}, etc.@: appended.
+ The value of @code{uniquify-buffer-name-style} can be set to a
+customized function with two mandatory arguments @var{base} and
+@var{extra-strings} where @var{base} is a string and
+@var{extra-strings} is a list of strings. For example the current
+implementation for @code{post-forward-angle-brackets} could be:
+
+@example
+(defun my-post-forward-angle-brackets (base extra-string)
+ (concat base \"<\" (mapconcat 'identity extra-string \"/\") \">\"))
+@end example
+
Which rule to follow for putting the directory names in the buffer
name is not very important if you are going to @emph{look} at the
buffer names before you type one. But as an experienced user, if you
diff --git a/etc/NEWS b/etc/NEWS
index 4076630bf22..2928fd9d970 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1425,6 +1425,12 @@ truncating precision field, such as "%.2a".
This can be used to parse RGB color specs in several formats and
convert them to a list '(R G B)' of primary color values.
+---
+** Variable 'uniquify-buffer-name-style' can now be a function.
+This variable can be one of the predefined styles or a function to
+personalize the uniquified buffer name.
+
+
* Changes in Emacs 28.1 on Non-Free Operating Systems