From 30565a139dcde0fedc3d9f9348d658f32ee14430 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maximilian=20Ke=C3=9Fler?= <git@maximilian-kessler.de>
Date: Sun, 30 Jan 2022 19:13:26 +0100
Subject: [PATCH] document vocab package

---
 doc/indexing/vocab/.latexmkrc |  4 +++
 doc/indexing/vocab/Makefile   |  8 +++++
 doc/indexing/vocab/vocab.tex  | 55 +++++++++++++++++++++++++++++++++++
 3 files changed, 67 insertions(+)
 create mode 100644 doc/indexing/vocab/.latexmkrc
 create mode 100644 doc/indexing/vocab/Makefile
 create mode 100644 doc/indexing/vocab/vocab.tex

diff --git a/doc/indexing/vocab/.latexmkrc b/doc/indexing/vocab/.latexmkrc
new file mode 100644
index 0000000..4c81cd6
--- /dev/null
+++ b/doc/indexing/vocab/.latexmkrc
@@ -0,0 +1,4 @@
+$makeindex = "makeindex -s gind.ist %O -o %D %S";
+$clean_ext .= ' glo';
+$clean_ext .= ' hd';
+$clean_ext .= ' ins';
diff --git a/doc/indexing/vocab/Makefile b/doc/indexing/vocab/Makefile
new file mode 100644
index 0000000..e174370
--- /dev/null
+++ b/doc/indexing/vocab/Makefile
@@ -0,0 +1,8 @@
+doc:
+	latexmk
+
+full:
+	latexmk -gg
+
+clean:
+	latexmk -C
diff --git a/doc/indexing/vocab/vocab.tex b/doc/indexing/vocab/vocab.tex
new file mode 100644
index 0000000..6085d79
--- /dev/null
+++ b/doc/indexing/vocab/vocab.tex
@@ -0,0 +1,55 @@
+\documentclass[full]{l3doc}
+
+\title{The \pkg{mkessler-vocab} package}
+\author{Maximilian Keßler}
+
+\usepackage{mkessler-vocab}
+
+\begin{document}
+
+\maketitle
+
+\begin{abstract}
+  When defining lots of new notions in a document,
+  it is useful to index these at the point of their definition,
+  to let users easily look up the spots where notions are
+  introduced in a document.
+
+  Also, one often wants to highlight these when defining a new notion.
+
+  We combined both approaches.
+\end{abstract}
+
+\begin{documentation}
+
+\section{Macros}
+\begin{function}{\vocab}
+  \begin{syntax}
+    \cs{vocab}\oarg{index entry}\marg{vocab}
+  \end{syntax}
+
+  Highlights \meta{vocab} in the text (bold blue).
+  Also indexes this under \oarg{index entry}.
+
+  If \oarg{index entry} is empty, \meta{vocab} itself will appear in the index.
+\end{function}
+
+\begin{function}{\printvocabindex, \PrintVocabIndex}
+  Prints the index of vocabs.
+
+  The \cs{printvocabindex} is deprecated,
+  use the better named \cs{PrintVocabIndex}.
+\end{function}
+
+\section{Package options}
+
+You can specify the two options \texttt{index} and \texttt{noindex}.
+The default is \texttt{noindex}.
+
+Index entries are only generated if \texttt{index} has been specified.
+Of course, \cs{PrintVocabIndex} results in an error if the package
+has been loaded with \texttt{noindex}.
+  
+\end{documentation}
+
+\end{document}