readarray (2apr13)

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

2 files changed, 33 insertions, 1 deletions

diff --git a/Master/texmf-dist/doc/latex/readarray/readarray.pdf b/Master/texmf-dist/doc/latex/readarray/readarray.pdf
index 41dd33dc151..68170f72cff 100644
--- a/Master/texmf-dist/doc/latex/readarray/readarray.pdf
+++ b/Master/texmf-dist/doc/latex/readarray/readarray.pdf
diff --git a/Master/texmf-dist/doc/latex/readarray/readarray.tex b/Master/texmf-dist/doc/latex/readarray/readarray.tex
index 9c00b4fa9de..708a1afe707 100644
--- a/Master/texmf-dist/doc/latex/readarray/readarray.tex
+++ b/Master/texmf-dist/doc/latex/readarray/readarray.tex
@@ -1,5 +1,5 @@
 \documentclass{article}
-\def\version{1.0}
+\def\version{1.01}
 %% Copyright 2013 Steven B. Segletes
 %
 % This work may be distributed and/or modified under the
@@ -13,6 +13,8 @@
 % This work has the LPPL maintenance status `maintained'.
 %
 % The Current Maintainer of this work is Steven B. Segletes.
+% Revisions:
+% v1.01 Documentation revision
 
 \parskip 1em
 \parindent 0em
@@ -333,6 +335,36 @@ if any error condition arises.  It could be a blank \vb|[]|, a black
 box \vb|[\rule{1ex}{1ex}]|, or anything else that makes sense for the
 application.
 
+The\verb|\Arrayij| and \verb|\Arrayijk| commands may, of course, be
+placed as arguments of \verb|\def| commands.  They, cannot, however, be
+placed into an \verb|\edef|.  If the user has need to place the
+array-element content into an \verb|\edef| (and assuming that the
+actual array-element content is suitable for an \verb|\edef|), the
+following approach may be employed.  The contents of an array which
+would otherwise be accessed by the command
+{\itshape\vb|\Arrayij{|identifier\vb|}{|row\vb|}{|column\vb|}|\upshape}
+can be accessed directly with the command
+``\itshape\vb|\|identifier\vb|X|roman-row\vb|X|roman-column\upshape'',
+where \textit{roman-row} and \textit{roman-column} indicate that the row
+and column numbers are expressed in lower-case roman numerals.  Thus,
+even if \textit{row} and/or \textit{column} are obtained by way of a
+mathematical calculation, they can be placed into an \verb|\edef| token
+using the following syntax:\\
+  \rl\itshape\vb|\edef\tokenname{\csname %|\\
+  \rl\rl\rl identifier\vb|X\roman{|row\vb|}X\roman{|column%
+  \vb|}\endcsname}|\upshape\\
+For 3-D arrays, the corresponding command is 
+``\itshape\vb|\|identifier\vb|X|roman-plane\vb|X|roman-row\vb|X|%
+  roman-column\upshape''.
+Therefore, the \verb|\edef| may be accomplished via\\
+  \rl\itshape\vb|\edef\tokenname{\csname %|\\
+  \rl\rl\rl identifier\vb|X\roman{|plane\vb|}X\roman{|row\vb|}X\roman{|%
+  column\vb|}\endcsname}|\upshape\\
+Note, however, that no error bounds-checking is performed when command
+syntax such as 
+``\itshape\vb|\|identifier\vb|X|roman-plane\vb|X|roman-row\vb|X|%
+roman-column\upshape'' is employed.
+
 The engine for the {\rdar} package is the \vb|\getargsC|
 \margcmd{getargsC} command, based on the \vb|\getargs| command found
 in the \textsf{stringstrings} package.  This command has been herein