From: Jimmy Aguilar Mena Date: Tue, 15 Sep 2020 11:19:13 +0000 (+0200) Subject: Document use of uniquify-buffer-name-style as a function. X-Git-Tag: emacs-28.0.90~6058^2 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=32220b53fd4e4c8a630434eec008325121143236;p=emacs.git Document use of uniquify-buffer-name-style as a function. --- diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index 89ed470c055..537c6536085 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 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