branch: externals/beframe
commit 2728f72174c1164e99bab4daaef64910e6b41c6c
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Update to Beframe version 1.4.0
---
CHANGELOG.org | 39 +++++++++++++++++++++++++++++++++++++++
README.org | 10 ++++------
beframe.el | 2 +-
3 files changed, 44 insertions(+), 7 deletions(-)
diff --git a/CHANGELOG.org b/CHANGELOG.org
index 5147c96b92..db44609c30 100644
--- a/CHANGELOG.org
+++ b/CHANGELOG.org
@@ -9,6 +9,45 @@ project's main git repository:
<https://github.com/protesilaos/beframe>.
The newest release is at the top. For further details, please consult
the manual: <https://protesilaos.com/emacs/beframe>.
+* Version 1.4.0 on 2025-06-28
+:PROPERTIES:
+:CUSTOM_ID: h:43536015-8c68-4aca-a02a-1a80f23350be
+:END:
+
+This version adds some minor improvements to a stable package.
+
+** Per-frame Xref histories
+:PROPERTIES:
+:CUSTOM_ID: h:d1a17d72-cb2f-4611-ac38-c7d0106cc102
+:END:
+
+The built-in Xref mechanism is typically used to navigate to the
+definition of the symbol at point in a programming major mode. The
+command ~xref-find-definitions~ (=M-.= by default) jumps to the
+source, while ~xref-go-back~ (=M-,= by default) goes back in the
+history of visited positions until it reaches the starting point.
+
+When ~beframe-mode~ is enabled, each new frame has its own Xref
+history. This means that finding a definition in one frame does not
+interfere with the Xref history of another frame.
+
+** "Beframed" buffer prompt text is now optional
+:PROPERTIES:
+:CUSTOM_ID: h:575b310f-e7c5-4d6c-a366-e0dd95219dc0
+:END:
+
+When ~beframe-mode~ is enabled, it sets the standard
+~read-buffer-function~ to one that filters buffers by frame. Any
+command that uses that, such as ~switch-to-buffer~ (=C-x b= by
+default) is thus beframing its completion candidates.
+
+Such prompts get a prefix to inform the user of their behaviour. By
+default this is =[Beframed]=: it is subject to the user option
~beframe-prompt-prefix~.
+Users who do not wish to have any prefix can set this option to nil or
+an empty string.
+
+When there is a string, it is styled with the face
~beframe-face-prompt-prefix~.
+
* Version 1.3.0 on 2025-01-24
:PROPERTIES:
:CUSTOM_ID: h:1ff9bbfe-6a4e-4bcb-958d-6930a7816235
diff --git a/README.org b/README.org
index 8abefe6f65..3cde8e7012 100644
--- a/README.org
+++ b/README.org
@@ -4,9 +4,9 @@
#+language: en
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
-#+macro: stable-version 1.3.0
-#+macro: release-date 2025-01-24
-#+macro: development-version 1.4.0-dev
+#+macro: stable-version 1.4.0
+#+macro: release-date 2025-06-28
+#+macro: development-version 1.5.0-dev
#+export_file_name: beframe.texi
#+texinfo_filename: beframe.info
#+texinfo_dir_category: Emacs misc features
@@ -69,9 +69,7 @@ is achieved in three main ways:
such, commands like ~switch-to-buffer~, ~next-buffer~, and
~previous-buffer~ automatically work in a beframed way. Buffer
prompts affected by this get the ~beframe-prompt-prefix~ text,
- which is styled with ~beframe-face-prompt-prefix~. [ The
- ~beframe-prompt-prefix~ and its corresponding face are part of
- {{{development-version}}}. ]
+ which is styled with ~beframe-face-prompt-prefix~.
#+findex: beframe-buffer-menu
3. The command ~beframe-buffer-menu~ produces a dedicated buffer with
diff --git a/beframe.el b/beframe.el
index 6b2b98b452..0ffdee4601 100644
--- a/beframe.el
+++ b/beframe.el
@@ -5,7 +5,7 @@
;; Author: Protesilaos Stavrou <i...@protesilaos.com>
;; Maintainer: Protesilaos Stavrou <i...@protesilaos.com>
;; URL: https://github.com/protesilaos/beframe
-;; Version: 1.3.0
+;; Version: 1.4.0
;; Package-Requires: ((emacs "28.1"))
;; This file is NOT part of GNU Emacs.
