texmate update (22sep06)

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

1 files changed, 48 insertions, 50 deletions

diff --git a/Master/texmf-dist/doc/latex/texmate/texmate2manual.tex b/Master/texmf-dist/doc/latex/texmate/texmate2manual.tex
index dca42ce96d5..d0581dbe3fc 100644
--- a/Master/texmf-dist/doc/latex/texmate/texmate2manual.tex
+++ b/Master/texmf-dist/doc/latex/texmate/texmate2manual.tex
@@ -64,7 +64,7 @@ This input stream gives \TeXmate\ the moves of a beautiful miniature (probably h
 
 The only two conventions are the inclusion of all moves between two \DescribeMacro{|}\SpecialIndex{|}"|"'s (``chess mode''), and the separation of moves by spaces. Beyond that, the user is free to add punctuation marks, as inconsistently as he wants, and \TeXmate\ will always produce the same output. (In particular, \acro{PGN} move notation is supported without any change.)
 
-In normal conditions, the "|" is set by default to delimit chess mode. The user commands "\makebarother" and "\makebarchess"\DescribeMacro{\makebarchess}\DescribeMacro{\makebarother}"\makebarchess" toggle the meaning of that character between chess mode and nothing special. 
+In normal conditions, the "|" is set by default to delimit chess mode. The user commands "\makebarother" and "\makebarchess"\DescribeMacro{\makebarchess}\DescribeMacro{\makebarother} toggle the meaning of that character between chess mode and nothing special. 
 
 However, if \TeXmate\ finds that another package has a special use for "|", it will refrain from using it. In that case, chess mode should be entered with through an alternative (which is always available, in any case): the \texttt{texmate} environment ("\begin{texmate}"--"\end{texmate}"). Even then, a "\makebarchess" (by the user) will make "|" open and close chess mode. 
 
@@ -144,7 +144,7 @@ Bf3\#] Nf3+! gxf3 Bxf3 \resigns|
 \bigskip\noindent
 \TeXmate\ provides tools for the handling of diagrams. \DescribeMacro{\toD}"\toD" (meaning something like ``refer to Diagram'') inserts `\textit{(D)}' in the chess text, and saves the position in memory. \DescribeMacro{\makediagrams}Many positions (by default 3, but extendable) can be held in memory, and they are actually typeset by the command "\makediagrams".
 
-"\toD" has an argument: the last move. \TeXmate\ will typeset the last move and put it (by default) below the diagram.
+"\toD" has an argument: the last move. \TeXmate\ will typeset the last move and put it (by default) below the diagram. Note that it will \emph{not} typeset the move directly in the running chess text (thus the move can be different in running text---where it can have annotation symbols---and in the diagram).
 
 \bigskip\noindent
 Adding this to the game, the complete input is:
@@ -165,7 +165,7 @@ Rxf2 gxf2+ Kxf2 Ng4+ Kg3 Qf6 Qf3 Qg7\BBetter] Bg4
 Qe1 Nd4 Nc3\onlymove [h3 Ne2+ Kh1 Rxh3+ gxh3 
 Bf3\#] Nf3+! gxf3 Bxf3 \toD{Bxf3} \resigns|
 
-\begin{figure}
+\begin{figure}[h]
 \makediagrams
 \end{figure}
 \end{verbatim}
@@ -187,14 +187,14 @@ Bf3\#] Nf3+! gxf3 Bxf3 \toD{Bxf3} \resigns|
 \makediagrams
 \end{figure}
 
-This will insert the diagrams at a reasonable (in \LaTeX-insertion scales) place. The appearance of the diagrams can be customized to some extent, as treated in section~\ref{custdiagrams}. 
+This will insert the diagrams at a reasonable (in \LaTeX-insertion scales) place. The appearance of the diagrams can be customized to some extent, as treated in section~\ref{custdiagrams}. "\makediagrams" will center the diagrams automatically, so "\begin{center}" is not necessary.
 
 On the other hand, the starred \DescribeMacro{\toD*}"\toD*"\meta{last move} will not insert ``\textit{(D)}'', but will otherwise do the same as "\toD".
 
 \bigskip\noindent
-\DescribeMacro{\drawdiagram}There is an alternative way of preparing a diagram for typesetting:
+\DescribeMacro{\preparediagram}There is an alternative way of preparing a diagram for typesetting:
 
-"\drawdiagram""{"\meta{diagram header}"}{"\meta{diagram footer}"}"\\
+"\preparediagram""{"\meta{diagram header}"}{"\meta{diagram footer}"}"\\
 sends the current position into diagram cache, not with the usual header and footer (which by default are the players' names and the last move, as explained in section~\ref{custdiagrams}), but with those set directly by the user. This can be done at any point, but it is useful particularly in connection with "\position" (section~\ref{position}).
 
 
@@ -240,10 +240,10 @@ The solution is to open the annotation not with the commentary character, but wi
 \begin{verbatim}
 |e4 e5 Nf3 Nc5 Bc4 Bc5 d3 Nf5 Bg5?! \[| The
 development of the Knight with |Nc3| is more
-urgent. |\] d6...
+urgent. |\] d6...|
 \end{verbatim}
 
-Which produces:
+\noindent which produces:
 
 \SkakOn
 \newgame
@@ -288,7 +288,7 @@ The point is that Black threatens mate with the g3 pawn on h2; White could try t
 \bigskip\noindent
 We can also refine the comment to moves 12 by Black and 13 by White with the specification of the threat. This could not have been done with "\threat" (section~\ref{annotation}), because the threat involves a whole variation, not simply a move. With \DescribeMacro{\Threat}"\Threat<"\meta{threatened variation}">", \TeXmate\ will typeset the \meta{threatened variation} with appropriate move numbers, etc. Unlike "\threat", "\Threat" does not include the \withidea\ sign, but this can be added to the first move if necessary. Sometimes a space must be forced---the idea is that "\Threat" can be used in connection with running text, so nothing is rigidly added. (On the other hand, since this is not a real variation playable on the board, \textsf{skak} is turned off.)
 
-So, by saying `{\ttfamily Nd4 "\Threat<\ \withidea" Ne2+ Kh1 Rxh3+ gxh3 Bf3"\#"] Nc3"\onlymove"}' we get `\SkakOff|\black 12 Nd4 \Threat<\ \withidea Ne2+ Kh1 Rxh3+ gxh3 Bf3\#> Nc3\onlymove|', a better option for these moves than we have had so far.
+So, by saying `{\ttfamily Nd4 "\Threat<\ \withidea" Ne2+ Kh1 Rxh3+ gxh3 Bf3"\#"] Nc3"\onlymove"}' we get `\SkakOff|\black 12 Nd4\Threat<\ \withidea Ne2+ Kh1 Rxh3+ gxh3 Bf3\#> Nc3\onlymove\Threat<Bd5>|', a better option for these moves than we have had so far.
 
 
 \SkakOn
@@ -357,14 +357,14 @@ In view of that, White resigned.|\]\resigns|
 \var h3 Rxh3\threat<Rh1\#>\end{variations}| In view of that, White resigned.|\]\resigns|
 
 \bigskip
-\DescribeMacro{\VariationsEnvironment}If you have loaded the \textsf{enumerate} package, you can say
+\DescribeMacro{\VariationsEnvironment}List environments defined by other packages (\textsf{paralist}, \textsf{enumerate}, etc.) can be used. For example:
 
 \begin{verbatim}
-\renewcommand\VariationsEnvironment{%
-    \begin{enumerate}[a)]}{\end{enumerate}
+\VariationsEnvironment
+    {\begin{enumerate}[a)]}
+    {\end{enumerate}
 \end{verbatim}
 
-\noindent and your alternatives will be numbered accordingly.
 
 \bigskip\noindent
 Different "{variations}" environments can be nested one into another, at least in some combinations (that is, sometimes there are problems, but it's been hard to understand why). It seems that the main requirement is that they don't appear at the same level of commentary. Here is a full analysis from a game that actually calls for commentary this deep. This is the input:
@@ -380,8 +380,8 @@ Different "{variations}" environments can be nested one into another, at least i
 game|\end{variations}] 
 Qg3+ Kh7 [Kf6? Qg5\#] Rb3!!| (threatening mate 
 with |\Threat<Qh3+ Kg7 Rg3+ Kf6 Qh6\#>\[|) and now:
-|\begin{variations}
-\var Bxd6 \[| and now I had calculated 
+|\ahead\begin{variations}
+\var Bxd6 \[| where I had calculated 
     |\ahead\begin{variations*}\var Qh4+ Kg7 Rg3+ Kf7 Qh5+!
     Kf6 Rg6+ Kf7 Rh6+ Ke7 Rh7+|, but  
     |\var Qg5!\end{variations*}\]| 
@@ -401,7 +401,7 @@ with |\Threat<Qh3+ Kg7 Rg3+ Kf6 Qh6\#>\[|) and now:
 This is the position:
 \position[w 34]{3r1r1k/3nbpp/q1nNp/p/PpP1BP/3QB/6PP/1RR3K}
 
-\drawdiagram{Garcia--Winwood}{After 33\dots\bishop e7}
+\preparediagram{Garcia--Winwood}{After 33\dots\bishop e7}
 
 \makediagrams
 
@@ -417,8 +417,8 @@ This is the position:
 game|\end{variations}] 
 Qg3+ Kh7 [Kf6? Qg5\#] Rb3!!| (threatening mate 
 with |\Threat<Qh3+ Kg7 Rg3+ Kf6 Qh6\#>\[|) and now:
-|\begin{variations}
-\var Bxd6 \[| and now I had calculated 
+|\ahead\begin{variations}
+\var Bxd6 \[| where I had calculated 
     |\ahead\begin{variations*}\var\bfseries Qh4+ Kg7 Rg3+ Kf7 Qh5+!%
     Kf6 Rg6+ Kf7 Rh6+ Ke7 Rh7+|, but  
     |\var\bfseries Qg5!\end{variations*}\]| 
@@ -430,7 +430,7 @@ with |\Threat<Qh3+ Kg7 Rg3+ Kf6 Qh6\#>\[|) and now:
     |\var Rg3+ Rg6 Nxf5+! exf5 Rxg6+ Kxg6 
     Qxf5+ Kf8 Qh6+ Kf7 Bd5+ Ke8 Qg6+ Kf8 Qf7\#|.|\end{variations}\]|%
 |\var Nce5! fxe5 Nxe5 Nxf5! exf5 Qxe5 Qf6 Bxf5+ 
-    Qxf5 Qxe7+\WBetter [Kh8]|.
+    Qxf5 Qxe7+\WBetter|.
 |\end{variations}\]|
 
 \subsection{Setting up a position}\label{position}
@@ -444,7 +444,7 @@ It's much easier just to see one than to read the paragraph above:
 \end{verbatim}
 \noindent creates a position that can be visualized with \textsf{skak}'s "\showboard":
 
-\fenposition{r1bq1rk/4bppp/p1p/1p1nR/8/1BP/PP1P1PPP/RNBQ2K w KQkq - 0 11}
+\fenboard{r1bq1rk/4bppp/p1p/1p1nR/8/1BP/PP1P1PPP/RNBQ2K w KQkq - 0 11}
 \showboard
 
 This is a Marshall-Attack position, and it's White's turn to make his eleventh move. If moves are going to be typeset for this diagram, we need \TeXmate\ to know it's move 11 by white. That's easy enough with old commands ("\white 11"), but in \TeXmate\,2 we have to instruct \textsf{skak} as well. 
@@ -459,11 +459,7 @@ In order to do that, "\position" has an optional argument, something like "[b 19
 \noindent The position is now in memory, and will be upgraded with any new moves. It can be sent, at any point, to diagram memory with "\toD". 
 
 \bigskip
-\noindent"\position" is designed for quick diagram drawing (where it does not matter who can castle where, etc.). For complete \acro{FEN} descriptions of positions (for example from an external source), \textsf{skak}'s \SpecialIndex{\fenboard}"\fenboard{"\meta{\acro{FEN} position}"}" can be used, but \TeXmate\ will not know who is to play and what the move number is. \DescribeMacro{\fenposition}So, \TeXmate's "\fenposition", whose argument is the complete \acro{FEN} description,\footnote{Although without necessarily filling in the lines with the number of empty squares at the end.} reads the relevant data and passes the information to \textsf{skak}.
-
-
-
-
+\noindent"\position" is designed for quick diagram drawing (where it does not matter who can castle where, etc.). For complete \acro{FEN} descriptions of positions (for example from an external source), \textsf{skak}'s \SpecialIndex{\fenboard}"\fenboard{"\meta{\acro{FEN} position}"}" can be used. It has been modified so that \TeXmate\ will know who is to play and what the move number is. 
 
 
 \bigskip\noindent
@@ -573,7 +569,7 @@ In fact, \TeXmate\,2 does not have some possibilities of old \TeXmate. Its diagr
 \subsubsection{Issuing the diagrams}\label{diagiss}
 Diagrams are \emph{issued} at one point, and \emph{printed} at another. This allows the typesetting of diagrams side by side without regard to what the current position. 
 
-\DescribeMacro{\diagramsign}Issuing the diagrams is done by the commands explained in section~\ref{diagrams}, namely \SpecialIndex{\toD}\SpecialIndex{\toD*}\SpecialIndex{\drawdiagram}"\toD", "\toD*", and "\drawdiagram". The regular version "\toD" inserts the contents of \diagramsign, which by default is `{~\mdseries(\textit{D})}', but can be freely redefined. "\toD*" does not insert "\diagramsign".
+\DescribeMacro{\diagramsign}Issuing the diagrams is done by the commands explained in section~\ref{diagrams}, namely \SpecialIndex{\toD}\SpecialIndex{\toD*}\SpecialIndex{\preparediagram}"\toD", "\toD*", and "\preparediagram". The regular version "\toD" inserts the contents of \diagramsign, which by default is `{~\mdseries(\textit{D})}', but can be freely redefined. "\toD*" does not insert "\diagramsign".
 
 The diagrams are then put in memory---as \LaTeX\ boxes---together with some accompanying material: player names, move number, etc. (Note that \textsf{skak}'s \SpecialIndex{\showboard}"\showboard" or \textsf{chessboard}'s \SpecialIndex{\chessboard}"\chessboard" do not `issue' a diagram in \TeXmate's terms, but simply print the current or given position.) This section describes the basic customization of the diagram boxes. It actually tells some white lies, so section~\ref{further} below explains in full detail.
 
@@ -589,27 +585,29 @@ By default, diagrams:
 
 \begin{table}
 \begin{tabular}{lm{.6\textwidth}}\hline
- "\topdiagramnames" & Players' names  on top of the diagram. Like this: `\textbf{Dubois--Steinitz}'.\\
-"\bottomdiagramnames" & Players' names  at the bottom of the diagram.\\
- "\diagramnames" & White's name at the bottom, Black's on top (default).\\
+ "\topdiagramnames" & Players' names  on top of the diagram. Like this: `\textbf{Dubois--Steinitz}'.\\\cline{2-2}
+"\bottomdiagramnames" & Players' names  at the bottom of the diagram.\\\cline{2-2}
+ "\diagramnames" & White's name at the bottom, Black's on top (default).\\\cline{2-2}
  "\nodiagramnames" & No  players' names.\\\hline
-"\diagramnumber" & Diagram number on the top of the diagram (above names, if any). The current version of "\TheDiagram" is used---by default, this is "\textit{\small\bfseries\arabic{diagram}}". Regular (lower-case) "\thediagram" is intended for running-text reference. \\[2mm]
+"\diagramnumber" & Diagram number on the top of the diagram (above names, if any). \newline The number is formatted by the current version of "\TheDiagram"---by default something like `\textit{\textbf{4}}'. \newline Regular (lower-case) "\thediagram" is intended for running-text reference. \\\cline{2-2}
  "\nodiagramnumber" & No diagram numbers (default).\\\hline
  "\leftdiagramturn" & Turn marker at the left of the diagram.\\
  "\rightdiagramturn" & Turn marker at the right of the diagram.\\
  "\nodiagramturn" & No turn marker (default).\\\hline
  "\diagrammove" & Last move at the bottom (default).\\
  "\nodiagrammove" & No last move.\\\hline
-"\analysistop" & What goes by default on top of analysis diagrams. Defined originally as `Analysis.'
+"\analysistop" & What goes by default on top of analysis diagrams. Defined originally as `Analysis'.
 \end{tabular}
 \SpecialIndex{\topdiagramnames}\SpecialIndex{\bottomdiagramnames}\SpecialIndex{\diagramnames}
 \SpecialIndex{\nodiagramnames}\SpecialIndex{\diagramnumber}\SpecialIndex{\nodiagramnumber}\SpecialIndex{\leftdiagramturn}
 \SpecialIndex{\rightdiagramturn}\SpecialIndex{\nodiagramturn}\SpecialIndex{\diagrammove}\SpecialIndex{\nodiagrammove}
-\SpecialIndex{\analysistop}
+\SpecialIndex{\analysistop}\SpecialIndex{\thediagram}\SpecialIndex{\TheDiagram}
 \caption{Command for diagram information}\label{diagramcommands}
 \end{table}
 
-\noindent The commands of Table~\ref{diagramcommands} govern these defaults. \DescribeMacro{\whiteturnmarker}\DescribeMacro{\blackturnmarker}When a turn marker is requested, \TeXmate\ will use the contents of either "\whiteturnmarker" or "\blackturnmarker". These, by default, are defined as:
+\noindent The commands of Table~\ref{diagramcommands} govern these defaults. They are user-modifiable with "\renewcommand", with one warning: these commands (and in general non-chess stuff) should go \emph{outside} chess mode. 
+
+\DescribeMacro{\whiteturnmarker}\DescribeMacro{\blackturnmarker}When a turn marker is requested, \TeXmate\ will use the contents of either "\whiteturnmarker" or "\blackturnmarker". These, by default, are defined as:
 
 \begin{verbatim}
 \newcommand*\whiteturnmarker{%
@@ -661,17 +659,17 @@ An optional argument to "\makediagrams["\meta{n}"]" will tell \TeXmate\ to types
 \let\makediagramfont\footnotesize
  % First diagram
 \position[w 22]{r1q4r/pp2bQ/2p2p1k/6pp/4N/6R/PPP2PPP/2KR}
-\drawdiagram{}{22.~?}\label{pageref}
+\preparediagram{}{22.~?}\label{pageref}
 
  % Second diagram
 \position[b 20]{r5k/1bpp1ppp/1p1b3r/pP2n1q/2PB/P3PPP/3QBR1P/R2N2K}
-\drawdiagram{}{{20\dots?}}
+\preparediagram{}{{20\dots?}}
 
 etc.
 
 % Ninth diagram
 \position[w 27]{2r1r1k/p1q2ppp/6n/1p1Q/2N1P/P3B2P/2R2PP/6K}
-\drawdiagram{}{27.?}
+\preparediagram{}{27.?}
 
 \begin{figure}[p]
 \makediagrams[3]
@@ -690,31 +688,31 @@ etc.
 \let\makediagramfont\footnotesize
 
 \position[w 22]{r1q4r/pp2bQ/2p2p1k/6pp/4N/6R/PPP2PPP/2KR}
-\drawdiagram{}{}
+\preparediagram{}{22.~?}
 
 \position[b 20]{r5k/1bpp1ppp/1p1b3r/pP2n1q/2PB/P3PPP/3QBR1P/R2N2K}
-\drawdiagram{}{}
+\preparediagram{}{20\dots?}
 
 \position[w 13]{r2qr1k/ppp1bppp/5n/1N1PQ1B/8/8/PPP2PPP/R4RK}
-\drawdiagram{}{}
+\preparediagram{}{13.~?}
 
 \position[w 34]{3r1r1k/3nbpp/q1nNp/p/PpP1BP/3QB/6PP/1RR3K}
-\drawdiagram{}{}
+\preparediagram{}{34.~?}
 
 \position[w 15]{rnbr2k/pp2bppp/4pn/1N2N/2B1q/4B/PP2QPPP/R2R2K}
-\drawdiagram{}{}
+\preparediagram{}{13.~?}
 
 \position[b 22]{1r2r1k/5ppp/R2b/3p3q/3P/2P1B1Pb/1P3P1P/1N2R1KQ}
-\drawdiagram{}{}
+\preparediagram{}{22\dots?}
 
 \position[b 44]{8/5k1r/4pP1p/3pP1pP/2p1p1P/5n1Q/r/1R5K}
-\drawdiagram{}{}
+\preparediagram{}{44\dots?}
 
 \position[b 22]{1k4r/p1q2p/Q1p1pp/3p3p/4rP/1P/P1P1NK/3R1R}
-\drawdiagram{}{}
+\preparediagram{}{22\dots?}
 
 \position[w 27]{2r1r1k/p1q2ppp/6n/1p1Q/2N1P/P3B2P/2R2PP/6K}
-\drawdiagram{}{}
+\preparediagram{}{27.?}
 
 \begin{figure}[p]
 \makediagrams[3]\label{problems}
@@ -732,17 +730,17 @@ etc.
 
 Diagrams are counted (whether the number is printed or not) with the "diagram" counter. When diagrams are printed with \SpecialIndex{\makediagrams}\SpecialIndex{diagram}\SpecialIndex{\label}"\makediagrams", this counter is "\refstep"'ped, i.e., a "\label" can be assigned to it for cross references. The mechanism is not completely implemented in \TeXmate, not least because there is little of a `standard' use. As it stands, the main problem is that the user cannot assign individual "\label"'s to diagrams that printed with the same "\makediagrams". On the other hand, if the latter command is used for one diagram at a time, cross referencing is fully functional.
 
-\subsubsection{Detailed mechanism description}\label{mech}
+\subsubsection{Detailed mechanism description}\label{further}
 
 
 The commands described in the previous section are not intended to provide full control on diagram layout, but rather simple tools for the needs of most of the time. More extensive customization will require hands-on programming. The diagram mechanism in \TeXmate\,2 has been designed to make this task easier, should it arise. This section explains it.
 
-As has been said, a diagram is \emph{issued} first and \emph{retrieved} later. The issuing commands \SpecialMainIndex{\toD}\SpecialMainIndex{\toD*}\SpecialMainIndex{\drawdiagram}("\toD", "\toD*", and "\drawdiagram") build four \LaTeX\ boxes and one command containing the diagram and the accompanying information. The names of these boxes contain the diagram number in lowercase Roman numerals. If, for example, a diagram in the third memory position is being issued, the following boxes are created:
+As has been said, a diagram is \emph{issued} first and \emph{retrieved} later. The issuing commands \SpecialMainIndex{\toD}\SpecialMainIndex{\toD*}\SpecialMainIndex{\preparediagram}("\toD", "\toD*", and "\preparediagram") build four \LaTeX\ boxes and one command containing the diagram and the accompanying information. The names of these boxes contain the diagram number in lowercase Roman numerals. If, for example, a diagram in the third memory position is being issued, the following boxes are created:
 \begin{itemize}
 \item "\chessdiagiii" holds the diagram itself---and it is a copy of either "\showboard" or (when \textsf{skak} is not loaded) \TeXmate's own typesetting of the diagram with \textsf{chessfss} commands.
-\item "\chessdiagiiitop" holds whatever goes on the top of the diagram. It can be: $a)$~with the "\...diagramnames" switches, the names of the players (or of Black); $b)$ whatever was defined by the user as "\diagramtop"; or $c)$ the first argument of the user's "\drawdiagram".
+\item "\chessdiagiiitop" holds whatever goes on the top of the diagram. It can be: $a)$~with the "\...diagramnames" switches, the names of the players (or of Black); $b)$ whatever was defined by the user as "\diagramtop"; or $c)$ the first argument of the user's "\preparediagram".
 \item "\chessdiagiiibottom" holds whatever goes on the bottom of the diagram. Analogous.
