[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/eglot-inactive-regions 3876101626 31/66: Update README.
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/eglot-inactive-regions 3876101626 31/66: Update README. |
Date: |
Fri, 6 Dec 2024 06:59:54 -0500 (EST) |
branch: elpa/eglot-inactive-regions
commit 38761016260b9906b6e4742c97ed2bbdafb19135
Author: Filippo Argiolas <filippo.argiolas@gmail.com>
Commit: Filippo Argiolas <filippo.argiolas@gmail.com>
Update README.
---
README.md | 21 ++++++++++++++++-----
1 file changed, 16 insertions(+), 5 deletions(-)
diff --git a/README.md b/README.md
index a9ce9600ac..8aea50e1dd 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,11 @@
## About
-An eglot extension to support clangd inactiveRegions extension
-introduced in clangd-17. Highlights inactive code in a LSP aware way.
+Eglot extension to support the new clangd inactiveRegions LSP
+capability introduced in clangd-17.
+
+Highlights inactive code in a LSP aware way, taking into account
+compile time includes and defines for current project.
Listens to inactiveRegions notifications and shades them with one of
the available-methods:
@@ -18,7 +21,10 @@ the available-methods:
#### `darken-foreground` method, gruvbox dark theme, 30% opacity
-Inactive regions are provided by the language server so they will honor your
include paths and compile time defines. Here I'm looking at my `emacs-29`
branch configured to build on macos.
+Inactive regions are provided by the language server so they will
+honor your include paths and compile time defines. Here I'm looking at
+my `emacs-29` branch configured to build on MacOS and you can see
+Windows code is correctly disabled.
![darken-foreground](./screenshots/darken-foreground-gruvbox-dark.png)
@@ -28,6 +34,10 @@ Inactive regions are provided by the language server so they
will honor your inc
## Installation
+You will need emacs 29.1 and clangd-17. The latter is not released yet
+but they provide git snapshots with standalone binaries you can just
+copy in your path.
+
At the moment the package is little more than an experiment. If you
want to try it just copy the .el file somewhere in the load path.
@@ -49,10 +59,11 @@ Feedback, issues and pull requests more than welcome!
As far as I know Emacs doesn't have a way to set foreground text
opacity. Best would be a face attribute so that you can set it in an
-overlay covering each whole region and be done with it.
+overlay covering each whole region and be done with it. Unfortunately
+there is no attribute for this yet.
Hence `darken-foreground` method is a fragile and inefficient hack around
-fontification: for each inactive region looks for symbols with
+fontification: for each inactive region it looks for symbols with
different faces and applies to each of them a different overlay with a
dimmed foreground color.
- [nongnu] branch elpa/eglot-inactive-regions created (now 2c83a3230d), ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions f47d728c65 11/66: Stage basic README, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 65fbd7a7a1 08/66: Support for different shading methods to render inactive regions, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions ea8da46342 01/66: Initial commit, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 9dba1b222d 14/66: Check for valid ranges when setting parameters, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 4f5ab3203c 17/66: No need to copy-tree ranges, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 5528f4d3e1 03/66: fix gpl preamble, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 4fc6480bed 18/66: Move forward if forward-same-syntax does not, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 2e52c1a10a 19/66: Use my own forward function, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 3876101626 31/66: Update README.,
ELPA Syncer <=
- [nongnu] elpa/eglot-inactive-regions b0ade8c12e 21/66: Handle face list properties, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 3d3280c415 48/66: rename to eglot-inactive-regions.el, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 475864a1a3 65/66: exclude screenshots from the tarball, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 17c9db32d3 02/66: initial commit, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions e15124a898 07/66: Rewrite the darkening logic using fontify-region, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions e7be73b354 15/66: Invert shading factor, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions b81249c566 23/66: Update README with caveats section, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 4b01aba42f 29/66: Fix package-lint warnings, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 2346944d4b 05/66: Add clean up and refresh functions, ELPA Syncer, 2024/12/06
- [nongnu] elpa/eglot-inactive-regions 3ba8e528f1 06/66: allow to change opacity on the fly, ELPA Syncer, 2024/12/06