summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-04-02 22:34:06 +0000
committerKarl Berry <karl@freefriends.org>2013-04-02 22:34:06 +0000
commitb2d34d6482b1d11c1f493baab7ca6cd7a33b27d7 (patch)
tree0b844b0a3d299e6b6bd885de42d2e45d636b15d7 /Master/texmf-dist/doc/latex
parentcb2f01ad5ab738ed5d11d0fe31939b454c46ad33 (diff)
readarray (2apr13)
git-svn-id: svn://tug.org/texlive/trunk@29614 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/readarray/readarray.pdfbin191254 -> 192524 bytes
-rw-r--r--Master/texmf-dist/doc/latex/readarray/readarray.tex34
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
Binary files differ
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