summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/ran_toks/README.md
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/ran_toks/README.md
Initial commit
Diffstat (limited to 'macros/latex/contrib/ran_toks/README.md')
-rw-r--r--macros/latex/contrib/ran_toks/README.md52
1 files changed, 52 insertions, 0 deletions
diff --git a/macros/latex/contrib/ran_toks/README.md b/macros/latex/contrib/ran_toks/README.md
new file mode 100644
index 0000000000..6e47bf5109
--- /dev/null
+++ b/macros/latex/contrib/ran_toks/README.md
@@ -0,0 +1,52 @@
+The ran_toks Package
+Author: D. P. Story
+Dated: 2017/05/04
+
+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 users of AeB or eqexam, the latter structure can be used to randomize
+the order of the questions on a quiz or exam.
+
+What's new in v1.1: Added the convenience command \useTheseDBs to input files for
+an application to constructing exams (using eqexam) from a series of DB files. Refer to the
+new demo file mc-db.tex.
+
+Enjoy!
+
+Now, I must get back to my retirement.
+
+dps
+