Pepito v.154 -- 22.06.2002 --

Pepito is a free chess playing program which can be used as an engine
in interfaces supporting either the Xboard/Winboard protocol or the UCI
protocol. Some work is being done to give it its own GUI, but this is
currently private.

This short file explains how to hook Pepito to Winboard and some of its
options when running in console mode. Consider yourself lucky since this
is the first aid of this nature, previous versions where "find out for 
yourself".


+----------------------------------+
| Installing Pepito under Winboard |
+----------------------------------+

This should be pretty straightforward. Add the following lines to your
winboard.ini, which should be located in ...\Program files\Winboard or
something similar:

under firstChessProgramNames...
Pepito /fd="c:\\PathWherePepitoIsLocated\"

under secondChessProgramNames...
Pepito /sd="c:\\PathWherePepitoIsLocated\"


Notice the double slash \\ convention:

c:\\path1\\path2\\ ... lastpath\

+------------------------------------------+
| Pepito's configuration file (config.dat) |
+------------------------------------------+

Here you can specify some parameters of things which are done at boot.
Entries here are optional (they can be missing), predefined values are
assumed if not found:

HASH_SIZE  (default value: 8 MB)

	This parameter tells Pepito what amount of memory it should
	allocate for main hash table. For performance reasons, it
	allways uses a power of 2 for the number of entries. Since a
        hash entry is 16 bytes, your value should be also a power of
        2. If it isn't,	the most significant bit of the number given
        will do the job. A suffix can folllow your number to tell Pepito
	whether you mean bytes, KB or MB. No suffix will be interpreted
        as MB. Examples:

	HASH_SIZE   8     => 8 MB for hash tables (same as 8m)
	HASH_SIZE   256k  => 256 KB...
        HASH_SIZE   32b   => 32 bytes (2 entries). Absolute Minimum.

        Older versions required that the memory allocated for hashing be >=
        book size. This is no longer true.

PAWN_HASH_SIZE (default value: 3 MB)

	Amount of memory used for pawn hash tables. Each entry is 24 bytes,
	so you should use a value N, where N/24 is a power of 2.
	
ECACHE_SIZE (default value: 512k)

	Amount of memory used for evaluation cache. Size of each entry is 16
	bytes.

EGTB_PATH (default value: -- none --)

	Path where Nalimov EGTBs reside in your hard disk. If you don't know
	what this is, don't worry about this parameter.

EGTB_CSIZE (default value: 1 MB)

	Size of the cache used to remember EGTB probes.	Only used if tablebases
	where found in the path EGTB_PATH.

RESIGN_MARGIN (default value: -1000)

	If Pepito happens to search with window lower than this value (root beta
	< margin) when the search time is over it will forfeit the game. Value given
	is in centipawns. Keep in mind the usual values of chess pieces since they are
	roughly the same for my program.

USE_BOOK (default value: yes)

	Tells Pepito whether to use an opening book or not.

BOOK_FILE (default value: libro)

	Name and path of the opening book file. Pepito's books consist now of two files:

        xxxx.ind => holds the B-tree index
        xxxx.bin => holds the data records

        You should enter the xxxx part here, without the file extension.

BOOK_RANDOM (default value: yes)

	If this is set to no, Pepito will think of book moves as if they were the only
	legal moves and do a normal search. This should make it play into lines that
	it likes (and hopefully, plays better). Pepito will chose one book move randomly
	(moves with higher frequency will have higher probability) if BOOK_RANDOM is set
	to yes. I don't know if current versions support this anymore.

BOOK_LEARN (default value: yes)

        Acticates/deactivates the book learning. Pepito will avoid playing lines that it
        once lost with. Note: turning it off won't prevent Pepito from using the learned
        data present in the book, it will just stop updating it after each game.

BOOK_WIDTH (default value: 255)

        Restricts the possibility of chosing inferior book moves by limiting the random
        selection procedure to the best N moves.

DISPLAY_MARGIN (default value: 5)

	PVs are not displayed until we reach this iteration depth. Depth value = 1 means
	all PVs will get printed.

GAME_STYLE (default value: solid)

        Switch to somehow influence the degree of king safety knowledge incorporated into
        the evaluation function. Three different styles: solid, normal, aggressive.

LANGUAGE (default value: Spanish)

	Controls the names of the pieces that Pepito uses to display boards/ thinking lines.
        Supported languages are the ones defined in the PGN standard: Czech, Danish, Dutch,
        English, Estonian, Finnish, French, German, Hungarian, Icelandic, Italian, Norwegian,
        Polish, Portuguese, Romanian, Spanish and Swedish. If someone has particular interest
        to see PVs in his/her native language drop me an email.

LOGGING (default value: no)

	If set to yes, Pepito will generate a logfile with the commands received and
        other stuff to help debugging.

BATCH_FILE [a_file]

	Pepito will execute all the commands found in a_file just after booting.
	

+---------------------+
| Running test suites |
+---------------------+

Test suites are important for chess programmers because they can answer rapidly whether a
change has accomplished the desired effect or not, or they can give a clue when you've
just broken something. Trying to extract consequences further than that is probably prone
to errors, but they are useful anyway.

Pepito can "swallow" EPD files by means of the epd command from the console. You will be
prompted for the time per position (in seconds) and then the program will start analysing
all the positions found in the given file.

Caveat: Any key pressed will cause an interrupt. Pepito will wait for the enter key and it
will automatically stop searching the current position to go grab the next one. I use this
to stop it when a position seems to be solved.

Missed positions will get stored in fallos.epd. If you want to browse through the results
I suggest you enable LOGGING.


+------------------------+
| Building opening books |
+------------------------+

This has completely changed from prior versions. Type "badmin" in Pepito's command line and
then "help" for a detailed explanation on the book management options.