<sect1 id="configuration-dialog">
<title id="configuration-dialog.title">The configuration dialog</title>

<para>
Here you can set global options for &EasySok;.
</para>

<sect2 id="configuration-dialog-opt1">
<title id="configuration-dialog-opt1.title">The core settings</title>

<sect3 id="configuration-dialog-opt1a">
<title id="configuration-dialog-opt1a.title">Jump to next level when solved a level</title>
<para>
If this box is checked, &EasySok; jumps to the next level in the collection, whenever
you solve a level.
</para></sect3>

<sect3 id="configuration-dialog-opt1n">
<title id="configuration-dialog-opt1n.title">Treat illegal moves as virtual moves</title>
<para>
If this box is checked, illegal moves (for example when you try to move trough a wall)
are treated as moves for the virtual keeper. Note that all moves are considered moves
of the virtual keeper afterwards, until the virtual keeper becomes real.

</para></sect3>

<sect3 id="configuration-dialog-opt1b">
<title id="configuration-dialog-opt1b.title">Wrap the virtual keeper</title>
<para>
If this box is checked, the virtual keeper can cross the borders of the map.
This means he will appear at the top, if you move him down at a field in the
lowest line and so on.
</para></sect3>

<sect3 id="configuration-dialog-opt1c">
<title id="configuration-dialog-opt1c.title">Allow goto to any level</title>
<para>
If this box is checked, you are allowed to go to any level.
If the box is unchecked, you can only go to solved levels or levels which
directly follow a solved level.
</para></sect3>

<sect3 id="configuration-dialog-opt1o">
<title id="configuration-dialog-opt1o.title">Always show advanced options</title>
<para>
If this box is checked, the advanced options for complex dialogs are always shown.
</para></sect3>

<sect3 id="configuration-dialog-opt1d">
<title id="configuration-dialog-opt1d.title">Automatic saving of collections, solutions and bookmarks</title>
<para>
Here you can decide, if &EasySok; should automatically store changed collections, new solutions and
changed bookmarks in regular intervals. If you don't check the option, than
these are only stored when you exit &EasySok; (unfortunately only if you don't exit
by a crash). If the option is checked on the other hand, then changed collection, solutions and
bookmarks will be saved in regular intervals, which can specified by you.
</para></sect3>

<sect3 id="configuration-dialog-opt1k">
<title id="configuration-dialog-opt1k.title">Number of recent collections</title>
<para>
Here you can determine the number of collections which are displayed in the recent
collections menu entry.
</para></sect3>

<sect3 id="configuration-dialog-opt1g">
<title id="configuration-dialog-opt1g.title">Show difficulty</title>
<para>
If this option is checked, the difficulty of the current level is shown in the
status bar. Because this can make the status bar quite huge, you may want to
disable it if you have only a small screen.
</para></sect3>

<sect3 id="configuration-dialog-opt1h">
<title id="configuration-dialog-opt1h.title">Show linear pushes</title>
<para>
If this option is checked, the number of linear pushes made so far is displayed
in the status bar. Because this can make the status bar quite huge, you may want to
disable it if you have only a small screen.
</para></sect3>

<sect3 id="configuration-dialog-opt1i">
<title id="configuration-dialog-opt1i.title">Show gem changes</title>
<para>
If this option is checked, the number of gem changes made so far is displayed
in the status bar. Because this can make the status bar quite huge, you may want to
disable it if you have only a small screen.
</para></sect3>



<sect3 id="configuration-dialog-opt1j">
<title id="configuration-dialog-opt1j.title">Show gems left</title>
<para>
If this option is checked, the number of gems left is displayed in the status bar.
</para></sect3>

<sect3 id="configuration-dialog-opt1l">
<title id="configuration-dialog-opt1l.title">Show author</title>
<para>
If this option is checked, the author(s) of the level are displayed in the status bar.
</para></sect3>

<sect3 id="configuration-dialog-opt1m">
<title id="configuration-dialog-opt1m.title">Show user</title>
<para>
If this option is checked, the current user (for the highscore server) is displayed in the status bar.
</para></sect3>

</sect2>

<sect2 id="configuration-dialog-opt7">
<title id="configuration-dialog-opt7.title">The mouse settings</title>

<sect3 id="configuration-dialog-opt7a">
<title id="configuration-dialog-opt7a.title">Auto hiding of mouse cursor</title>
<para>
Sometimes (especially if you play &EasySok; only via the keyboard) the mouse pointer stands
in your way. Therefore &EasySok; lets you select, that the mouse cursor automatically
disappears if not move for a specific ammount of time (or a key on the keyboard ist pressed).
If you want you mouse cursor back, simply move the mouse.
</para></sect3>

<sect3 id="configuration-dialog-opt7b">
<title id="configuration-dialog-opt7b.title">Mouse repeat delay</title>
<para>
Here you can set the time after which the repeat of the undo and redo
functionality (by pressing the &MMB; or &RMB;) is enabled. 
</para></sect3>

<sect3 id="configuration-dialog-opt7c">
<title id="configuration-dialog-opt7c.title">Mouse repeat rate</title>
<para>
Here you can set the rate of the auto repeat of the undo and redo functionality
of the mouse.
</para></sect3>

</sect2>


<sect2 id="configuration-dialog-opt2">
<title id="configuration-dialog-opt2.title">The solver settings</title>

<sect3 id="configuration-dialog-opt2a">
<title id="configuration-dialog-opt2a.title">Number of solver steps in a row</title>
<para>
Here you can set the number of steps the solver should perform without interruption.
The higher the given value, the more slower the solver dialog will react on
user input, but the higher the performance will be.
Depending on your system, a value between 1,000 and 10,000 will be fine.
</para></sect3>

<sect3 id="configuration-dialog-opt2b">
<title id="configuration-dialog-opt2b.title">Number of entries in the cache</title>
<para>
The solver tries to memorize the position it has already visited, in order
to increase the speed.
Here you can set how large his <quote>memory</quote> (called the <quote>cache</quote>) should be.
Larger values will result in more memory consumption, so you should probably
start with values of about 10,000 and increase this value only, if &EasySok;
doesn't uses to much memory.
</para></sect3></sect2>


<sect2 id="configuration-dialog-opt3">
<title id="configuration-dialog-opt3.title">The bookmarks settings</title>

<sect3 id="configuration-dialog-opt3a">
<title id="configuration-dialog-opt3a.title">Number of bookmarks</title>
<para>
Here you can adjust the number of bookmarks you want to use.
Note that bookmarks which fall outside the range are not deleted, but
merely invisible.
You can can them by increasing the number of bookmarks later.
</para></sect3>

<sect3 id="configuration-dialog-opt3b">
<title id="configuration-dialog-opt3b.title">Bookmark format</title>
<para>
Here you can determine the format in which the bookmarks are displayed.
</para>


<sect4 id="configuration-dialog-opt3b1">
<title id="configuration-dialog-opt3b1.title">Date and Time information</title>
<para>
Here you can select the date and time format used in the bookmarks text.
The date and time is the one, when you last set the bookmark.
You can either select, that no date and time information should be
displayed, or that only the date or both date and time should be displayed.
</para></sect4>

<sect4 id="configuration-dialog-opt3b2">
<title id="configuration-dialog-opt3b2.title">Collection and level information</title>
<para>
Here you can select which information about the level and the collection of the
bookmark should be displayed.
You can either select to show no information about the collection and level at all,
only the collection name or the collection name and the level number.
</para></sect4>

<sect4 id="configuration-dialog-opt3b3">
<title id="configuration-dialog-opt3b3.title">Annotations</title>
<para>
Here you can select, if you want your bookmark annotations to be displayed or not.
</para></sect4></sect3></sect2>

<sect2 id="configuration-dialog-opt4">
<title id="configuration-dialog-opt4.title">The animation settings</title>
<para>
Here you can fine tune the three animation speeds for fast, normal and slow
animations.
Note that depending on the operating system you use, a very small value (say
1 ms) will give you sluggish animations.
</para></sect2>

<sect2 id="configuration-dialog-opt5">
<title id="configuration-dialog-opt5.title">The scaling settings</title>

<sect3 id="configuration-dialog-opt5a">
<title id="configuration-dialog-opt5a.title">The minimum size of a field</title>
<para>
Here you can set the minimum size of the fields in pixels.
&EasySok; will not create fields beyond the given size and instead will offer
you to scroll the map in order to see the whole map.
</para></sect3>

<sect3 id="configuration-dialog-opt5b">
<title id="configuration-dialog-opt5b.title">Scaling quality</title>
<para>
&EasySok; tries to always use as much of the window size for the sokoban maps
as possible.
Therefore it scales the images to the needed sizes.
Unfortunately a high quality scaling takes some time and a faster
scaling method doesn't produces very good results.
So &EasySok; offers you the option, to select between the two scaling methods.
But there is also a third option.
Here the fields are first produced in lower quality and after a predefined amount
of time replaced by the high quality images.
Because the reduced performance of the high quality scaling is mostly noticed if
you sweep through the levels, this option is as fast as the low quality scaling
for this operation.
So if you don't mind, that the quality of the fields improves shortly after
you stopped at a level, this is the method of choice.
</para></sect3></sect2>

<sect2 id="configuration-dialog-opt6">
<title id="configuration-dialog-opt6.title">The confirmation settings</title>
<para>
&EasySok; sometimes ask for confirmations, if you are performing a possible
dangerous task.
Normally every confirmation dialog has (or should have) a check box, which
allows you to suppress the dialog in the future.
And here you can activate a former disabled confirmation dialog again.
</para></sect2></sect1>