-\item "\chessdiagiiimove" holds the typeset form of the argument to "\toD" or "\toD". It is empty in the case of "\drawdiagram".
+\item "\chessdiagiiimove" holds the typeset form of the argument to "\toD" or "\toD". It is empty in the case of "\preparediagram".
 \end{itemize}
 \SpecialIndex{\chessdiag...}\SpecialIndex{\chessdiag...top}\SpecialIndex{\chessdiag...bottom}
 \SpecialIndex{\chessdiag...move}
@@ -783,7 +781,7 @@ Then, \SpecialMainIndex{\makegametitle}"\makegametitle" simply uses these variab
 
 The command \SpecialIndex{\showboard}"\showboard" in the package \textsf{skak} has been mentioned repeatedly in this manual. It can be used with \TeXmate, and it provides total flexibility for the typesetting of the diagram, forgoing the automatic formatting that \TeXmate\ performs. 
 
-Another important command, also mentioned before, is \SpecialIndex{\fenboard}"\fenboard". It is recommended to interface this command (for \TeXmate's sake) with \SpecialIndex{\fenposition}"\fenposition", that takes the same argument.
+Another important command, also mentioned before, is \SpecialIndex{\fenboard}"\fenboard".
 
 But there are other commands from \textsf{skak} whose use might prove an extension to \TeXmate's capabilities. This is mainly connected to saving and restoring positions in memory or disk. \textsf{skak}'s \SpecialIndex{\storegame}"\storegame{"\meta{key}"}" saves a position in memory, to be restored by \SpecialIndex{\restoregame}"\restoregame{"\meta{key}"}". With this tool, for example, it is possible to quote an independent game in commentary, and still have the capabilities of \textsf{skak}. All that is needed is to store the main game, type \SpecialIndex{\newgame}"\newgame", quote the alternative game, issue any diagrams from it, and restore the main game when done. (\textsf{skak} also offers \SpecialIndex{\sidegame}"\sidegame" for this purpose, but its use with \TeXmate\ is not as straightforward.