[elpa] externals/marginalia 0641467 144/241: convert readme to org in preparation of info file

[Stefan Monnier]

branch: externals/marginalia
commit 06414677d570d2a95f9880f4cdc420118efe34e5
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>

    convert readme to org in preparation of info file
---
 README.md  | 67 ------------------------------------------------------
 README.org | 77 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 77 insertions(+), 67 deletions(-)

diff --git a/README.md b/README.md
deleted file mode 100644
index a873e38..0000000
--- a/README.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# marginalia.el - Marginalia in the minibuffer
-
-[![](https://melpa.org/packages/marginalia-badge.svg)](https://melpa.org/#/marginalia)
-
-This package provides `marginalia-mode` which adds marginalia to the minibuffer
-completions. [Marginalia](https://en.wikipedia.org/wiki/Marginalia) are marks 
or
-annotations placed at the margin of the page of a book or in this case helpful
-colorful annotations placed at the margin of the minibuffer for your completion
-candidates. Marginalia can only add annotations to be displayed with the
-completion candidates. It cannot modify the appearance of the candidates
-themselves, which are shown as supplied by the original commands.
-
-The annotations are added based on the completion category. For example
-`find-file` reports the `file` category and `M-x` reports the `command`
-category. You can choose between more or less detailed annotators, by setting
-the variable `marginalia-annotators` or by invoking the command
-`marginalia-cycle`.
-
-Since many commands do not report a completion category themselves, Marginalia
-provides a classifier system, which tries to guess the correct category based
-for example on the prompt (see the variable `marginalia-prompt-categories`).
-Usually these heuristic classifiers work well, but if they do not there is
-always the possibility to overwrite categories by command name. This way you 
can
-associate a fixed category with the completion initiated by the command (see 
the
-variable `marginalia-command-categories`). The list of available classifiers is
-specified by the variable `marginalia-classifiers`.
-
-![marginalia-mode with 
Selectrum](https://github.com/minad/marginalia/blob/main/marginalia-mode.png?raw=true)
-
-## Configuration
-
-It is recommended to use Marginalia together with either the
-[Selectrum](https://github.com/raxod502/selectrum) or the
-[Icomplete-vertical](https://github.com/oantolin/icomplete-vertical) completion
-system. Furthermore Marginalia can be combined with
-[Embark](https://github.com/oantolin/embark) for action support and
-[Consult](https://github.com/minad/consult), which provides many useful
-commands.
-
-~~~ elisp
-;; Enable richer annotations using the Marginalia package
-(use-package marginalia
-  :bind (:map minibuffer-local-map
-              ("C-M-a" . marginalia-cycle)
-         ;; When using the Embark package, you can bind `marginalia-cycle' as 
an Embark action!
-         ;;:map embark-general-map
-         ;;     ("A" . marginalia-cycle)
-        )
-
-  ;; The :init configuration is always executed (Not lazy!)
-  :init
-
-  ;; Must be in the :init section of use-package such that the mode gets
-  ;; enabled right away. Note that this forces loading the package.
-  (marginalia-mode)
-
-  ;; When using Selectrum, ensure that Selectrum is refreshed when cycling 
annotations.
-  (advice-add #'marginalia-cycle :after
-              (lambda () (when (bound-and-true-p selectrum-mode) 
(selectrum-exhibit))))
-
-  ;; Prefer richer, more heavy, annotations over the lighter default variant.
-  ;; E.g. M-x will show the documentation string additional to the keybinding.
-  ;; By default only the keybinding is shown as annotation.
-  ;; Note that there is the command `marginalia-cycle' to
-  ;; switch between the annotators.
-  ;; (setq marginalia-annotators '(marginalia-annotators-heavy 
marginalia-annotators-light nil)))
-~~~
diff --git a/README.org b/README.org
new file mode 100644
index 0000000..a4524de
--- /dev/null
+++ b/README.org
@@ -0,0 +1,77 @@
+* marginalia.el - Marginalia in the minibuffer
+  :PROPERTIES:
+  :CUSTOM_ID: marginalia.el---marginalia-in-the-minibuffer
+  :END:
+
+[[https://melpa.org/#/marginalia][[[https://melpa.org/packages/marginalia-badge.svg]]]]
+
+This package provides =marginalia-mode= which adds marginalia to the
+minibuffer completions.
+[[https://en.wikipedia.org/wiki/Marginalia][Marginalia]] are marks or
+annotations placed at the margin of the page of a book or in this case
+helpful colorful annotations placed at the margin of the minibuffer for
+your completion candidates. Marginalia can only add annotations to be
+displayed with the completion candidates. It cannot modify the
+appearance of the candidates themselves, which are shown as supplied by
+the original commands.
+
+The annotations are added based on the completion category. For example
+=find-file= reports the =file= category and =M-x= reports the =command=
+category. You can choose between more or less detailed annotators, by
+setting the variable =marginalia-annotators= or by invoking the command
+=marginalia-cycle=.
+
+Since many commands do not report a completion category themselves,
+Marginalia provides a classifier system, which tries to guess the
+correct category based for example on the prompt (see the variable
+=marginalia-prompt-categories=). Usually these heuristic classifiers
+work well, but if they do not there is always the possibility to
+overwrite categories by command name. This way you can associate a fixed
+category with the completion initiated by the command (see the variable
+=marginalia-command-categories=). The list of available classifiers is
+specified by the variable =marginalia-classifiers=.
+
+#+CAPTION: marginalia-mode with Selectrum
+[[https://github.com/minad/marginalia/blob/main/marginalia-mode.png?raw=true]]
+
+** Configuration
+   :PROPERTIES:
+   :CUSTOM_ID: configuration
+   :END:
+
+It is recommended to use Marginalia together with either the
+[[https://github.com/raxod502/selectrum][Selectrum]] or the
+[[https://github.com/oantolin/icomplete-vertical][Icomplete-vertical]]
+completion system. Furthermore Marginalia can be combined with
+[[https://github.com/oantolin/embark][Embark]] for action support and
+[[https://github.com/minad/consult][Consult]], which provides many
+useful commands.
+
+#+BEGIN_EXAMPLE
+    ;; Enable richer annotations using the Marginalia package
+    (use-package marginalia
+      :bind (:map minibuffer-local-map
+                  ("C-M-a" . marginalia-cycle)
+             ;; When using the Embark package, you can bind `marginalia-cycle' 
as an Embark action!
+             ;;:map embark-general-map
+             ;;     ("A" . marginalia-cycle)
+            )
+
+      ;; The :init configuration is always executed (Not lazy!)
+      :init
+
+      ;; Must be in the :init section of use-package such that the mode gets
+      ;; enabled right away. Note that this forces loading the package.
+      (marginalia-mode)
+
+      ;; When using Selectrum, ensure that Selectrum is refreshed when cycling 
annotations.
+      (advice-add #'marginalia-cycle :after
+                  (lambda () (when (bound-and-true-p selectrum-mode) 
(selectrum-exhibit))))
+
+      ;; Prefer richer, more heavy, annotations over the lighter default 
variant.
+      ;; E.g. M-x will show the documentation string additional to the 
keybinding.
+      ;; By default only the keybinding is shown as annotation.
+      ;; Note that there is the command `marginalia-cycle' to
+      ;; switch between the annotators.
+      ;; (setq marginalia-annotators '(marginalia-annotators-heavy 
marginalia-annotators-light nil)))
+#+END_EXAMPLE