[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/marginalia 496c0e8: README: Add notice for package auth
From: |
ELPA Syncer |
Subject: |
[elpa] externals/marginalia 496c0e8: README: Add notice for package authors |
Date: |
Sun, 19 Dec 2021 06:57:31 -0500 (EST) |
branch: externals/marginalia
commit 496c0e8bc6799bc5a5e066359d23b95090455799
Author: Daniel Mendler <mail@daniel-mendler.de>
Commit: Daniel Mendler <mail@daniel-mendler.de>
README: Add notice for package authors
---
README.org | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/README.org b/README.org
index 49d9ba2..c76de8a 100644
--- a/README.org
+++ b/README.org
@@ -68,6 +68,21 @@ different classifications mean, see the docstring of
~marginalia--symbol-class~.
* Adding custom annotators or classifiers
+*IMPORTANT NOTICE FOR PACKAGE AUTHORS*: The intention of the Marginalia
package is
+to give the user means to overwrite completion categories and to add custom
+annotators for existing commands in their user configuration. Marginalia is a
+user facing package and is not intended to be used as a library. Therefore
+Marginalia does not expose library functions as part of its public API. If you
+add your own completion commands to your package we recommend to specify an
+=annotation-function= or an =affixation-function=, avoiding the Marginalia
+dependency this way. The =annotation-function= is documented in the
[[https://www.gnu.org/software/emacs/manual/html_node/elisp/Completion.html][Elisp
manual]].
+There is an exception to our recommendation: If you want to implement
+annotations for an existing package =hypothetical.el=, which does not have
+annotations and where annotations cannot be added, then the creation of a
+=marginalia-hypothetical.el= package is a good idea, since Marginalia provides
the
+facilities to enhance existing commands from the outside. If you have questions
+feel free to ask on the Marginalia issue tracker!
+
Commands that support minibuffer completion use a completion table of all the
available candidates. Candidates are associated with a *category* such as
=command=,
=file=, =face=, or =variable= depending on what the candidates are. Based on
the
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [elpa] externals/marginalia 496c0e8: README: Add notice for package authors,
ELPA Syncer <=