[nongnu] elpa/eglot-inactive-regions f47d728c65 11/66: Stage basic README

[ELPA Syncer]

branch: elpa/eglot-inactive-regions
commit f47d728c652ce5d0a1351d1babe3e57ef16856fe
Author: Filippo Argiolas <filippo.argiolas@gmail.com>
Commit: Filippo Argiolas <filippo.argiolas@gmail.com>

    Stage basic README
---
 README.md                                       |  43 ++++++++++++++++++++++++
 screenshots/darken-foreground-gruvbox-dark.png  | Bin 0 -> 325931 bytes
 screenshots/shade-background-modus-operandi.png | Bin 0 -> 380856 bytes
 3 files changed, 43 insertions(+)

diff --git a/README.md b/README.md
new file mode 100644
index 0000000000..bb5522ee7c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+# clangd-inactive-regions.el
+
+## About
+
+An eglot extension to support clangd inactiveRegions extension
+introduced in clangd-17. Highlights inactive code in a LSP aware way.
+
+Listens to inactiveRegions notifications and shades them with one of
+the available-methods:
+
+* `darken-foreground` makes inactive code semitransparent blending
+  current foreground and background colors
+* `shade-background` makes inactive code background slighly darker or
+  lighter depending on current theme
+* `shadow` applies the shadow face to inactive code
+
+## Screenshots
+
+#### `darken-foreground` method, gruvbox dark theme
+
+![darken-foreground](./screenshots/darken-foreground-gruvbox-dark.png)
+
+#### `shade-background` method, modus operandi theme
+
+![shade-background](./screenshots/shade-background-modus-operandi.png)
+
+## Installation
+
+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.
+
+Feedback, issues and pull requests more than welcome!
+
+## Usage
+
+```lisp
+(use-package clangd-inactive-regions
+  :ensure nil
+  :init
+  (setq clangd-inactive-regions-method "darken-foreground")
+  (setq clangd-inactive-regions-opacity 0.55)
+  (add-hook 'eglot-managed-mode-hook #'clangd-inactive-regions-mode))
+```
diff --git a/screenshots/darken-foreground-gruvbox-dark.png 
b/screenshots/darken-foreground-gruvbox-dark.png
new file mode 100644
index 0000000000..0c0962d125
Binary files /dev/null and b/screenshots/darken-foreground-gruvbox-dark.png 
differ
diff --git a/screenshots/shade-background-modus-operandi.png 
b/screenshots/shade-background-modus-operandi.png
new file mode 100644
index 0000000000..f0bbb7f3eb
Binary files /dev/null and b/screenshots/shade-background-modus-operandi.png 
differ