%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Project:     CasCastle
%% Descr:       CasCastle Math basic training program
%% Author:      Manuel Gutiérrez Algaba <algaba@seul.org>
%% Version 0.3
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\documentclass[english]{article}
\usepackage[latin1]{inputenc}
\usepackage{babel}
\usepackage[fancyhdr]{latex2man}
\setDate{2001/1/07}    %%%% must be manually set, if rcsinfo is not present
\setVersion{0.3}
\setVersionWord{Version}
\begin{document}
\begin{Name}{6}{CasCastle}{Manuel Gutiérrez Algaba}{CasCastle}{ CasCastle: Mathematical game}
\Prog{CasCastle} \\
 It's a programm that gives you a series of 
'castles' made of several rows, each one representing addings, so the first row of 
the castle represent : `` $8+4+9=21$''. You have to check if all
the addings are right. Sometimes there're bugs. Example:\\
\verb+  8  4  9 | 21+\\
\verb+ 10  9 10 | 29+\\
\verb+  1  1 10 | 12+\\
\verb+Press R if you think the castle is right, +\\
\verb+ anything else if is wrong, then press enter+\\

At the end the series you got a brief statistics lines:\\
\verb+ Number of questions: 10 Number of Hits: 6+\\

The purpose of the game is to instruct the people to do fast addings.
The range, number of cols, number of rows and probability
of buggy rows are all of them configurable.
\end{Name}
\section{Invoking it}
I've made a shell script: \verb+cascastle+ \\ This is just an
call to a Java programm: \\
\verb+java -classpath $CLASSPATH:CasSetGames.jar CasSetGames game+ \\
Where game is a file stored usually in \verb+/usr/lib/vsep.../+,
but it can be a local file too. If you invoke \verb+cascastle+ 
without args, then it loads that default file, if you put a
name of file, then the game loads the data from that file.


\section{Configuring new games}
The format of the date file is sequences of strings (with no
separation (no newlines nor anything at all) with this look:
\verb+0300100306+\\

This represents a castle of '03' cols, where the range of the numbers
involved is up to '0010', there're '03' rows and the probability to
have a 'buggy' row is '03/06'.

For generating such format , I've hacked a tcl script called 
\verb+castlegen.tcl+ which can be found in \verb+/usr/lib/vsep.../+
at the last lines of this script you have:\\

\verb+setfile my_tests + \\
\verb+setRange 10+ \\
\verb+setRows 3+ \\
\verb+setCols 3+ \\
\verb+setFault 6+ \\
\verb+severalCurrentParams 10+ \\
\verb+finish+ \\
You only have to change the values you want to. And then do:
\verb+tcl castlegen.tcl+, from the dir where castlegen.tcl is.\\
Of course, you can write that file by yourself, exercise by
exercise or hack a Perl script...


\section{Wishlist}
Well, comments, money, ... Well, I suppose a great set of exercises,
more complex behaviour. Statistics, login of users...


\section{Author}
Manuel Gutierrez Algaba, algaba@seul.org.
Released under GPL license. I have no responsabilities for misuse, harm,
wrongdoing,... that may arise or be caused by the use of this
software. If you use it, you take all the risks and responsabilities
for it.

\LatexManEnd

\end{document}