diff options
author | Karl Berry <karl@freefriends.org> | 2020-10-01 21:05:19 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-10-01 21:05:19 +0000 |
commit | ac45ed8c9c41ead15554f580f98dac4fd93a21b8 (patch) | |
tree | debbcd7c58017a3fa625cdbb027e317040c97e3a /Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex | |
parent | e66d6693f79686059c6e9fdf9eab8db3b0077c44 (diff) |
tokcycle (1oct20)
git-svn-id: svn://tug.org/texlive/trunk@56501 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/tokcycle/tokcycle-doc.tex | 38 |
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} |