diff options
author | Karl Berry <karl@freefriends.org> | 2016-02-12 00:26:01 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-02-12 00:26:01 +0000 |
commit | 07d426b145a3c2e39a7a85b56dc211f9fbd0a0df (patch) | |
tree | d4809cc574ab5869f6e31147aa716fc754ca3c7e /Master/texmf-dist/doc/latex/ran_toks/README.md | |
parent | 89bd11ec39b2b88d322dca36ee0db6e01050dda3 (diff) |
ran_toks (10feb16)
git-svn-id: svn://tug.org/texlive/trunk@39684 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/ran_toks/README.md')
-rw-r--r-- | Master/texmf-dist/doc/latex/ran_toks/README.md | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/ran_toks/README.md b/Master/texmf-dist/doc/latex/ran_toks/README.md new file mode 100644 index 00000000000..ca048779fa6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/ran_toks/README.md @@ -0,0 +1,52 @@ +The ran_toks Package +Author: D. P. Story +Dated: 2016/02/06 +Version: v1.0e + +This short package, with minimal requirements, defines macros for +randomizing a list of tokens. There are two approaches: + + 1. \ranToks{myList}{ {One}{Two}{Three}{Four}{Five} }: Here the token + list occurs as the argument of the \ranToks command. myList is the + name of this list. The tokens can be anything that \TeX accepts as + a macro argument, this excludes \verb, for example. + + 2. Another construct writes verbatim to the disk, so the tokens can + be of arbitrary size, and include \verb and the verbatim + environment, for example, + + \bRTVToks{myStuff} + \begin{rtVW} + The inline answer is \verb!x^3! + \end{rtVW} + \begin{rtVW} + This is my stuff, leave it alone! + \end{rtVW} + ... + \begin{rtVW} + The verbatim listing is + \begin{verbatim} + \bRTVToks{myStuff} + ... (missing stuff) + \eRTVToks + \end{verbatim} + \end{rtVW} + \eRTVToks + +To actually see the randomized list, use the \useRanTok{num} command: For +myList, we would write \useRanTok{1}, \useRanTok{2}, \useRanTok{3}, +\useRanTok{4}, and {\useRanTok{5}} to obtain a random listing of the +tokens in the myList list. + +For user of AeB or eqexam, the latter structure can be used to randomize +the order of the questions on a quiz or exam. + +If the ran_toks.sty file is not provided in the distribution, then tex (not latex) +the file ran_toks.dtx. + +Enjoy! + +Now, I must get back to my retirement. + +dps +2016/02/08 |