summaryrefslogtreecommitdiff
path: root/Master/tlpkg/dev/keyword-search/tlmgr-interface.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/dev/keyword-search/tlmgr-interface.txt')
-rw-r--r--Master/tlpkg/dev/keyword-search/tlmgr-interface.txt35
1 files changed, 35 insertions, 0 deletions
diff --git a/Master/tlpkg/dev/keyword-search/tlmgr-interface.txt b/Master/tlpkg/dev/keyword-search/tlmgr-interface.txt
new file mode 100644
index 00000000000..c6405c490d8
--- /dev/null
+++ b/Master/tlpkg/dev/keyword-search/tlmgr-interface.txt
@@ -0,0 +1,35 @@
+How to interface tlmgr search with keywords
+
+new search interface:
+
+tlmgr search <options> <terms>
+
+<options> ::= --global | --word | --list [keywords|functions|characterizations]
+
+<terms> ::= <term> | <term> <terms>
+<term> ::= AND | OR | LEFT | RIGHT
+ keyword=<literal> | function=<levels> |
+ characterization=<levels> |
+ package-name=<literal> | title=<literal> |
+ description=<literal> | file=<literal>
+
+<levels> ::= <level> | <level> " > " <levels>
+<level> ::= <literal>
+
+
+defaults = package-names=ARG OR titles=ARG OR descriptions=ARG
+AND -> conjunction
+OR -> disjunction
+LEFT|RIGHT -> parenthesis for grouping of and and or
+
+<literal> may contain wildcards and it is matched in a glob style (no re!!)
+
+
+example
+ tlmgr search keyword=paragraph AND description=dropped
+should give back the lettrine package
+
+ tlmgr search characterization=bibliography
+searches for all packages with characterization containing anywhere the string
+"bibliography" (case insensitive).
+