summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex')
-rw-r--r--Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex38
1 files changed, 34 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex b/Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex
index 8614827a24f..612ab5baf29 100644
--- a/Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex
+++ b/Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex
@@ -80,6 +80,7 @@ Each of these
The package provides a number of options
for handling groups.
\end{quote}
+\enlargethispage{1.4\baselineskip}
\tableofcontents
@@ -299,8 +300,8 @@ An integer option, call it \textit{n}, takes the
The \texttt{[x]} option employs the \macname{expanded} primitive to maximally
expand the argument before appending it to \macname{cytoks}.
-The \texttt{[x]} option will prove useful when the \Character{} directive involves
- a transformation that is fully expandable.
+The \texttt{[x]} option will prove useful when the \Character{} or other
+ directives involve a transformation that is fully expandable.
Its use will allow the expanded
result of the transformation to be placed in the token register, rather
than the unexpanded transformation instructions.
@@ -464,6 +465,35 @@ i)~implicit grouping tokens (e.g., \macname{bgroup} and \macname{egroup})
ii)~implicit space tokens (e.g., \macname{@sptoken}) will be processed
by the \Space{} directive.
+\subsubsection{Active-Implicit Tokens, Including Spaces}
+
+One may occasionally run across a token that is both active and implicit.
+For example, in the following code, \texttt{Q} is made both active and implicit:
+
+\begin{verbbox}[\vbdelim]
+\catcode`Q=\active
+\let Qx
+\end{verbbox}
+\medskip\theverbbox\medskip\noindent
+
+\noindent
+In general, both \macname{ifactivetok} and \macname{ifimplicittok}
+ tests can be performed together to determine such cases.
+
+This is true even in the case of active-implicit catcode-10 spaces, which
+ are always processed through the Space directive.
+However, because of the process \TokCycle{} uses in digesting space
+ tokens, the actual token passed to the Space directive (so-called
+ \verb|#1|), when an active-implicit space is encountered in the input
+ stream, is a generic implicit space token named \macname{tc@sptoken}.
+However, the catcode-12 version of the active character that
+ produced it will be, for that moment, retained in a definition
+ named \macname{theactivespace}.
+This can be useful if detokenization is required of the spaces.
+Such an example is described in the \texttt{tokcycle-examples}
+ adjunct document.
+
+
\subsubsection{Parameter (cat-6) tokens (e.g., \texttt{\#}): \macname{ifcatSIX}}
Typically, category-code 6 tokens (like \texttt{\#}) are used to
@@ -589,7 +619,7 @@ What follows are the known limitations of the package.
Surely, there are more cases associated with arcane catcode-changing
syntax that are not accounted for;
I encourage you to bring them to my attention.
-If I can't fix them, I can at least disclaim and declaim them.
+If I can't fix them, I can at least disclaim and declaim them below:
\begin{itemize}
@@ -633,7 +663,7 @@ The \texttt{tex.stackexchange} site provides a wonderful
\section*{Source Code}
\Large\texttt{tokcycle.sty}
-\verbfilenobox[\footnotesize]{tokcycle.sty}\vspace{2in}
+\verbfilenobox[\footnotesize]{tokcycle.sty}\vspace{0.5in}
\noindent\texttt{tokcycle.tex}
\verbfilenobox[\footnotesize]{tokcycle.tex}