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.

Reply via email to