1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<?asciidoc-toc?>
<?asciidoc-numbered?>
<article lang="en">
<articleinfo>
<title>INSTALL file for Freecell Solver</title>
<date>2009-08-29</date>
<author>
<firstname>Shlomi</firstname>
<surname>Fish</surname>
<email>shlomif@cpan.org</email>
</author>
<authorinitials>SF</authorinitials>
<revhistory><revision><revnumber>$Id$</revnumber><date>2009-08-29</date><authorinitials>SF</authorinitials></revision></revhistory>
</articleinfo>
<section id="_quick_and_dirty_compilation">
<title>Quick and Dirty Compilation</title>
<simpara>Freecell Solver was converted to use CMake ( <ulink url="http://www.cmake.org/">http://www.cmake.org/</ulink> )
starting from version 2.12.0. You’ll need to install CMake version 2.6.3
or later from your distribution’s repository or from its source
distribution. <emphasis role="strong">NOTE</emphasis>: CMake 2.6.2 (that ships with some releases of Ubuntu)
won’t work due to a regression bug so please don’t report any errors with
it.</simpara>
<simpara>If you are building from the repository you also need to put the
module <literal>Shlomif_Common.cmake</literal> from
<ulink url="https://bitbucket.org/shlomif/shlomif-cmake-modules">https://bitbucket.org/shlomif/shlomif-cmake-modules</ulink> in the CMake path.</simpara>
<simpara>Next, run:</simpara>
<literallayout class="monospaced">cmake-gui . # For the GUI configuration applet</literallayout>
<simpara>Or:</simpara>
<literallayout class="monospaced">ccmake . # For the Curses-based configuration applet</literallayout>
<simpara>With a fallback to:</simpara>
<literallayout class="monospaced">cmake . # Non-interactive application.</literallayout>
<simpara>This will build and install the "freecell-solver" shared library,
and "fc-solve" which is the Freecell Solver executable for you.</simpara>
<simpara>It will also build and install the board generation program. More
information about them can be found in the "board_gen" sub-directory of
this distribution.</simpara>
</section>
<section id="_changing_the_maximal_number_of_freecells_or_stacks_or_cards_per_stack">
<title>Changing the Maximal number of Freecells or Stacks or Cards per Stack</title>
<simpara>The following parameters to the cmake" script which accept an argument
control the hard-coded parameters of the Freecell Solver executables:</simpara>
<itemizedlist>
<listitem>
<simpara>
"-DMAX_NUM_FREECELLS:STRING=$NUM" - The maximal number of freecells
</simpara>
</listitem>
<listitem>
<simpara>
"-DMAX_NUM_STACKS:STRING=$NUM" - The maximal number of stacks (columns)
</simpara>
</listitem>
<listitem>
<simpara>
"-DMAX_NUM_INITIAL_CARDS_IN_A_STACK:STRING=$NUM" - The maximal number of
initial cards per stack.
</simpara>
</listitem>
</itemizedlist>
<simpara>Notice that it’s very important to set the maximal number of initial cards
per stack, or else it’s possible that a stack will eventually overflow.</simpara>
</section>
<section id="_compact_states">
<title>"Compact" States</title>
<simpara>In Compact States, the contents of the card stacks are stored inside the
states, rather than in a central collection (where the states contain only
pointers). Despite their name, they actually consume more memory than Indirect
Stack States which are the default.</simpara>
<simpara>Compact states used to be faster than Indirect Stack States, but now it
seems indirect stack states are at least slightly faster even for games
whose stacks are not very long. If you still would wish to enable it,
<emphasis role="strong">TODO : FILL IN</emphasis>.</simpara>
</section>
<section id="_installing_under_win32">
<title>Installing under Win32</title>
<simpara>Consult the CMake documentation for generating a Visual C++ , MinGW32
etc. compatible makefile or project.</simpara>
</section>
<section id="_testing">
<title>Testing</title>
<simpara>To test Freecell Solver, you need to:</simpara>
<orderedlist numeration="arabic">
<listitem>
<simpara>
Configure it.
</simpara>
</listitem>
<listitem>
<simpara>
Run "make install".
</simpara>
</listitem>
<listitem>
<simpara>
Type "ctest -V" (or "make test" just for the verdict).
</simpara>
</listitem>
</orderedlist>
<simpara>Please report any errors to me ( <ulink url="http://www.shlomifish.org/me/contact-me/">http://www.shlomifish.org/me/contact-me/</ulink> ).</simpara>
</section>
</article>
|
