othelloboard 1.2 (19aug11)

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

4 files changed, 44 insertions, 14 deletions

diff --git a/Master/texmf-dist/doc/latex/othelloboard/README b/Master/texmf-dist/doc/latex/othelloboard/README
index f1e8f10bdf1..53d1e2fade3 100644
--- a/Master/texmf-dist/doc/latex/othelloboard/README
+++ b/Master/texmf-dist/doc/latex/othelloboard/README
@@ -14,4 +14,13 @@ This work has the LPPL maintenance status `maintained'.
 
 The Current Maintainer of this work is Steven Hall (stevenhall.uk@gmail.com).
 
-This work consists of the files othelloboard.sty and othelloboard.pdf.
+This work consists of the files: 
+
+- othelloboard.sty
+- othelloboard.pdf (documentation)
+- othelloboard.tex (source for documentation)
+
+Many thanks to Brian Rose for permission to typeset material from his book Othello: A
+Minute to Learn … A Lifetime to Master in the example file:
+
+- example-rose-chps1-2.pdf
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/othelloboard/README.TEXLIVE b/Master/texmf-dist/doc/latex/othelloboard/README.TEXLIVE
new file mode 100644
index 00000000000..3a84b7c3f0f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/othelloboard/README.TEXLIVE
@@ -0,0 +1,7 @@
+The following files have been removed in the TeX Live installation of
+the current package, typically due to duplication, lack of space, or
+missing source code.  You can find these files on CTAN at
+	http://mirror.ctan.org/macros/latex/contrib/othelloboard
+If questions or concerns, email tex-live@tug.org.
+
+	example-rose-chps1-2.pdf
diff --git a/Master/texmf-dist/doc/latex/othelloboard/othelloboard.pdf b/Master/texmf-dist/doc/latex/othelloboard/othelloboard.pdf
index 3462339256f..aedd0be159d 100644
--- a/Master/texmf-dist/doc/latex/othelloboard/othelloboard.pdf
+++ b/Master/texmf-dist/doc/latex/othelloboard/othelloboard.pdf
diff --git a/Master/texmf-dist/doc/latex/othelloboard/othelloboard.tex b/Master/texmf-dist/doc/latex/othelloboard/othelloboard.tex
index 851e7c14d5b..aab722e8024 100644
--- a/Master/texmf-dist/doc/latex/othelloboard/othelloboard.tex
+++ b/Master/texmf-dist/doc/latex/othelloboard/othelloboard.tex
@@ -8,15 +8,16 @@
 \usepackage{appendix}
 \usepackage[parfill]{parskip}    % Activate to begin paragraphs with an empty line rather than an indent
 \usepackage{othelloboard}
-\usepackage{natbib}
+\usepackage{hyperref}
+%\usepackage{natbib}
+
 
 %%% TITLE %%%
-\newcommand{\fileversion}{v1.01}
-\newcommand{\filedate}{28/06/2011}
+\newcommand{\fileversion}{v1.2}
 \title{The \textsf{othelloboard} package%
-\thanks{This document corresponds to \textsf{othelloboard}~\fileversion, dated~\filedate.}
+\thanks{This document corresponds to \textsf{othelloboard}~\fileversion. Thanks to Brian Rose for permission to typeset material from his book for the example file: \texttt{example-rose-chps1-2.pdf}.}
 }\author{Steven Hall \\ \texttt{stevenhall.uk@gmail.com}}
-\date{28 June 2011}
+\date{18 August 2011}
 
 
 %% DOCUMENT %%
@@ -25,9 +26,11 @@
 \pagestyle{plain}
 
 \maketitle
+\tableofcontents
 
 %------
 \section{Drawing a simple board diagram}
+\begin{center}
 \begin{othelloboard}{1}
 \gridrefs
 \dotmarkings
@@ -39,10 +42,8 @@
 \othelloarraysixthrow	{0}{0}{2}{1}{1}{1}{0}{0}
 \othelloarrayseventhrow	{0}{0}{0}{0}{0}{0}{0}{0}
 \othelloarrayeighthrow	{0}{0}{0}{0}{0}{0}{0}{0}
-%annotations
-%\put(0,-14){\small{Figure 1}}
 \end{othelloboard}
-
+\end{center}
 
 The board above was produced by the following list of commands:
 	\begin{verbatimtab}
@@ -73,7 +74,7 @@ You should also see that where you choose to put a number in the grid determines
 \subsection{The \texttt{othelloboard} environment}
 \subsubsection{The basic commands}
 
-Look again at the opening and closing lines of code for the diagram above.
+Look again at the opening and closing lines of code for the diagram in the previous section.
 
 \begin{description}
 \item{\verb=\begin{othelloboard}{1}=} \verb=%		= Mandatory argument for board size.
@@ -124,7 +125,7 @@ Here is a board drawn at size 0.75 without \verb=\dotmarkings=, and with the \ve
 \ \\
 Note the use of black diamonds to show the discs just flipped by the black disc placed at e7. This is the convention followed, e.g., in Brian Rose's book (Rose 2005).
 
-\subsubsection{Useful tip} \label{tabtips}
+\paragraph{Useful tip}\label{tabtips}
 You may find that it helps see where you are putting discs if you align all of the rows of numbers in the array. You can do this (as with the examples given in this document) by putting tabs between the command name and its first argument. Don't use spaces though, as unlike tabs (which aren't read as gaps when the file compiles), spaces will break the commands and cause errors.
 
 \verb=\othelloarrayfirstrow= \begin{picture}(30,30)\put(20,8){\vector(-1,-2){5}}\put(0,12){\textit{tabs not spaces}}\end{picture}\verb=		{0}{1}{1}{2}{1}{0}{0}{0}=\\
@@ -434,6 +435,8 @@ To create a board diagram from this string, we simply feed it as an argument int
 \end{minipage}
 \end{center}
 
+The characters \verb=3= and \verb=4= can also be included in the string for white and black diamonds (respectively).
+
 \section{Tweaks}
 Feel free to tweak the code in the \verb=othelloboard.sty= file if the diagrams aren't exactly how you like them. I've commented on it quite thoroughly so that it should be easy to see which bit to tweak in order, e.g., to change the font size of the grid references, or the size of the discs relative to the grid.\\
 
@@ -551,6 +554,9 @@ The text over here is in the \verb=minipage= on the right. Both \verb=minipage=s
 The annotations are in a san-serif font this time.
 \end{minipage}
 \end{center}
+\bigskip
+
+For more examples of layouts using diagrams of different sizes, see the file: \texttt{example\--rose\--chps1\--2.pdf}.
 
 \subsection{Code for the examples in this section}
 
@@ -650,7 +656,7 @@ The annotations are in a san-serif font this time.
 They work best within a \verb=picture= environment using the \verb=\put= command for accurate placing. Note that the shapes are positioned from their centre-points. These are the same sub-commands that the \verb=\othelloarray=\ldots\verb=row= commands call upon when they execute, so using these ensures the size and style of shapes will be the same as those appearing within board diagrams within the same document.
 
 \subsection{Counters}
-The \textsf{othelloboard} package uses counters to store the value of discs / diamonds placed on each square (this is the same value you input in order to draw the discs / diamonds). The package currently only uses these counters to determine the text colour of annotations, but these values are available for the current board diagram until another is drawn (the counters are all reset initially as part of the code for a new diagram).
+The \textsf{othelloboard} package uses counters to store the value of discs/diamonds placed on each square (this is the same value you input in order to draw the discs/diamonds). The package currently only uses these counters to determine the text colour of annotations, but these values are available for the current board diagram until another is drawn (the counters are all reset initially as part of the code for a new diagram).
 
 The counter names follow this format:\\
 
@@ -712,12 +718,20 @@ Admittedly this doesn't seem like a very useful feature, but if you like playing
 \item Forgetting to include an \verb=\end{othelloboard}= declaration at the end of each diagram.
 \end{itemize}
 
+\section{Changes}
+\subsubsection*{18 August 2011}
+\begin{itemize}
+\item Extended the \verb=\drawboardfromstring= command to recognize the characters \verb=3= and \verb=4= (for diamonds) in a string.
+\item Included example material typeset using this package -- two chapters from Brian Rose's book. 
+\end{itemize}
+
 \bibliographystyle{phil_review}
 \begin{thebibliography}{1}
-\bibitem{Rose2005} Brian Rose (2005). \emph{Othello: A Minute to Learn, A Lifetime to Master}.
+\bibitem{Rose2005} Brian Rose (2005). \emph{Othello: A Minute to Learn \ldots\ A Lifetime to Master}.\\[6pt]
+The official version can be downloaded from http://othellogateway.com/rose/book.pdf.
 \end{thebibliography}
 
-\vspace{12mm}
+\clearpage
 
 \makebox[0pt][l]{\hspace{-64pt}
 \begin{othelloboard}{2.6}