[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/marginalia 0641467 144/241: convert readme to org in pr
From: |
Stefan Monnier |
Subject: |
[elpa] externals/marginalia 0641467 144/241: convert readme to org in preparation of info file |
Date: |
Fri, 28 May 2021 20:49:15 -0400 (EDT) |
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
- [elpa] externals/marginalia 6e8ba6d 079/241: add marginalia-annotate-imenu, (continued)
- [elpa] externals/marginalia 6e8ba6d 079/241: add marginalia-annotate-imenu, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia fbd898d 087/241: rename marginalia-annotate-command to marginalia-annotate-binding, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia e833584 103/241: improve marginalia-classify-symbol, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 40e2881 112/241: fix marginalia-cycle-annotators such that it works as an embark action, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia b1ccaf8 124/241: readme: more robust selectrum config, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 6a64a59 120/241: marginalia-annotate-minor-mode: add local/global indicator, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 4069094 131/241: get rid of marginalia--buffer-bytes, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 1f2a842 133/241: shorter mode-name, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 18cfe23 136/241: marginalia-annotate-virtual-buffer/marginalia-annotate-minor-mode: no narrow prefix, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 3c80428 141/241: fix #41, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 0641467 144/241: convert readme to org in preparation of info file,
Stefan Monnier <=
- [elpa] externals/marginalia 2a63616 148/241: update texi, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 4019935 157/241: rename virtual-buffer to consult-buffer, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 12fe439 161/241: right-fringe-width - use eq instead of =, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 327ad58 165/241: use aref instead of elt, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 5d15697 169/241: marginalia-annotate-bookmark with no front context still returns filename, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 64fe724 182/241: readme: do not use drawers to prevent export, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 2387cba 186/241: marginalia-annotate-minor-mode: Support longer lighters, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 5159256 220/241: Fix external declaration for selectrum--get-full, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia a081005 215/241: marginalia-annotate-bookmark: Truncate file names (Fix #69), Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia f89974d 222/241: Remove obsolete comment, completion system updates automatically, Stefan Monnier, 2021/05/28