[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/indent-bars be6a67cda4 093/431: Update README.md
From: |
ELPA Syncer |
Subject: |
[elpa] externals/indent-bars be6a67cda4 093/431: Update README.md |
Date: |
Mon, 16 Sep 2024 12:59:17 -0400 (EDT) |
branch: externals/indent-bars
commit be6a67cda4f0075bc2cdc356ae7fae83a39aa620
Author: JD Smith <93749+jdtsmith@users.noreply.github.com>
Commit: GitHub <noreply@github.com>
Update README.md
---
README.md | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)
diff --git a/README.md b/README.md
index 27f5ed954e..c7aa1b5ba6 100644
--- a/README.md
+++ b/README.md
@@ -125,14 +125,21 @@ which should then look something like:
<img width="668" alt="image"
src="https://github.com/jdtsmith/indent-bars/assets/93749/dd0f65f5-3cdc-4865-a66d-41365cecadd0";>
-If you determine that stipples do not work in your Emacs, consider upgrading
to a version which suppor them, or setting `indent-bars-prefer-character=t`.
+If you determine that stipples do not work in your Emacs, consider upgrading
to a version which supports them, or setting `indent-bars-prefer-character=t`.
#### Per-buffer stipple offsets
-To get the stipple bars in the right place, `indent-bars` must consider the
starting horizontal pixel position of the current window, and adjust the
stipple pattern accordingly. It does this automatically, per buffer, so you
shouldn't ever notice problems, even when re-sizing or re-arranging windows,
changing font size, etc.
+To get the stipple bars in the right place, `indent-bars` must consider the
starting horizontal pixel position of the current window, and "rotate" the
stipple pattern accordingly. It does this automatically, per buffer, so you
shouldn't ever notice problems, even when re-sizing or re-arranging windows,
changing font size, etc.
There is one rare corner case, however: showing the *same buffer* side by side
in Emacs versions which support pixel-level window width/offsets (e.g.
emacs-mac) can lead to unexpected bar positions in the non-active buffer, since
the stipple offset in the remapped face applies *per-buffer*, not per-window.
I.e. it can't be correct for the same buffer in left and right windows at the
same time.
-Options are living with this, switching to [character-based
bars](#non-stipple-display), or (for Emacs >=29) instead of visiting the same
buffer, cloning an indirect buffer (which has other advantages, like an
independent region). Note that Emacs 28 and earlier have a bug which results
in cloned buffers sharing the same face remapping list as their parent; this is
fixed in Emacs 29.
+Options are:
+
+1. Living with it
+2. Using a build of emacs that always starts windows on the character boundary
+3. Switching to [character-based bars](#non-stipple-display)
+4. (For Emacs >=29) instead of visiting the same buffer, cloning an indirect
buffer (which has other advantages, like an independent region).
+
+Note that Emacs 28 and earlier have a bug which results in cloned buffers
sharing the same face remapping list as their parent; this is fixed in Emacs 29.
### Non-stipple display
- [elpa] externals/indent-bars eab376d061 041/431: Allow background color on current depth highlight, (continued)
- [elpa] externals/indent-bars eab376d061 041/431: Allow background color on current depth highlight, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 253cf0d9bc 042/431: Improve spacing-override customize, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 71472e3cce 040/431: sub-headings, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars f608dce7a6 046/431: Convert examples from org to md, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars b4995ad103 058/431: README: add hl-indent-scope, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars f109140fcb 047/431: examples.md: added images, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 0500330d87 070/431: README: mention after-make-frame-hook, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 6e33272206 086/431: Ensure daemon-mode deferred setup runs in current buffer, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 21b84f400d 079/431: README: improvments and describe new non-stipple display options, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 213033e60e 100/431: Allow :blend by itself for current depth, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars be6a67cda4 093/431: Update README.md,
ELPA Syncer <=
- [elpa] externals/indent-bars 4501c7e884 119/431: ts-lang -> ts-parser: cache parser instead of lang, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 026ee80a27 028/431: commentary: improve, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars ca9b1a630f 035/431: setup: slight re-org, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 1215185bfb 033/431: draw: return object (if any), ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 00c4e12bbd 036/431: allow highlighting single blank lines, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 1a5f016740 032/431: blank line bars: correctly mark final line bars, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 5f5dd86810 034/431: always resize stipple on setup, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars 931bf08cb2 045/431: Examples: add default, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars c534bb5b5d 056/431: Minor README tweak, ELPA Syncer, 2024/09/16
- [elpa] externals/indent-bars a9381135ff 051/431: Update README.md, ELPA Syncer, 2024/09/16