knowledge (22nov18)

git-svn-id: svn://tug.org/texlive/trunk@49224 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 9 insertions, 5 deletions

diff --git a/Master/texmf-dist/doc/latex/knowledge/knowledge.tex b/Master/texmf-dist/doc/latex/knowledge/knowledge.tex
index 9739fd57bc4..256c97f0b11 100644
--- a/Master/texmf-dist/doc/latex/knowledge/knowledge.tex
+++ b/Master/texmf-dist/doc/latex/knowledge/knowledge.tex
@@ -688,8 +688,9 @@ This is essentially a list for personal referencing of what has to be done.
 \item[2018-02-21] Bug correction concerning the activation of scopes.
 \item[2018-02-21] Documentation improvement for "Emacs" (thanks to Michaël Cadilhac).
 \item[2018-02-24] Documentation improvement for the environment "thebibliography@@env".
-\item[2018-05-17] Correction to be compatible with the lastest version of "expl3@@package" (thanks to Leo Stefanesco).
+\item[2018-05-17] Correction to be compatible with the latest version of "expl3@@package" (thanks to Leo Stefanesco).
 \item[2018-07-26] Compatibility with utf8 symbols in labels (thanks to Yves Guiraud).
+\item[2018-11-21] Corrected the behavior of "makeidx@@package" (thanks to Sylvain Schmitz).
 \end{compactdesc}
 \normalsize
 %\restoregeometry
@@ -2086,10 +2087,13 @@ or by loading the \kl(package){makeidx} before the "knowledge@@package" package.
 When activated, it becomes possible to trigger the \cs{\index} command when a \cs{\kl} command is used.
 The following \kl[\knowledge directives]{directives} are to be used:
 \begin{description}
-\itemAP[\intro{index=}] is the version that uses the standard syntax of the \cs{\index} parameter.
-\itemAP[\intro{index key=}] takes as argument the \kl{index key}: a text that is used for identifying the \kl{index entry} (usually an accent free version of it).
-\itemAP[\intro{index parent key=}] makes the \kl{index entry} be a subentry of the given \kl{main index entry}.
-\itemAP[\intro{index style=}] makes the \kl{index entry} be a subentry of the given \kl{main index entry}.
+\itemAP[\intro{index=}] is the text typeset in the index. It uses the standard syntax of the \cs{\index} command. By default, it is the knowledge name itself. You can use the full syntax of \cs{\index} in it, i.e. using `!' and `@'.
+\itemAP[\intro{index key=}] takes as argument the \kl{index key}: a text that is used for identifying the \kl{index entry} (usually an accent free version of it).  You can use `!' in it, as long as it does not clash with "index=" in order to avoid clashes.
+\itemAP[\intro{index parent key=}] makes the \kl{index entry} be a subentry of the given \kl{main index entry} (a replacement of `!'). Once more, it should not clash with "index=" and "index key=".
+\itemAP[\intro{index style=}] is followed by a token (without the scape character) that will be used for displaying the number (e.g. "index style="\texttt{textbf}). Usually, this is to be used in order to typeset in a particular manner the knowledges in the index when introduced. Thus, by default, the \cs{\intro}, \cs{\reintro} and \cs{\phantomintro} command use the command \csintro{\knowledgeIntroIndexStyle}. Hence, you can use for instance:
+\begin{code}[8cm]
+\cs\def\cs\knowledgeIntroIndexStyle\#1\{\cs\fbox\{\#1\}\}
+\end{code}
 \end{description}