[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/marginalia 7d4f07f 146/241: add marginalia.texi
From: |
Stefan Monnier |
Subject: |
[elpa] externals/marginalia 7d4f07f 146/241: add marginalia.texi |
Date: |
Fri, 28 May 2021 20:49:15 -0400 (EDT) |
branch: externals/marginalia
commit 7d4f07fbdd0580322e09c2a39d99d0af9f1d02a7
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>
add marginalia.texi
---
marginalia.texi | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 112 insertions(+)
diff --git a/marginalia.texi b/marginalia.texi
new file mode 100644
index 0000000..db43958
--- /dev/null
+++ b/marginalia.texi
@@ -0,0 +1,112 @@
+\input texinfo @c -*- texinfo -*-
+@c %**start of header
+@setfilename README.info
+@settitle
+@documentencoding UTF-8
+@documentlanguage en
+@c %**end of header
+
+@finalout
+@titlepage
+@title
+@end titlepage
+
+@contents
+
+@ifnottex
+@node Top
+@top
+@end ifnottex
+
+@menu
+* marginalia.el - Marginalia in the minibuffer: marginaliael - Marginalia in
the minibuffer.
+
+@detailmenu
+--- The Detailed Node Listing ---
+
+marginalia.el - Marginalia in the minibuffer
+
+* Configuration::
+
+@end detailmenu
+@end menu
+
+@node marginaliael - Marginalia in the minibuffer
+@chapter marginalia.el - Marginalia in the minibuffer
+
+@uref{https://melpa.org/#/marginalia,
file:https://melpa.org/packages/marginalia-badge.svg}
+
+This package provides @samp{marginalia-mode} which adds marginalia to the
+minibuffer completions.
+@uref{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
+@samp{find-file} reports the @samp{file} category and @samp{M-x} reports the
@samp{command}
+category. You can choose between more or less detailed annotators, by
+setting the variable @samp{marginalia-annotators} or by invoking the command
+@samp{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
+@samp{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
+@samp{marginalia-command-categories}). The list of available classifiers is
+specified by the variable @samp{marginalia-classifiers}.
+
+@uref{https://github.com/minad/marginalia/blob/main/marginalia-mode.png?raw=true}
+
+@menu
+* Configuration::
+@end menu
+
+@node Configuration
+@section Configuration
+
+It is recommended to use Marginalia together with either the
+@uref{https://github.com/raxod502/selectrum, Selectrum} or the
+@uref{https://github.com/oantolin/icomplete-vertical, Icomplete-vertical}
+completion system. Furthermore Marginalia can be combined with
+@uref{https://github.com/oantolin/embark, Embark} for action support and
+@uref{https://github.com/minad/consult, Consult}, which provides many
+useful commands.
+
+@lisp
+;; 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 lisp
+
+@bye
\ No newline at end of file
- [elpa] externals/marginalia ac53a00 097/241: optimize marginalia--truncate, (continued)
- [elpa] externals/marginalia ac53a00 097/241: optimize marginalia--truncate, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 7743fd7 109/241: add marginalia-annotate-char, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 78f676e 122/241: marginalia-annotate-package: use package-desc-status, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 0c5521a 126/241: fix window context for Embark Occur, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia b75f43e 128/241: fix #34, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia e132638 134/241: marginalia-annotate-buffer: show remote indicator, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 4d4f639 140/241: fix project file/buffer annotations for consult-buffer, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 5a644d8 143/241: abbreviate list-buffers-directory, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 2a9df61 145/241: readme fixes, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 51b6dbf 147/241: readme fixes, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 7d4f07f 146/241: add marginalia.texi,
Stefan Monnier <=
- [elpa] externals/marginalia a2f9242 154/241: fix marginalia-annotate-bookmark for front context with newlines, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia d0c0005 166/241: update readme, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia fcf41c5 167/241: Version 0.2, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 5a00dcb 170/241: marginalia-annotate-consult-buffer: remove width, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia e15b8b2 174/241: readme: update marginalia keybinding, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 55bfd5f 176/241: do not unnecessarily use defsubst, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia dcdcd5d 179/241: consistently use \` and \' for regexps, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 51f7509 184/241: Fix #57 - protect marginalia--symbol-class equality check, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 3e061a0 185/241: marginalia-annotate-bookmark: Handle non-symbol bookmark handlers, Stefan Monnier, 2021/05/28
- [elpa] externals/marginalia 58f397d 187/241: update readme, Stefan Monnier, 2021/05/28