111. Introduction
22---------------
33
4- Stockfish is a free UCI chess engine derived from Glaurung 2.1. It is
5- not a complete chess program, but requires some UCI compatible GUI
6- (like XBoard with PolyGlot, eboard, Josè, Arena, Sigma Chess, Shredder,
7- Chess Partner, or Fritz) in order to be used comfortably. Read the
8- documentation for your GUI of choice for information about how to use
9- Stockfish with your GUI.
10-
11- This version of Stockfish supports up to 32 CPUs, but has not been
12- tested thoroughly with more than 4. The program tries to detect the
13- number of CPUs on your computer and set the number of search threads
14- accordingly, but please be aware that the detection is not always
15- correct. It is therefore recommended to inspect the value of the
16- "Threads" UCI parameter, and to make sure it equals the number of CPU
17- cores on your computer. If you are using more than four threads, it
18- is recommended to raise the value of "Minimum Split Depth" UCI parameter
19- to 6.
4+ Stockfish is a free UCI chess engine derived from Glaurung 2.1. It is not a
5+ complete chess program, but requires some UCI compatible GUI (like XBoard
6+ with PolyGlot, eboard, Arena, Sigma Chess, Shredder, Chess Partner or Fritz)
7+ in order to be used comfortably. Read the documentation for your GUI of choice
8+ for information about how to use Stockfish with your GUI.
9+
10+ This version of Stockfish supports up to 32 CPUs, but has not been tested
11+ thoroughly with more than 4. The program tries to detect the number of
12+ CPUs on your computer and set the number of search threads accordingly, but
13+ please be aware that the detection is not always correct. It is therefore
14+ recommended to inspect the value of the "Threads" UCI parameter, and to
15+ make sure it equals the number of CPU cores on your computer. If you are
16+ using more than eight threads, it is recommended to raise the value of
17+ "Min Split Depth" UCI parameter to 7.
2018
2119
22202. Files
@@ -30,9 +28,9 @@ This distribution of Stockfish consists of the following files:
3028 License.
3129
3230 * src/, a subdirectory containing the full source code, including a
33- Makefile that can be used to compile Stockfish on Unix-like
34- systems. For further information about how to compile Stockfish
35- yourself, read section 4 below.
31+ Makefile that can be used to compile Stockfish on Unix-like systems.
32+ For further information about how to compile Stockfish yourself
33+ read section 4 below.
3634
3735 * polyglot.ini, for using Stockfish with Fabien Letouzey's PolyGlot
3836 adapter.
@@ -50,39 +48,39 @@ parameter "Book File".
50484. Compiling it yourself
5149------------------------
5250
53- On Unix-like systems, it should usually be possible to compile
54- Stockfish directly from the source code with the included Makefile.
51+ On Unix-like systems, it should usually be possible to compile Stockfish
52+ directly from the source code with the included Makefile.
5553
56- For big-endian machines like Power PC you need to enable the proper
57- flag changing from -DNBIGENDIAN to -DBIGENDIAN in the Makefile.
58-
59- Stockfish has POPCNT instruction runtime detection and support. This can
60- give an extra speed on Core i7 or similar systems. To enable this feature
61- compile with 'make icc-profile-popcnt'
62-
63- On 64 bit systems the 'bsfq' assembly instruction will be used for bit
64- counting. Detection is automatic at compile time, but in case you experience
65- compile problems you can comment out #define USE_BSFQ line in types.h
54+ Stockfish has support for 32 or 64 bits CPUS, big-endian machines, like
55+ Power PC, hardware POPCNT instruction and other platforms.
6656
6757In general is recommended to run 'make help' to see a list of make targets
68- with corresponding descriptions.
58+ with corresponding descriptions. When not using Makefile to compile, for
59+ instance with Microsoft MSVC, you need to manualy set/unset in the compiler
60+ command line the following flags:
61+
62+ -DNDEBUG --- Disable debug mode
63+ -DBIGENDIAN --- big-endian byte order
64+ -DUSE_POPCNT --- Use popcnt SSE 4.2 asm-instruction
65+ -DIS_64BIT --- 64bit operating system (auto detected)
66+ -DUSE_PREFETCH --- Use prefetch x86 asm-instruction (auto detected)
67+ -DUSE_BSFQ --- Use bsfq x86_64 asm-instruction (auto detected)
6968
7069
71705. Terms of use
7271---------------
7372
7473Stockfish is free, and distributed under the GNU General Public License
75- (GPL). Essentially, this means that you are free to do almost exactly
74+ (GPL). Essentially, this means that you are free to do almost exactly
7675what you want with the program, including distributing it among your
7776friends, making it available for download from your web site, selling
7877it (either by itself or as part of some bigger software package), or
7978using it as the starting point for a software project of your own.
8079
8180The only real limitation is that whenever you distribute Stockfish in
8281some way, you must always include the full source code, or a pointer
83- to where the source code can be found. If you make any changes to the
82+ to where the source code can be found. If you make any changes to the
8483source code, these changes must also be made available under the GPL.
8584
8685For full details, read the copy of the GPL found in the file named
8786Copying.txt.
88-
0 commit comments