branch: externals/bufferlo
commit f618ac1271a1fd59efe05a1835722affc981d093
Author: Florian Rommel <m...@florommel.de>
Commit: Florian Rommel <m...@florommel.de>
Sync commentary with README
---
bufferlo.el | 46 ++++++++++++++++++++++++++--------------------
1 file changed, 26 insertions(+), 20 deletions(-)
diff --git a/bufferlo.el b/bufferlo.el
index 7c8c62b33b..dcd20fdbf7 100644
--- a/bufferlo.el
+++ b/bufferlo.el
@@ -1,6 +1,6 @@
-;;; bufferlo.el --- Manage frame/tab-local buffer lists -*- lexical-binding: t
-*-
+;;; bufferlo.el --- Frame/Tab Local Buffer Lists with Persistence -*-
lexical-binding: t -*-
-;; Copyright (C) 2021-2024 Free Software Foundation, Inc.
+;; Copyright (C) 2021-2025 Free Software Foundation, Inc.
;; Author: Florian Rommel <m...@florommel.de>
;; Stephane Marks <shipmi...@gmail.com>
@@ -27,24 +27,30 @@
;;; Commentary:
-;; This gives you separate buffer lists per frame and per (tab-bar) tab.
-
-;; Bufferlo is a lightweight wrapper around Emacs's buffer-list frame
-;; parameter. In contrast to similar solutions, it integrates
-;; seamlessly with the standard frame and tab management facilities,
-;; including undeletion of frame and tabs, tab duplication and moving,
-;; frame cloning, and persisting sessions (via desktop.el).
-
-;; With bufferlo, every frame or tab (if you use tab-bar tabs) has an
-;; additional manageable local buffer list. A buffer is added to the
-;; local buffer list when displayed in the frame/tab (e.g., by opening
-;; a new file in the tab or by switching to the buffer from the global
-;; buffer list). Bufferlo provides extensive management functions for
-;; the local list and frame/tab-local variants of the switch-buffer
-;; function, buffer menu, and Ibuffer. In addition, you can configure
-;; any command that selects a buffer to use the local buffer list
-;; (bufferlo anyhwere). Bufferlo also allows you to bookmark and
-;; persist the state of individual frames or tabs.
+;; With bufferlo, every frame and tab (i.e., tab-bar-mode tab) has an
+;; additional manageable local buffer list. A buffer is added to the
+;; local buffer list when displayed in the frame/tab (e.g., by opening a
+;; new file in the tab or by switching to the buffer from the global
+;; buffer list).
+
+;; Using Emacs's built-in buffer-list frame parameter, bufferlo
+;; integrates seamlessly with all standard frame and tab management
+;; facilities, including undeletion of frames and tabs, tab duplication
+;; and moving, frame cloning, and session persistence with desktop.el
+;; (though bufferlo frame and tab bookmarks offer an alternative
+;; persistence method).
+
+;; Bufferlo provides extensive management functions for its local lists
+;; and offers features on top of switch-buffer functions, buffer menu,
+;; and ibuffer. You can configure any command that selects a buffer to
+;; use the local buffer list via bufferlo-anywhere-mode.
+
+;; In addition, bufferlo offers lightweight Emacs bookmarks-based
+;; persistence for frames, tabs, and sets of frames/tabs to help you
+;; manage your transient workflows. Bufferlo bookmarks are compatible
+;; with built-in features such as bookmark-bmenu-list and third-party
+;; packages such as consult which offers consult-bookmark for interactive
+;; bookmark selection.
;;; Code:
