=item B<-ec>
-This sets the EngineCommand.
+This is an alias for -pg "EngineCommand=<value>"
=item B<-ed>
-This sets the EngineDir.
+This is an alias for -pg "EngineDir=<value>"
=item B<-en>
-This sets the EngineName.
+This is an alias for -pg "EngineName=<value>"
-=item B<-hash>
+=item B<-log> (default: false)
-This is an alias for -uci "Hash=<value>".
-
-=item B<-log>
-
-This is an alias for -pg "Log=true".
+This is an alias for -pg "Log=<value>"
=item B<-lf> (default: "polyglot.log")
This is an alias for -pg "LogFile=<value>".
-=item B<-bk>
+=item B<-wb> (default: "true")
-This is an alias for -pg "Book=true" -pg "BookFile=<value>".
+This is an alias for -pg "OnlyWbOptions=<value>".
=back
The characters "#" and ";" serve as comment characters.
-By default initial and final white space is stripped from option
-values. If you want to avoid this, or if you want use one of
-the comment characters # or ; in option values (such as for NalimovPath),
-enclose the value in quotes.
+Initial and final white space is stripped from option names and
+values. If you need to use characters which have a special meaning to
+PolyGlot (these are ';#[]=\') you should quote them by preceding them
+with '\'. "Quoting" other characters in this way has no effect. In
+particular the use of '\' as a path separator in windows should
+normally not affected.
=head2 [PolyGlot] section
Put here the name of the engine executable file. You can also add
command-line arguments. Path searching is used and the current
-directory will be "EngineDir".
+directory will be "EngineDir". On Linux the EngineCommand is passed
+to wordexp so that shell quoting rules and expansions are applied.
+On Windows the EngineCommand is simply passed to CreateProcess which
+does its own shell like processing.
+
+=item B<SettingsDir> (default: $HOME/.polyglot on Linux; ".\_PG" on Windows)
+
+The directory where ini files are stored for engines that are started with
+-noini. Such ini files may be created by pushing the "Save" button in the
+Engine settings dialog in WB/XB 4.4.0 and higher. As a special exception
+(for WB/XB 4.4.0 compatibility) this directory is also used in case
+PolyGlot is started with config files named "polyglot_1st.ini" or
+"polyglot_2nd.ini".
=item B<Log> (default: false)
This a bit vector in which each bit represents the processors that a
process is allowed to run on. This option works only on Windows.
-=item B<Persist> (default: true)
-
-If true then PolyGlot will implement persistence by loading options
-from an additional INI file whose name is by default derived from the
-engine name. At exit PolyGlot will also save its options to this INI
-file.
-
-=item B<PersistFile> (default: <EngineName>.ini)
-
-The name of the file from which to take the additional options. It is
-probably best to stick with the default. You can safely edit this
-file, or delete it to restore the default options.
+=item B<OnlyWbOptions> (default: true)
-=item B<PersistDir> (default: $HOME/.polyglot on Linux; ".\Polyglot Settings" on Windows)
-
-The directory where the PersistFile is stored.
+If true then PolyGlot restricts the options it sends to those that
+are potentially useful for WinBoard.
=back
When RepeatPV is false PolyGlot does not repeat the last pv string.
Due to the way kibitzing is implemented, KibitzMove is disabled in that case.
-=item B<WbWorkArounds> (default: true)
-
-The intention of these options is to provide work arounds for
-xboard/winboard bugs should they arise. This one decapitalizes
-the word Draw in options that contain this word. Some versions of
-xboard/winboard contain a bug which causes such options to be
-interpreted as draw claims by the engine.
-
-Engines that send options with "Draw" in their name are Rybka and HIARCS.
-
-=item B<WbWorkArounds2> (default: false)
-
-Old version of Winboard clear the engine output window at depth 1. With this
-work around PG will send info lines at depth >=2. This may or may not improve
-the display.
-
=back
Various enhancements: Fonzy Bleumers<match(at)geenvis.net>
-UCI port, option persistence and new WB protocol: Michel Van den Bergh
+UCI port and implementation of new WB protocol: Michel Van den Bergh
<michel.vandenbergh(at)uhasselt.be>
projects / polyglot.git / blobdiff