updated documentation
[xboard.git] / manual / html_node / Load-and-Save-options.html
1 <html lang="en">
2 <head>
3 <title>Load and Save options - XBoard</title>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta name="description" content="XBoard">
6 <meta name="generator" content="makeinfo 4.12">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="up" href="Options.html#Options" title="Options">
9 <link rel="prev" href="ICS-options.html#ICS-options" title="ICS options">
10 <link rel="next" href="User-interface-options.html#User-interface-options" title="User interface options">
11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
12 <meta http-equiv="Content-Style-Type" content="text/css">
13 <style type="text/css"><!--
14   pre.display { font-family:inherit }
15   pre.format  { font-family:inherit }
16   pre.smalldisplay { font-family:inherit; font-size:smaller }
17   pre.smallformat  { font-family:inherit; font-size:smaller }
18   pre.smallexample { font-size:smaller }
19   pre.smalllisp    { font-size:smaller }
20   span.sc    { font-variant:small-caps }
21   span.roman { font-family:serif; font-weight:normal; } 
22   span.sansserif { font-family:sans-serif; font-weight:normal; } 
23 --></style>
24 </head>
25 <body>
26 <div class="node">
27 <p>
28 <a name="Load-and-Save-options"></a>
29 Next:&nbsp;<a rel="next" accesskey="n" href="User-interface-options.html#User-interface-options">User interface options</a>,
30 Previous:&nbsp;<a rel="previous" accesskey="p" href="ICS-options.html#ICS-options">ICS options</a>,
31 Up:&nbsp;<a rel="up" accesskey="u" href="Options.html#Options">Options</a>
32 <hr>
33 </div>
34
35 <h3 class="section">3.4 Load and Save options</h3>
36
37 <p><a name="index-Options_002c-Load-and-Save-256"></a><a name="index-Load-and-Save-options-257"></a>
38      <dl>
39 <dt>-lgf or -loadGameFile file<dt>-lgi or -loadGameIndex index<dd><a name="index-lgf_002c-option-258"></a><a name="index-loadGameFile_002c-option-259"></a><a name="index-lgi_002c-option-260"></a><a name="index-loadGameIndex_002c-option-261"></a>If the <code>loadGameFile</code> option is set, XBoard loads the specified\r
40 game file at startup. The file name <samp><span class="file">-</span></samp> specifies the standard\r
41 input. If there is more than one game in the file, XBoard\r
42 pops up a menu of the available games, with entries based on their PGN \r
43 (Portable Game Notation) tags.\r
44 If the <code>loadGameIndex</code> option is set to &lsquo;<samp><span class="samp">N</span></samp>&rsquo;, the menu is suppressed\r
45 and the N th game found in the file is loaded immediately.\r
46 The menu is also suppressed if <code>matchMode</code> is enabled or if the game file\r
47 is a pipe; in these cases the first game in the file is loaded immediately.\r
48 Use the <samp><span class="file">pxboard</span></samp> shell script provided with XBoard if you\r
49 want to pipe in files containing multiple games and still see the menu.\r
50 If the loadGameIndex specifies an index -1, this triggers auto-increment\r
51 of the index in <code>matchMode</code>, which means that after every game the\r
52 index is incremented by one, causing each game of the match to be played\r
53 from the next game in the file. Similarly, specifying an index value of -2\r
54 causes the index to be incremented every two games, so that each game\r
55 in the file is used twice (with reversed colors).\r
56 The <code>rewindIndex</code> option causes the index to be reset to the\r
57 first game of the file when it has reached a specified value.\r
58 <br><dt>-rewindIndex n<dd>Causes a position file or game file to be rewound to its beginning after n\r
59 positions or games in auto-increment <code>matchMode</code>. \r
60 See <code>loadPositionIndex</code> and <code>loadGameIndex</code>.\r
61 default: 0 (no rewind).\r
62 <br><dt>-td or -timeDelay seconds<dd><a name="index-td_002c-option-262"></a><a name="index-timeDelay_002c-option-263"></a>Time delay between moves during &lsquo;<samp><span class="samp">Load Game</span></samp>&rsquo;. Fractional seconds\r
63 are allowed; try &lsquo;<samp><span class="samp">-td 0.4</span></samp>&rsquo;. A time delay value of -1 tells\r
64 XBoard not to step through game files automatically. Default: 1\r
65 second.\r
66 <br><dt>-sgf or -saveGameFile file<dd><a name="index-sgf_002c-option-264"></a><a name="index-saveGameFile_002c-option-265"></a>If this option is set, XBoard appends a record of every game\r
67 played to the specified file. The file name <samp><span class="file">-</span></samp> specifies the\r
68 standard output.\r
69 <br><dt>-autosave/-xautosave or -autoSaveGames true/false<dd><a name="index-autosave_002c-option-266"></a><a name="index-autoSaveGames_002c-option-267"></a>Sets the Auto Save menu option.  See <a href="Options-Menu.html#Options-Menu">Options Menu</a>.  Default: false.\r
70 Ignored if <code>saveGameFile</code> is set.\r
71 <br><dt>-lpf or -loadPositionFile file<dt>-lpi or -loadPositionIndex index<dd><a name="index-lpf_002c-option-268"></a><a name="index-loadPositionFile_002c-option-269"></a><a name="index-lpi_002c-option-270"></a><a name="index-loadPositionIndex_002c-option-271"></a>If the <code>loadPositionFile</code> option is set, XBoard loads the\r
72 specified position file at startup. The file name <samp><span class="file">-</span></samp> specifies the\r
73 standard input. If the <code>loadPositionIndex</code> option is set to N,\r
74 the Nth position found in the file is loaded; otherwise the\r
75 first position is loaded.\r
76 If the loadPositionIndex specifies an index -1, this triggers auto-increment\r
77 of the index in <code>matchMode</code>, which means that after every game the\r
78 index is incremented by one, causing each game of the match to be played\r
79 from the next position in the file. Similarly, specifying an index value of -2\r
80 causes the index to be incremented every two games, so that each position\r
81 in the file is used twice (with the engines playing opposite colors).\r
82 The <code>rewindIndex</code> option causes the index to be reset to the\r
83 first position of the file when it has reached a specified value.\r
84 <br><dt>-spf or -savePositionFile file<dd><a name="index-spf_002c-option-272"></a><a name="index-savePositionFile_002c-option-273"></a>If this option is set, XBoard appends the final position reached\r
85 in every game played to the specified file. The file name <samp><span class="file">-</span></samp>\r
86 specifies the standard output.\r
87 <br><dt>-pgnExtendedInfo true/false<dd><a name="index-pgnExtendedInfo_002c-option_0060-274"></a>If this option is set, WinBoard saves depth, score and time used for each \r
88 move that the engine found as a comment in the PGN file.\r
89 Default: false.\r
90 <br><dt>-pgnEventHeader string<dd><a name="index-pgnEventHeader_002c-option_0060-275"></a>Sets the name used in the PGN event tag to string. \r
91 Default: "Computer Chess Game".\r
92 <br><dt>-saveOutOfBookInfo true/false<dd><a name="index-saveOutOfBookInfo_002c-option_0060-276"></a>Include the information on how the engine(s) game out of its opening book in a special 'annotator' tag with the PGN file.\r
93 <br><dt>-oldsave/-xoldsave or -oldSaveStyle true/false<dd><a name="index-oldsave_002c-option-277"></a><a name="index-oldSaveStyle_002c-option-278"></a>Sets the Old Save Style menu option.  See <a href="Options-Menu.html#Options-Menu">Options Menu</a>.  Default: false.\r
94 <br><dt>-gameListTags string<dd><a name="index-gameListTags_002c-option-279"></a>The character string lists the PGN tags that should be printed in the\r
95 Game List, and their order. The meaning of the codes is e=event,\r
96 s=site, d=date, o=round, p=players, r=result, w=white Elo, b=black Elo,\r
97 t=time control, v=variant, a=out-of-book info.\r
98 Default: "eprd"\r
99 </dl>
100    \r
101
102    </body></html>
103