613f0a41b1dad2d5e3c3e37414f0906c00c1ff9e
[xboard.git] / args.h
1 /*
2  * args.c -- Option parsing and saving for X and Windows versions of XBoard
3  *
4  * Copyright 1991 by Digital Equipment Corporation, Maynard,
5  * Massachusetts.
6  *
7  * Enhancements Copyright 1992-2001, 2002, 2003, 2004, 2005, 2006,
8  * 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
9  *
10  * Enhancements Copyright 2005 Alessandro Scotti
11  *
12  * The following terms apply to Digital Equipment Corporation's copyright
13  * interest in XBoard:
14  * ------------------------------------------------------------------------
15  * All Rights Reserved
16  *
17  * Permission to use, copy, modify, and distribute this software and its
18  * documentation for any purpose and without fee is hereby granted,
19  * provided that the above copyright notice appear in all copies and that
20  * both that copyright notice and this permission notice appear in
21  * supporting documentation, and that the name of Digital not be
22  * used in advertising or publicity pertaining to distribution of the
23  * software without specific, written prior permission.
24  *
25  * DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
26  * ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
27  * DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
28  * ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
29  * WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
30  * ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
31  * SOFTWARE.
32  * ------------------------------------------------------------------------
33  *
34  * The following terms apply to the enhanced version of XBoard
35  * distributed by the Free Software Foundation:
36  * ------------------------------------------------------------------------
37  *
38  * GNU XBoard is free software: you can redistribute it and/or modify
39  * it under the terms of the GNU General Public License as published by
40  * the Free Software Foundation, either version 3 of the License, or (at
41  * your option) any later version.
42  *
43  * GNU XBoard is distributed in the hope that it will be useful, but
44  * WITHOUT ANY WARRANTY; without even the implied warranty of
45  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
46  * General Public License for more details.
47  *
48  * You should have received a copy of the GNU General Public License
49  * along with this program. If not, see http://www.gnu.org/licenses/.  *
50  *
51  *------------------------------------------------------------------------
52  ** See the file ChangeLog for a revision history.
53 */
54
55 // Note: this file is not a normal header, but contains executable code
56 // for #inclusion in winboard.c and xboard.c, rather than separate compilation,
57 // so that it can make use of the proper context of #defined symbols and
58 // declarations in those files.
59
60 typedef enum {
61   ArgString, ArgInt, ArgFloat, ArgBoolean, ArgTrue, ArgFalse, ArgNone,
62   ArgColor, ArgAttribs, ArgFilename, ArgBoardSize, ArgFont, ArgCommSettings,
63   ArgSettingsFilename, ArgTwo,
64   ArgX, ArgY, ArgZ // [HGM] placement: for window-placement options stored relative to main window
65 } ArgType;
66
67 typedef void *ArgIniType;
68
69 #define INVALID (ArgIniType) 6915 /* Some number unlikely to be needed as default for anything */
70 #define MAX_ARG_LEN 128*1024 /* [AS] For Roger Brown's very long list! */
71
72 typedef struct {
73   char *argName;
74   ArgType argType;
75   /***
76   union {
77     String *pString;       // ArgString
78     int *pInt;             // ArgInt
79     float *pFloat;         // ArgFloat
80     Boolean *pBoolean;     // ArgBoolean
81     COLORREF *pColor;      // ArgColor
82     ColorClass cc;         // ArgAttribs
83     String *pFilename;     // ArgFilename
84     BoardSize *pBoardSize; // ArgBoardSize
85     int whichFont;         // ArgFont
86     DCB *pDCB;             // ArgCommSettings
87     String *pFilename;     // ArgSettingsFilename
88   } argLoc;
89   ***/
90   void *argLoc;
91   Boolean save;
92   ArgIniType defaultValue;
93 } ArgDescriptor;
94
95 typedef struct {
96   char *item;
97   char *command;
98   Boolean getname;
99   Boolean immediate;
100 } IcsTextMenuEntry;
101
102 IcsTextMenuEntry icsTextMenuEntry[ICS_TEXT_MENU_SIZE];
103
104 int junk;
105 Boolean singleList;
106 char *homeDir;
107
108 void EnsureOnScreen(int *x, int *y, int minX, int minY);
109 char StringGet(void *getClosure);
110 void ParseFont(char *name, int number);
111 void SetFontDefaults();
112 void CreateFonts();
113 void ParseColor(int n, char *name);
114 void ParseTextAttribs(ColorClass cc, char *s);
115 void ParseBoardSize(void * addr, char *name);
116 void ParseCommPortSettings(char *name);
117 void LoadAllSounds();
118 void SetCommPortDefaults();
119 void SaveFontArg(FILE *f, ArgDescriptor *ad);
120 void ExportSounds();
121 void SaveAttribsArg(FILE *f, ArgDescriptor *ad);
122 void SaveColor(FILE *f, ArgDescriptor *ad);
123 void SaveBoardSize(FILE *f, char *name, void *addr);
124 void PrintCommPortSettings(FILE *f, char *name);
125 void GetWindowCoords();
126 int  MySearchPath(char *installDir, char *name, char *fullname);
127 int  MyGetFullPathName(char *name, char *fullname);
128 int  MainWindowUp();
129 void PopUpStartupDialog();
130 typedef char GetFunc(void *getClosure);
131 void ParseArgs(GetFunc get, void *cl);
132
133 // [HGM] this is an exact duplicate of something in winboard.c. Move to backend.c?
134 char *defaultTextAttribs[] =
135 {
136   COLOR_SHOUT, COLOR_SSHOUT, COLOR_CHANNEL1, COLOR_CHANNEL, COLOR_KIBITZ,
137   COLOR_TELL, COLOR_CHALLENGE, COLOR_REQUEST, COLOR_SEEK, COLOR_NORMAL,
138   "#000000"
139 };
140
141 ArgDescriptor argDescriptors[] = {
142   /* positional arguments */
143   { "loadGameFile", ArgFilename, (void *) &appData.loadGameFile, FALSE, INVALID },
144   { "", ArgNone, NULL, FALSE, INVALID },
145   /* keyword arguments */
146   JAWS_ARGS
147   { "whitePieceColor", ArgColor, (void *) 0, TRUE, (ArgIniType) WHITE_PIECE_COLOR },
148   { "wpc", ArgColor, (void *) 0, FALSE, INVALID },
149   { "blackPieceColor", ArgColor, (void *) 1, TRUE, (ArgIniType) BLACK_PIECE_COLOR },
150   { "bpc", ArgColor, (void *) 1, FALSE, INVALID },
151   { "lightSquareColor", ArgColor, (void *) 2, TRUE, (ArgIniType) LIGHT_SQUARE_COLOR },
152   { "lsc", ArgColor, (void *) 2, FALSE, INVALID },
153   { "darkSquareColor", ArgColor, (void *) 3, TRUE, (ArgIniType) DARK_SQUARE_COLOR },
154   { "dsc", ArgColor, (void *) 3, FALSE, INVALID },
155   { "highlightSquareColor", ArgColor, (void *) 4, TRUE, (ArgIniType) HIGHLIGHT_SQUARE_COLOR },
156   { "hsc", ArgColor, (void *) 4, FALSE, INVALID },
157   { "premoveHighlightColor", ArgColor, (void *) 5, TRUE, (ArgIniType) PREMOVE_HIGHLIGHT_COLOR },
158   { "phc", ArgColor, (void *) 5, FALSE, INVALID },
159   { "movesPerSession", ArgInt, (void *) &appData.movesPerSession, TRUE, (ArgIniType) MOVES_PER_SESSION },
160   { "mps", ArgInt, (void *) &appData.movesPerSession, FALSE, INVALID },
161   { "initString", ArgString, (void *) &appData.firstInitString, FALSE, INVALID },
162   { "firstInitString", ArgString, (void *) &appData.firstInitString, FALSE, (ArgIniType) INIT_STRING },
163   { "secondInitString", ArgString, (void *) &appData.secondInitString, FALSE, (ArgIniType) INIT_STRING },
164   { "firstComputerString", ArgString, (void *) &appData.firstComputerString,
165     FALSE, (ArgIniType) COMPUTER_STRING },
166   { "secondComputerString", ArgString, (void *) &appData.secondComputerString,
167     FALSE, (ArgIniType) COMPUTER_STRING },
168   { "firstChessProgram", ArgFilename, (void *) &appData.firstChessProgram,
169     FALSE, (ArgIniType) FIRST_CHESS_PROGRAM },
170   { "fcp", ArgFilename, (void *) &appData.firstChessProgram, FALSE, INVALID },
171   { "secondChessProgram", ArgFilename, (void *) &appData.secondChessProgram,
172     FALSE, (ArgIniType) SECOND_CHESS_PROGRAM },
173   { "scp", ArgFilename, (void *) &appData.secondChessProgram, FALSE, INVALID },
174   { "firstPlaysBlack", ArgBoolean, (void *) &appData.firstPlaysBlack, FALSE, FALSE },
175   { "fb", ArgTrue, (void *) &appData.firstPlaysBlack, FALSE, FALSE },
176   { "xfb", ArgFalse, (void *) &appData.firstPlaysBlack, FALSE, INVALID },
177   { "-fb", ArgFalse, (void *) &appData.firstPlaysBlack, FALSE, INVALID },
178   { "noChessProgram", ArgBoolean, (void *) &appData.noChessProgram, FALSE, FALSE },
179   { "ncp", ArgTrue, (void *) &appData.noChessProgram, FALSE, INVALID },
180   { "xncp", ArgFalse, (void *) &appData.noChessProgram, FALSE, INVALID },
181   { "-ncp", ArgFalse, (void *) &appData.noChessProgram, FALSE, INVALID },
182   { "firstHost", ArgString, (void *) &appData.firstHost, FALSE, (ArgIniType) FIRST_HOST },
183   { "fh", ArgString, (void *) &appData.firstHost, FALSE, INVALID },
184   { "secondHost", ArgString, (void *) &appData.secondHost, FALSE, (ArgIniType) SECOND_HOST },
185   { "sh", ArgString, (void *) &appData.secondHost, FALSE, INVALID },
186   { "firstDirectory", ArgFilename, (void *) &appData.firstDirectory, FALSE, (ArgIniType) FIRST_DIRECTORY },
187   { "fd", ArgFilename, (void *) &appData.firstDirectory, FALSE, INVALID },
188   { "secondDirectory", ArgFilename, (void *) &appData.secondDirectory, FALSE, (ArgIniType) SECOND_DIRECTORY },
189   { "sd", ArgFilename, (void *) &appData.secondDirectory, FALSE, INVALID },
190   { "variations", ArgBoolean, (void *) &appData.variations, TRUE, (ArgIniType) FALSE },
191
192   /* some options only used by the XBoard front end, and ignored in WinBoard         */
193   /* Their saving is controlled by XBOARD, which in WinBoard is defined as FALSE */
194   { "internetChessServerInputBox", ArgBoolean, (void *) &appData.icsInputBox, XBOARD, (ArgIniType) FALSE },
195   { "icsinput", ArgTrue, (void *) &appData.icsInputBox, FALSE, INVALID },
196   { "xicsinput", ArgFalse, (void *) &appData.icsInputBox, FALSE, INVALID },
197   { "cmail", ArgString, (void *) &appData.cmailGameName, FALSE, (ArgIniType) "" },
198   { "soundProgram", ArgFilename, (void *) &appData.soundProgram, XBOARD, (ArgIniType) "play" },
199   { "fontSizeTolerance", ArgInt, (void *) &appData.fontSizeTolerance, XBOARD, (ArgIniType) 4 },
200   { "lowTimeWarningColor", ArgColor, (void *) 6, XBOARD, (ArgIniType) LOWTIMEWARNING_COLOR },
201   { "lowTimeWarning", ArgBoolean, (void *) &appData.lowTimeWarning, XBOARD, (ArgIniType) FALSE },
202   { "titleInWindow", ArgBoolean, (void *) &appData.titleInWindow, XBOARD, (ArgIniType) FALSE },
203   { "title", ArgTrue, (void *) &appData.titleInWindow, FALSE, INVALID },
204   { "xtitle", ArgFalse, (void *) &appData.titleInWindow, FALSE, INVALID },
205   { "flashCount", ArgInt, (void *) &appData.flashCount, XBOARD, INVALID }, // let X handle this
206   { "flashRate", ArgInt, (void *) &appData.flashRate, XBOARD, (ArgIniType) FLASH_RATE },
207   { "pixmapDirectory", ArgFilename, (void *) &appData.pixmapDirectory, XBOARD, (ArgIniType) "" },
208   { "pixmap", ArgFilename, (void *) &appData.pixmapDirectory, FALSE, INVALID },
209   { "bitmapDirectory", ArgFilename, (void *) &appData.bitmapDirectory, XBOARD, (ArgIniType) "" },
210   { "bm", ArgFilename, (void *) &appData.bitmapDirectory, FALSE, INVALID },
211   { "soundDirectory", ArgFilename, (void *) &appData.soundDirectory, XBOARD, (ArgIniType) "" },
212   { "msLoginDelay", ArgInt, (void *) &appData.msLoginDelay, XBOARD, (ArgIniType) MS_LOGIN_DELAY },
213   { "pasteSelection", ArgBoolean, (void *) &appData.pasteSelection, XBOARD, (ArgIniType) FALSE },
214
215   { "dropMenu", ArgBoolean, (void *) &appData.dropMenu, TRUE, (ArgIniType) FALSE },
216   { "pieceMenu", ArgBoolean, (void *) &appData.pieceMenu, TRUE, (ArgIniType) TRUE },
217   { "sweepPromotions", ArgBoolean, (void *) &appData.sweepSelect, TRUE, (ArgIniType) FALSE },
218   { "remoteShell", ArgFilename, (void *) &appData.remoteShell, FALSE, (ArgIniType) REMOTE_SHELL },
219   { "rsh", ArgFilename, (void *) &appData.remoteShell, FALSE, INVALID },
220   { "remoteUser", ArgString, (void *) &appData.remoteUser, FALSE, (ArgIniType) "" },
221   { "ruser", ArgString, (void *) &appData.remoteUser, FALSE, INVALID },
222   { "timeDelay", ArgFloat, (void *) &appData.timeDelay, TRUE, INVALID },
223   { "td", ArgFloat, (void *) &appData.timeDelay, FALSE, INVALID },
224   { "timeControl", ArgString, (void *) &appData.timeControl, TRUE, (ArgIniType) TIME_CONTROL },
225   { "tc", ArgString, (void *) &appData.timeControl, FALSE, INVALID },
226   { "timeIncrement", ArgFloat, (void *) &appData.timeIncrement, TRUE, INVALID },
227   { "inc", ArgFloat, (void *) &appData.timeIncrement, FALSE, INVALID },
228   { "internetChessServerMode", ArgBoolean, (void *) &appData.icsActive, FALSE, INVALID },
229   { "ics", ArgTrue, (void *) &appData.icsActive, FALSE, (ArgIniType) FALSE },
230   { "xics", ArgFalse, (void *) &appData.icsActive, FALSE, INVALID },
231   { "-ics", ArgFalse, (void *) &appData.icsActive, FALSE, INVALID },
232   { "internetChessServerHost", ArgString, (void *) &appData.icsHost, FALSE, (ArgIniType) "" },
233   { "icshost", ArgString, (void *) &appData.icsHost, FALSE, INVALID },
234   { "internetChessServerPort", ArgString, (void *) &appData.icsPort, FALSE, (ArgIniType) ICS_PORT },
235   { "icsport", ArgString, (void *) &appData.icsPort, FALSE, INVALID },
236   { "internetChessServerCommPort", ArgString, (void *) &appData.icsCommPort, FALSE, (ArgIniType) ICS_COMM_PORT },
237   { "icscomm", ArgString, (void *) &appData.icsCommPort, FALSE, INVALID },
238   { "internetChessServerComPort", ArgString, (void *) &appData.icsCommPort, FALSE, INVALID },
239   { "icscom", ArgString, (void *) &appData.icsCommPort, FALSE, INVALID },
240   { "internetChessServerLogonScript", ArgFilename, (void *) &appData.icsLogon, FALSE, (ArgIniType) ICS_LOGON },
241   { "icslogon", ArgFilename, (void *) &appData.icsLogon, FALSE, INVALID },
242   { "useTelnet", ArgBoolean, (void *) &appData.useTelnet, FALSE, INVALID },
243   { "telnet", ArgTrue, (void *) &appData.useTelnet, FALSE, INVALID },
244   { "xtelnet", ArgFalse, (void *) &appData.useTelnet, FALSE, INVALID },
245   { "-telnet", ArgFalse, (void *) &appData.useTelnet, FALSE, INVALID },
246   { "telnetProgram", ArgFilename, (void *) &appData.telnetProgram, FALSE, (ArgIniType) TELNET_PROGRAM },
247   { "internetChessserverHelper", ArgFilename, (void *) &appData.icsHelper,
248         FALSE, INVALID }, // for XB
249   { "icshelper", ArgFilename, (void *) &appData.icsHelper, FALSE, (ArgIniType) "" },
250   { "seekGraph", ArgBoolean, (void *) &appData.seekGraph, TRUE, (ArgIniType) FALSE },
251   { "sg", ArgTrue, (void *) &appData.seekGraph, FALSE, INVALID },
252   { "autoRefresh", ArgBoolean, (void *) &appData.autoRefresh, TRUE, (ArgIniType) FALSE },
253   { "gateway", ArgString, (void *) &appData.gateway, FALSE, (ArgIniType) "" },
254   { "loadGameFile", ArgFilename, (void *) &appData.loadGameFile, FALSE, (ArgIniType) "" },
255   { "lgf", ArgFilename, (void *) &appData.loadGameFile, FALSE, INVALID },
256   { "loadGameIndex", ArgInt, (void *) &appData.loadGameIndex, FALSE, (ArgIniType) 0 },
257   { "lgi", ArgInt, (void *) &appData.loadGameIndex, FALSE, INVALID },
258   { "saveGameFile", ArgFilename, (void *) &appData.saveGameFile, TRUE, (ArgIniType) "" },
259   { "sgf", ArgFilename, (void *) &appData.saveGameFile, FALSE, INVALID },
260   { "autoSaveGames", ArgBoolean, (void *) &appData.autoSaveGames, TRUE, (ArgIniType) FALSE },
261   { "autosave", ArgTrue, (void *) &appData.autoSaveGames, FALSE, INVALID },
262   { "xautosave", ArgFalse, (void *) &appData.autoSaveGames, FALSE, INVALID },
263   { "-autosave", ArgFalse, (void *) &appData.autoSaveGames, FALSE, INVALID },
264   { "loadPositionFile", ArgFilename, (void *) &appData.loadPositionFile, FALSE, (ArgIniType) "" },
265   { "lpf", ArgFilename, (void *) &appData.loadPositionFile, FALSE, INVALID },
266   { "loadPositionIndex", ArgInt, (void *) &appData.loadPositionIndex, FALSE, (ArgIniType) 1 },
267   { "lpi", ArgInt, (void *) &appData.loadPositionIndex, FALSE, INVALID },
268   { "savePositionFile", ArgFilename, (void *) &appData.savePositionFile, FALSE, (ArgIniType) "" },
269   { "spf", ArgFilename, (void *) &appData.savePositionFile, FALSE, INVALID },
270   { "matchMode", ArgBoolean, (void *) &appData.matchMode, FALSE, (ArgIniType) FALSE },
271   { "mm", ArgTrue, (void *) &appData.matchMode, FALSE, INVALID },
272   { "xmm", ArgFalse, (void *) &appData.matchMode, FALSE, INVALID },
273   { "-mm", ArgFalse, (void *) &appData.matchMode, FALSE, INVALID },
274   { "matchGames", ArgInt, (void *) &appData.matchGames, FALSE, (ArgIniType) 0 },
275   { "mg", ArgInt, (void *) &appData.matchGames, FALSE, INVALID },
276   { "monoMode", ArgBoolean, (void *) &appData.monoMode, TRUE, (ArgIniType) FALSE },
277   { "mono", ArgTrue, (void *) &appData.monoMode, FALSE, INVALID },
278   { "xmono", ArgFalse, (void *) &appData.monoMode, FALSE, INVALID },
279   { "-mono", ArgFalse, (void *) &appData.monoMode, FALSE, INVALID },
280   { "debugMode", ArgBoolean, (void *) &appData.debugMode, FALSE, (ArgIniType) FALSE },
281   { "debug", ArgTrue, (void *) &appData.debugMode, FALSE, INVALID },
282   { "xdebug", ArgFalse, (void *) &appData.debugMode, FALSE, INVALID },
283   { "-debug", ArgFalse, (void *) &appData.debugMode, FALSE, INVALID },
284   { "clockMode", ArgBoolean, (void *) &appData.clockMode, FALSE, (ArgIniType) TRUE },
285   { "clock", ArgTrue, (void *) &appData.clockMode, FALSE, INVALID },
286   { "xclock", ArgFalse, (void *) &appData.clockMode, FALSE, INVALID },
287   { "-clock", ArgFalse, (void *) &appData.clockMode, FALSE, INVALID },
288   { "searchTime", ArgString, (void *) &appData.searchTime, FALSE, (ArgIniType) "" },
289   { "st", ArgString, (void *) &appData.searchTime, FALSE, INVALID },
290   { "searchDepth", ArgInt, (void *) &appData.searchDepth, FALSE, (ArgIniType) 0 },
291   { "depth", ArgInt, (void *) &appData.searchDepth, FALSE, INVALID },
292   { "showCoords", ArgBoolean, (void *) &appData.showCoords, TRUE, (ArgIniType) FALSE },
293   { "coords", ArgTrue, (void *) &appData.showCoords, FALSE, INVALID },
294   { "xcoords", ArgFalse, (void *) &appData.showCoords, FALSE, INVALID },
295   { "-coords", ArgFalse, (void *) &appData.showCoords, FALSE, INVALID },
296   { "showThinking", ArgBoolean, (void *) &appData.showThinking, TRUE, (ArgIniType) FALSE },
297   { "thinking", ArgTrue, (void *) &appData.showThinking, FALSE, INVALID },
298   { "xthinking", ArgFalse, (void *) &appData.showThinking, FALSE, INVALID },
299   { "-thinking", ArgFalse, (void *) &appData.showThinking, FALSE, INVALID },
300   { "ponderNextMove", ArgBoolean, (void *) &appData.ponderNextMove, TRUE, (ArgIniType) TRUE },
301   { "ponder", ArgTrue, (void *) &appData.ponderNextMove, FALSE, INVALID },
302   { "xponder", ArgFalse, (void *) &appData.ponderNextMove, FALSE, INVALID },
303   { "-ponder", ArgFalse, (void *) &appData.ponderNextMove, FALSE, INVALID },
304   { "periodicUpdates", ArgBoolean, (void *) &appData.periodicUpdates, TRUE, (ArgIniType) TRUE },
305   { "periodic", ArgTrue, (void *) &appData.periodicUpdates, FALSE, INVALID },
306   { "xperiodic", ArgFalse, (void *) &appData.periodicUpdates, FALSE, INVALID },
307   { "-periodic", ArgFalse, (void *) &appData.periodicUpdates, FALSE, INVALID },
308   { "popupExitMessage", ArgBoolean, (void *) &appData.popupExitMessage, TRUE, (ArgIniType) TRUE },
309   { "exit", ArgTrue, (void *) &appData.popupExitMessage, FALSE, INVALID },
310   { "xexit", ArgFalse, (void *) &appData.popupExitMessage, FALSE, INVALID },
311   { "-exit", ArgFalse, (void *) &appData.popupExitMessage, FALSE, INVALID },
312   { "popupMoveErrors", ArgBoolean, (void *) &appData.popupMoveErrors, TRUE, (ArgIniType) FALSE },
313   { "popup", ArgTrue, (void *) &appData.popupMoveErrors, FALSE, INVALID },
314   { "xpopup", ArgFalse, (void *) &appData.popupMoveErrors, FALSE, INVALID },
315   { "-popup", ArgFalse, (void *) &appData.popupMoveErrors, FALSE, INVALID },
316   { "popUpErrors", ArgBoolean, (void *) &appData.popupMoveErrors,
317     FALSE, INVALID }, /* only so that old WinBoard.ini files from betas can be read */
318   { "clockFont", ArgFont, (void *) CLOCK_FONT, TRUE, INVALID },
319   { "messageFont", ArgFont, (void *) MESSAGE_FONT, TRUE, INVALID },
320   { "font", ArgFont, (void *) MESSAGE_FONT, FALSE, INVALID }, /* only so that old .xboardrc files will parse. -font does not work from the command line because it is captured by the X libraries. */
321   { "coordFont", ArgFont, (void *) COORD_FONT, TRUE, INVALID },
322   { "tagsFont", ArgFont, (void *) EDITTAGS_FONT, TRUE, INVALID },
323   { "commentFont", ArgFont, (void *) COMMENT_FONT, TRUE, INVALID },
324   { "icsFont", ArgFont, (void *) CONSOLE_FONT, TRUE, INVALID },
325   { "moveHistoryFont", ArgFont, (void *) MOVEHISTORY_FONT, TRUE, INVALID }, /* [AS] */
326   { "gameListFont", ArgFont, (void *) GAMELIST_FONT, TRUE, INVALID }, /* [HGM] */
327   { "boardSize", ArgBoardSize, (void *) &boardSize,
328     TRUE, (ArgIniType) -1 }, /* must come after all fonts */
329   { "size", ArgBoardSize, (void *) &boardSize, FALSE, INVALID },
330   { "ringBellAfterMoves", ArgBoolean, (void *) &appData.ringBellAfterMoves,
331     FALSE, (ArgIniType) TRUE }, /* historical; kept only so old winboard.ini files will parse */
332   { "bell", ArgTrue, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
333   { "xbell", ArgFalse, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
334   { "movesound", ArgTrue, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
335   { "xmovesound", ArgFalse, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
336   { "alwaysOnTop", ArgBoolean, (void *) &alwaysOnTop, TRUE, INVALID },
337   { "top", ArgTrue, (void *) &alwaysOnTop, FALSE, INVALID },
338   { "xtop", ArgFalse, (void *) &alwaysOnTop, FALSE, INVALID },
339   { "-top", ArgFalse, (void *) &alwaysOnTop, FALSE, INVALID },
340   { "autoCallFlag", ArgBoolean, (void *) &appData.autoCallFlag, TRUE, (ArgIniType) FALSE },
341   { "autoflag", ArgTrue, (void *) &appData.autoCallFlag, FALSE, INVALID },
342   { "xautoflag", ArgFalse, (void *) &appData.autoCallFlag, FALSE, INVALID },
343   { "-autoflag", ArgFalse, (void *) &appData.autoCallFlag, FALSE, INVALID },
344   { "autoComment", ArgBoolean, (void *) &appData.autoComment, TRUE, (ArgIniType) FALSE },
345   { "autocomm", ArgTrue, (void *) &appData.autoComment, FALSE, INVALID },
346   { "xautocomm", ArgFalse, (void *) &appData.autoComment, FALSE, INVALID },
347   { "-autocomm", ArgFalse, (void *) &appData.autoComment, FALSE, INVALID },
348   { "autoObserve", ArgBoolean, (void *) &appData.autoObserve, TRUE, (ArgIniType) FALSE },
349   { "autobs", ArgTrue, (void *) &appData.autoObserve, FALSE, INVALID },
350   { "xautobs", ArgFalse, (void *) &appData.autoObserve, FALSE, INVALID },
351   { "-autobs", ArgFalse, (void *) &appData.autoObserve, FALSE, INVALID },
352   { "flipView", ArgBoolean, (void *) &appData.flipView, FALSE, (ArgIniType) FALSE },
353   { "flip", ArgTrue, (void *) &appData.flipView, FALSE, INVALID },
354   { "xflip", ArgFalse, (void *) &appData.flipView, FALSE, INVALID },
355   { "-flip", ArgFalse, (void *) &appData.flipView, FALSE, INVALID },
356   { "autoFlipView", ArgBoolean, (void *) &appData.autoFlipView, TRUE, (ArgIniType) TRUE },
357   { "autoflip", ArgTrue, (void *) &appData.autoFlipView, FALSE, INVALID },
358   { "xautoflip", ArgFalse, (void *) &appData.autoFlipView, FALSE, INVALID },
359   { "-autoflip", ArgFalse, (void *) &appData.autoFlipView, FALSE, INVALID },
360   { "autoRaiseBoard", ArgBoolean, (void *) &appData.autoRaiseBoard, TRUE, (ArgIniType) TRUE },
361   { "autoraise", ArgTrue, (void *) &appData.autoRaiseBoard, FALSE, INVALID },
362   { "xautoraise", ArgFalse, (void *) &appData.autoRaiseBoard, FALSE, INVALID },
363   { "-autoraise", ArgFalse, (void *) &appData.autoRaiseBoard, FALSE, INVALID },
364   { "alwaysPromoteToQueen", ArgBoolean, (void *) &appData.alwaysPromoteToQueen, TRUE, (ArgIniType) FALSE },
365   { "queen", ArgTrue, (void *) &appData.alwaysPromoteToQueen, FALSE, INVALID },
366   { "xqueen", ArgFalse, (void *) &appData.alwaysPromoteToQueen, FALSE, INVALID },
367   { "-queen", ArgFalse, (void *) &appData.alwaysPromoteToQueen, FALSE, INVALID },
368   { "oldSaveStyle", ArgBoolean, (void *) &appData.oldSaveStyle, TRUE, (ArgIniType) FALSE },
369   { "oldsave", ArgTrue, (void *) &appData.oldSaveStyle, FALSE, INVALID },
370   { "xoldsave", ArgFalse, (void *) &appData.oldSaveStyle, FALSE, INVALID },
371   { "-oldsave", ArgFalse, (void *) &appData.oldSaveStyle, FALSE, INVALID },
372   { "quietPlay", ArgBoolean, (void *) &appData.quietPlay, TRUE, (ArgIniType) FALSE },
373   { "quiet", ArgTrue, (void *) &appData.quietPlay, FALSE, INVALID },
374   { "xquiet", ArgFalse, (void *) &appData.quietPlay, FALSE, INVALID },
375   { "-quiet", ArgFalse, (void *) &appData.quietPlay, FALSE, INVALID },
376   { "getMoveList", ArgBoolean, (void *) &appData.getMoveList, TRUE, (ArgIniType) TRUE },
377   { "moves", ArgTrue, (void *) &appData.getMoveList, FALSE, INVALID },
378   { "xmoves", ArgFalse, (void *) &appData.getMoveList, FALSE, INVALID },
379   { "-moves", ArgFalse, (void *) &appData.getMoveList, FALSE, INVALID },
380   { "testLegality", ArgBoolean, (void *) &appData.testLegality, TRUE, (ArgIniType) TRUE },
381   { "legal", ArgTrue, (void *) &appData.testLegality, FALSE, INVALID },
382   { "xlegal", ArgFalse, (void *) &appData.testLegality, FALSE, INVALID },
383   { "-legal", ArgFalse, (void *) &appData.testLegality, FALSE, INVALID },
384   { "premove", ArgBoolean, (void *) &appData.premove, TRUE, (ArgIniType) TRUE },
385   { "pre", ArgTrue, (void *) &appData.premove, FALSE, INVALID },
386   { "xpre", ArgFalse, (void *) &appData.premove, FALSE, INVALID },
387   { "-pre", ArgFalse, (void *) &appData.premove, FALSE, INVALID },
388   { "premoveWhite", ArgBoolean, (void *) &appData.premoveWhite, TRUE, (ArgIniType) FALSE },
389   { "prewhite", ArgTrue, (void *) &appData.premoveWhite, FALSE, INVALID },
390   { "xprewhite", ArgFalse, (void *) &appData.premoveWhite, FALSE, INVALID },
391   { "-prewhite", ArgFalse, (void *) &appData.premoveWhite, FALSE, INVALID },
392   { "premoveWhiteText", ArgString, (void *) &appData.premoveWhiteText, TRUE, (ArgIniType) "" },
393   { "premoveBlack", ArgBoolean, (void *) &appData.premoveBlack, TRUE, (ArgIniType) FALSE },
394   { "preblack", ArgTrue, (void *) &appData.premoveBlack, FALSE, INVALID },
395   { "xpreblack", ArgFalse, (void *) &appData.premoveBlack, FALSE, INVALID },
396   { "-preblack", ArgFalse, (void *) &appData.premoveBlack, FALSE, INVALID },
397   { "premoveBlackText", ArgString, (void *) &appData.premoveBlackText, TRUE, (ArgIniType) "" },
398   { "icsAlarm", ArgBoolean, (void *) &appData.icsAlarm, TRUE, (ArgIniType) TRUE},
399   { "alarm", ArgTrue, (void *) &appData.icsAlarm, FALSE},
400   { "xalarm", ArgFalse, (void *) &appData.icsAlarm, FALSE},
401   { "-alarm", ArgFalse, (void *) &appData.icsAlarm, FALSE},
402   { "icsAlarmTime", ArgInt, (void *) &appData.icsAlarmTime, TRUE, (ArgIniType) 5000},
403   { "localLineEditing", ArgBoolean, (void *) &appData.localLineEditing, FALSE, (ArgIniType) TRUE},
404   { "edit", ArgTrue, (void *) &appData.localLineEditing, FALSE, INVALID },
405   { "xedit", ArgFalse, (void *) &appData.localLineEditing, FALSE, INVALID },
406   { "-edit", ArgFalse, (void *) &appData.localLineEditing, FALSE, INVALID },
407   { "animateMoving", ArgBoolean, (void *) &appData.animate, TRUE, (ArgIniType) TRUE },
408   { "animate", ArgTrue, (void *) &appData.animate, FALSE, INVALID },
409   { "xanimate", ArgFalse, (void *) &appData.animate, FALSE, INVALID },
410   { "-animate", ArgFalse, (void *) &appData.animate, FALSE, INVALID },
411   { "animateSpeed", ArgInt, (void *) &appData.animSpeed, TRUE, (ArgIniType) 10 },
412   { "animateDragging", ArgBoolean, (void *) &appData.animateDragging, TRUE, (ArgIniType) TRUE },
413   { "drag", ArgTrue, (void *) &appData.animateDragging, FALSE, INVALID },
414   { "xdrag", ArgFalse, (void *) &appData.animateDragging, FALSE, INVALID },
415   { "-drag", ArgFalse, (void *) &appData.animateDragging, FALSE, INVALID },
416   { "blindfold", ArgBoolean, (void *) &appData.blindfold, TRUE, (ArgIniType) FALSE },
417   { "blind", ArgTrue, (void *) &appData.blindfold, FALSE, INVALID },
418   { "xblind", ArgFalse, (void *) &appData.blindfold, FALSE, INVALID },
419   { "-blind", ArgFalse, (void *) &appData.blindfold, FALSE, INVALID },
420   { "highlightLastMove", ArgBoolean,
421     (void *) &appData.highlightLastMove, TRUE, (ArgIniType) TRUE },
422   { "highlight", ArgTrue, (void *) &appData.highlightLastMove, FALSE, INVALID },
423   { "xhighlight", ArgFalse, (void *) &appData.highlightLastMove, FALSE, INVALID },
424   { "-highlight", ArgFalse, (void *) &appData.highlightLastMove, FALSE, INVALID },
425   { "highlightDragging", ArgBoolean,
426     (void *) &appData.highlightDragging, !XBOARD, (ArgIniType) TRUE },
427   { "highdrag", ArgTrue, (void *) &appData.highlightDragging, FALSE, INVALID },
428   { "xhighdrag", ArgFalse, (void *) &appData.highlightDragging, FALSE, INVALID },
429   { "-highdrag", ArgFalse, (void *) &appData.highlightDragging, FALSE, INVALID },
430   { "colorizeMessages", ArgBoolean, (void *) &appData.colorize, TRUE, (ArgIniType) TRUE },
431   { "colorize", ArgTrue, (void *) &appData.colorize, FALSE, INVALID },
432   { "xcolorize", ArgFalse, (void *) &appData.colorize, FALSE, INVALID },
433   { "-colorize", ArgFalse, (void *) &appData.colorize, FALSE, INVALID },
434   { "colorShout", ArgAttribs, (void *) ColorShout, TRUE, INVALID },
435   { "colorSShout", ArgAttribs, (void *) ColorSShout, TRUE, INVALID },
436   { "colorCShout", ArgAttribs, (void *) ColorSShout, FALSE, INVALID }, // for XB
437   { "colorChannel1", ArgAttribs, (void *) ColorChannel1, TRUE, INVALID },
438   { "colorChannel", ArgAttribs, (void *) ColorChannel, TRUE, INVALID },
439   { "colorKibitz", ArgAttribs, (void *) ColorKibitz, TRUE, INVALID },
440   { "colorTell", ArgAttribs, (void *) ColorTell, TRUE, INVALID },
441   { "colorChallenge", ArgAttribs, (void *) ColorChallenge, TRUE, INVALID },
442   { "colorRequest", ArgAttribs, (void *) ColorRequest, TRUE, INVALID },
443   { "colorSeek", ArgAttribs, (void *) ColorSeek, TRUE, INVALID },
444   { "colorNormal", ArgAttribs, (void *) ColorNormal, TRUE, INVALID },
445   { "colorBackground", ArgColor, (void *) 7, TRUE, COLOR_BKGD },
446   { "soundShout", ArgFilename, (void *) &appData.soundShout, TRUE, (ArgIniType) "" },
447   { "soundSShout", ArgFilename, (void *) &appData.soundSShout, TRUE, (ArgIniType) "" },
448   { "soundCShout", ArgFilename, (void *) &appData.soundSShout, FALSE, (ArgIniType) "" }, // for XB
449   { "soundChannel1", ArgFilename, (void *) &appData.soundChannel1, TRUE, (ArgIniType) "" },
450   { "soundChannel", ArgFilename, (void *) &appData.soundChannel, TRUE, (ArgIniType) "" },
451   { "soundKibitz", ArgFilename, (void *) &appData.soundKibitz, TRUE, (ArgIniType) "" },
452   { "soundTell", ArgFilename, (void *) &appData.soundTell, TRUE, (ArgIniType) "" },
453   { "soundChallenge", ArgFilename, (void *) &appData.soundChallenge, TRUE, (ArgIniType) "" },
454   { "soundRequest", ArgFilename, (void *) &appData.soundRequest, TRUE, (ArgIniType) "" },
455   { "soundSeek", ArgFilename, (void *) &appData.soundSeek, TRUE, (ArgIniType) "" },
456   { "soundMove", ArgFilename, (void *) &appData.soundMove, TRUE, (ArgIniType) "" },
457   { "soundBell", ArgFilename, (void *) &appData.soundBell, TRUE, (ArgIniType) SOUND_BELL },
458   { "soundIcsWin", ArgFilename, (void *) &appData.soundIcsWin, TRUE, (ArgIniType) "" },
459   { "soundIcsLoss", ArgFilename, (void *) &appData.soundIcsLoss, TRUE, (ArgIniType) "" },
460   { "soundIcsDraw", ArgFilename, (void *) &appData.soundIcsDraw, TRUE, (ArgIniType) "" },
461   { "soundIcsUnfinished", ArgFilename, (void *) &appData.soundIcsUnfinished, TRUE, (ArgIniType) "" },
462   { "soundIcsAlarm", ArgFilename, (void *) &appData.soundIcsAlarm, TRUE, (ArgIniType) "" },
463   { "disguisePromotedPieces", ArgBoolean, (void *) &appData.disguise, TRUE, (ArgIniType) TRUE },
464   { "reuseFirst", ArgBoolean, (void *) &appData.reuseFirst, FALSE, (ArgIniType) TRUE },
465   { "reuse", ArgTrue, (void *) &appData.reuseFirst, FALSE, INVALID },
466   { "xreuse", ArgFalse, (void *) &appData.reuseFirst, FALSE, INVALID },
467   { "-reuse", ArgFalse, (void *) &appData.reuseFirst, FALSE, INVALID },
468   { "reuseChessPrograms", ArgBoolean,
469     (void *) &appData.reuseFirst, FALSE, INVALID }, /* backward compat only */
470   { "reuseSecond", ArgBoolean, (void *) &appData.reuseSecond, FALSE, (ArgIniType) TRUE },
471   { "reuse2", ArgTrue, (void *) &appData.reuseSecond, FALSE, INVALID },
472   { "xreuse2", ArgFalse, (void *) &appData.reuseSecond, FALSE, INVALID },
473   { "-reuse2", ArgFalse, (void *) &appData.reuseSecond, FALSE, INVALID },
474   { "comPortSettings", ArgCommSettings, (void *) /*&dcb*/ 0, TRUE, INVALID },
475   { "settingsFile", ArgSettingsFilename, (void *) &settingsFileName, FALSE, (ArgIniType) SETTINGS_FILE },
476   { "ini", ArgSettingsFilename, (void *) &settingsFileName, FALSE, INVALID },
477   { "at", ArgSettingsFilename, (void *) NULL, FALSE, INVALID },
478   { "opt", ArgSettingsFilename, (void *) NULL, FALSE, INVALID },
479   { "saveSettingsFile", ArgFilename, (void *) &settingsFileName, FALSE, INVALID },
480   { "saveSettingsOnExit", ArgBoolean, (void *) &saveSettingsOnExit, TRUE, (ArgIniType) TRUE },
481   { "chessProgram", ArgBoolean, (void *) &chessProgram, FALSE, (ArgIniType) FALSE },
482   { "cp", ArgTrue, (void *) &chessProgram, FALSE, INVALID },
483   { "xcp", ArgFalse, (void *) &chessProgram, FALSE, INVALID },
484   { "-cp", ArgFalse, (void *) &chessProgram, FALSE, INVALID },
485   { "icsMenu", ArgString, (void *) &icsTextMenuString, TRUE, (ArgIniType) ICS_TEXT_MENU_DEFAULT },
486   { "icsNames", ArgString, (void *) &icsNames, TRUE, (ArgIniType) ICS_NAMES },
487   { "singleEngineList", ArgBoolean, (void *) &singleList, !XBOARD, (ArgIniType) FALSE },
488   { "recentEngines", ArgInt, (void *) &appData.recentEngines, TRUE, (ArgIniType) 6 },
489   { "recentEngineList", ArgString, (void *) &appData.recentEngineList, TRUE, (ArgIniType) "" },
490   { "firstChessProgramNames", ArgString, (void *) &firstChessProgramNames,
491     TRUE, (ArgIniType) FCP_NAMES },
492   { "secondChessProgramNames", ArgString, (void *) &secondChessProgramNames,
493     !XBOARD, (ArgIniType) SCP_NAMES },
494   { "initialMode", ArgString, (void *) &appData.initialMode, FALSE, (ArgIniType) "" },
495   { "mode", ArgString, (void *) &appData.initialMode, FALSE, INVALID },
496   { "variant", ArgString, (void *) &appData.variant, FALSE, (ArgIniType) "normal" },
497   { "firstProtocolVersion", ArgInt, (void *) &appData.firstProtocolVersion, FALSE, (ArgIniType) PROTOVER },
498   { "secondProtocolVersion", ArgInt, (void *) &appData.secondProtocolVersion,FALSE, (ArgIniType) PROTOVER },
499   { "showButtonBar", ArgBoolean, (void *) &appData.showButtonBar, TRUE, (ArgIniType) TRUE },
500   { "buttons", ArgTrue, (void *) &appData.showButtonBar, FALSE, INVALID },
501   { "xbuttons", ArgFalse, (void *) &appData.showButtonBar, FALSE, INVALID },
502   { "-buttons", ArgFalse, (void *) &appData.showButtonBar, FALSE, INVALID },
503
504   /* [AS] New features */
505   { "firstScoreAbs", ArgBoolean, (void *) &appData.firstScoreIsAbsolute, FALSE, (ArgIniType) FALSE },
506   { "secondScoreAbs", ArgBoolean, (void *) &appData.secondScoreIsAbsolute, FALSE, (ArgIniType) FALSE },
507   { "pgnExtendedInfo", ArgBoolean, (void *) &appData.saveExtendedInfoInPGN, TRUE, (ArgIniType) FALSE },
508   { "hideThinkingFromHuman", ArgBoolean, (void *) &appData.hideThinkingFromHuman, TRUE, (ArgIniType) FALSE },
509   { "liteBackTextureFile", ArgString, (void *) &appData.liteBackTextureFile, TRUE, (ArgIniType) "" },
510   { "darkBackTextureFile", ArgString, (void *) &appData.darkBackTextureFile, TRUE, (ArgIniType) "" },
511   { "liteBackTextureMode", ArgInt, (void *) &appData.liteBackTextureMode, TRUE, (ArgIniType) BACK_TEXTURE_MODE_PLAIN },
512   { "darkBackTextureMode", ArgInt, (void *) &appData.darkBackTextureMode, TRUE, (ArgIniType) BACK_TEXTURE_MODE_PLAIN },
513   { "renderPiecesWithFont", ArgString, (void *) &appData.renderPiecesWithFont, TRUE, (ArgIniType) "" },
514   { "fontPieceToCharTable", ArgString, (void *) &appData.fontToPieceTable, TRUE, (ArgIniType) "" },
515   { "fontPieceBackColorWhite", ArgColor, (void *) 8, TRUE, (ArgIniType) WHITE_PIECE_COLOR },
516   { "fontPieceForeColorWhite", ArgColor, (void *) 9, TRUE, (ArgIniType) WHITE_PIECE_COLOR },
517   { "fontPieceBackColorBlack", ArgColor, (void *) 10, TRUE, (ArgIniType) BLACK_PIECE_COLOR },
518   { "fontPieceForeColorBlack", ArgColor, (void *) 11, TRUE, (ArgIniType) BLACK_PIECE_COLOR },
519   { "fontPieceSize", ArgInt, (void *) &appData.fontPieceSize, TRUE, (ArgIniType) 80 },
520   { "overrideLineGap", ArgInt, (void *) &appData.overrideLineGap, TRUE, (ArgIniType) 1 },
521   { "adjudicateLossThreshold", ArgInt, (void *) &appData.adjudicateLossThreshold, TRUE, (ArgIniType) 0 },
522   { "delayBeforeQuit", ArgInt, (void *) &appData.delayBeforeQuit, TRUE, (ArgIniType) 0 },
523   { "delayAfterQuit", ArgInt, (void *) &appData.delayAfterQuit, TRUE, (ArgIniType) 0 },
524   { "nameOfDebugFile", ArgFilename, (void *) &appData.nameOfDebugFile, FALSE, (ArgIniType) DEBUG_FILE },
525   { "debugfile", ArgFilename, (void *) &appData.nameOfDebugFile, FALSE, INVALID },
526   { "pgnEventHeader", ArgString, (void *) &appData.pgnEventHeader, TRUE, (ArgIniType) "Computer Chess Game" },
527   { "defaultFrcPosition", ArgInt, (void *) &appData.defaultFrcPosition, TRUE, (ArgIniType) -1 },
528   { "shuffleOpenings", ArgTrue, (void *) &shuffleOpenings, FALSE, INVALID },
529   { "gameListTags", ArgString, (void *) &appData.gameListTags, TRUE, (ArgIniType) GLT_DEFAULT_TAGS },
530   { "saveOutOfBookInfo", ArgBoolean, (void *) &appData.saveOutOfBookInfo, TRUE, (ArgIniType) TRUE },
531   { "showEvalInMoveHistory", ArgBoolean, (void *) &appData.showEvalInMoveHistory, TRUE, (ArgIniType) TRUE },
532   { "evalHistColorWhite", ArgColor, (void *) 12, TRUE, (ArgIniType) "#FFFFB0" },
533   { "evalHistColorBlack", ArgColor, (void *) 13, TRUE, (ArgIniType) "#AD5D3D" },
534   { "highlightMoveWithArrow", ArgBoolean, (void *) &appData.highlightMoveWithArrow, TRUE, (ArgIniType) FALSE },
535   { "highlightArrowColor", ArgColor, (void *) 14, TRUE, (ArgIniType) "#FFFF80" },
536   { "stickyWindows", ArgBoolean, (void *) &appData.useStickyWindows, TRUE, (ArgIniType) TRUE },
537   { "adjudicateDrawMoves", ArgInt, (void *) &appData.adjudicateDrawMoves, TRUE, (ArgIniType) 0 },
538   { "autoDisplayComment", ArgBoolean, (void *) &appData.autoDisplayComment, TRUE, (ArgIniType) TRUE },
539   { "autoDisplayTags", ArgBoolean, (void *) &appData.autoDisplayTags, TRUE, (ArgIniType) TRUE },
540   { "firstIsUCI", ArgBoolean, (void *) &appData.firstIsUCI, FALSE, (ArgIniType) FALSE },
541   { "fUCI", ArgTrue, (void *) &appData.firstIsUCI, FALSE, INVALID },
542   { "firstUCI", ArgTrue, (void *) &appData.firstIsUCI, FALSE, INVALID },
543   { "secondIsUCI", ArgBoolean, (void *) &appData.secondIsUCI, FALSE, (ArgIniType) FALSE },
544   { "sUCI", ArgTrue, (void *) &appData.secondIsUCI, FALSE, INVALID },
545   { "fUCCI", ArgTwo, (void *) &appData.firstIsUCI, FALSE, INVALID },
546   { "sUCCI", ArgTwo, (void *) &appData.secondIsUCI, FALSE, INVALID },
547   { "fUSI", ArgTwo, (void *) &appData.firstIsUCI, FALSE, INVALID },
548   { "sUSI", ArgTwo, (void *) &appData.secondIsUCI, FALSE, INVALID },
549   { "secondUCI", ArgTrue, (void *) &appData.secondIsUCI, FALSE, INVALID },
550   { "firstHasOwnBookUCI", ArgBoolean, (void *) &appData.firstHasOwnBookUCI, FALSE, (ArgIniType) TRUE },
551   { "fNoOwnBookUCI", ArgFalse, (void *) &appData.firstHasOwnBookUCI, FALSE, INVALID },
552   { "firstXBook", ArgFalse, (void *) &appData.firstHasOwnBookUCI, FALSE, INVALID },
553   { "secondHasOwnBookUCI", ArgBoolean, (void *) &appData.secondHasOwnBookUCI, FALSE, (ArgIniType) TRUE },
554   { "sNoOwnBookUCI", ArgFalse, (void *) &appData.secondHasOwnBookUCI, FALSE, INVALID },
555   { "secondXBook", ArgFalse, (void *) &appData.secondHasOwnBookUCI, FALSE, INVALID },
556   { "adapterCommand", ArgFilename, (void *) &appData.adapterCommand, TRUE, (ArgIniType) "polyglot -noini -ec \"%fcp\" -ed \"%fd\"" },
557   { "uxiAdapter", ArgFilename, (void *) &appData.ucciAdapter, TRUE, (ArgIniType) "" },
558   { "polyglotDir", ArgFilename, (void *) &appData.polyglotDir, TRUE, (ArgIniType) "" },
559   { "usePolyglotBook", ArgBoolean, (void *) &appData.usePolyglotBook, TRUE, (ArgIniType) FALSE },
560   { "polyglotBook", ArgFilename, (void *) &appData.polyglotBook, TRUE, (ArgIniType) "" },
561   { "bookDepth", ArgInt, (void *) &appData.bookDepth, TRUE, (ArgIniType) 12 },
562   { "bookVariation", ArgInt, (void *) &appData.bookStrength, TRUE, (ArgIniType) 50 },
563   { "discourageOwnBooks", ArgBoolean, (void *) &appData.defNoBook, TRUE, (ArgIniType) FALSE },
564   { "defaultHashSize", ArgInt, (void *) &appData.defaultHashSize, TRUE, (ArgIniType) 64 },
565   { "defaultCacheSizeEGTB", ArgInt, (void *) &appData.defaultCacheSizeEGTB, TRUE, (ArgIniType) 4 },
566   { "defaultPathEGTB", ArgFilename, (void *) &appData.defaultPathEGTB, TRUE, (ArgIniType) "c:\\egtb" },
567   { "language", ArgFilename, (void *) &appData.language, TRUE, (ArgIniType) "" },
568   { "userFileDirectory", ArgFilename, (void *) &homeDir, FALSE, (ArgIniType) installDir },
569   { "usePieceFont", ArgBoolean, (void *) &appData.useFont, TRUE, (ArgIniType) FALSE },
570   { "useBoardTexture", ArgBoolean, (void *) &appData.useBitmaps, TRUE, (ArgIniType) FALSE },
571
572   // [HGM] tournament options
573   { "tourneyFile", ArgFilename, (void *) &appData.tourneyFile, FALSE, (ArgIniType) "" },
574   { "tf", ArgFilename, (void *) &appData.tourneyFile, FALSE, INVALID },
575   { "participants", ArgString, (void *) &appData.participants, FALSE, (ArgIniType) "" },
576   { "tourneyType", ArgInt, (void *) &appData.tourneyType, FALSE, (ArgIniType) 0 },
577   { "tt", ArgInt, (void *) &appData.tourneyType, FALSE, INVALID },
578   { "tourneyCycles", ArgInt, (void *) &appData.tourneyCycles, FALSE, (ArgIniType) 1 },
579   { "cy", ArgInt, (void *) &appData.tourneyCycles, FALSE, INVALID },
580   { "results", ArgString, (void *) &appData.results, FALSE, (ArgIniType) "" },
581   { "syncAfterRound", ArgBoolean, (void *) &appData.roundSync, FALSE, (ArgIniType) FALSE },
582   { "syncAfterCycle", ArgBoolean, (void *) &appData.cycleSync, FALSE, (ArgIniType) TRUE },
583   { "seedBase", ArgInt, (void *) &appData.seedBase, FALSE, (ArgIniType) 1 },
584   { "pgnNumberTag", ArgBoolean, (void *) &appData.numberTag, TRUE, (ArgIniType) FALSE },
585   { "afterGame", ArgString, (void *) &appData.afterGame, FALSE, INVALID },
586   { "afterTourney", ArgString, (void *) &appData.afterTourney, FALSE, INVALID },
587
588   /* [HGM] board-size, adjudication and misc. options */
589   { "oneClickMove", ArgBoolean, (void *) &appData.oneClick, TRUE, (ArgIniType) FALSE },
590   { "boardWidth", ArgInt, (void *) &appData.NrFiles, FALSE, (ArgIniType) -1 },
591   { "boardHeight", ArgInt, (void *) &appData.NrRanks, FALSE, (ArgIniType) -1 },
592   { "holdingsSize", ArgInt, (void *) &appData.holdingsSize, FALSE, (ArgIniType) -1 },
593   { "defaultMatchGames", ArgInt, (void *) &appData.defaultMatchGames, TRUE, (ArgIniType) 10 },
594   { "matchPause", ArgInt, (void *) &appData.matchPause, TRUE, (ArgIniType) 10000 },
595   { "pieceToCharTable", ArgString, (void *) &appData.pieceToCharTable, FALSE, INVALID },
596   { "pieceNickNames", ArgString, (void *) &appData.pieceNickNames, FALSE, INVALID },
597   { "colorNickNames", ArgString, (void *) &appData.colorNickNames, FALSE, INVALID },
598   { "flipBlack", ArgBoolean, (void *) &appData.upsideDown, FALSE, (ArgIniType) FALSE },
599   { "allWhite", ArgBoolean, (void *) &appData.allWhite, FALSE, (ArgIniType) FALSE },
600   { "alphaRank", ArgBoolean, (void *) &appData.alphaRank, FALSE, (ArgIniType) FALSE },
601   { "firstAlphaRank", ArgBoolean, (void *) &first.alphaRank, FALSE, (ArgIniType) FALSE },
602   { "secondAlphaRank", ArgBoolean, (void *) &second.alphaRank, FALSE, (ArgIniType) FALSE },
603   { "testClaims", ArgBoolean, (void *) &appData.testClaims, TRUE, (ArgIniType) FALSE },
604   { "checkMates", ArgBoolean, (void *) &appData.checkMates, TRUE, (ArgIniType) FALSE },
605   { "materialDraws", ArgBoolean, (void *) &appData.materialDraws, TRUE, (ArgIniType) FALSE },
606   { "trivialDraws", ArgBoolean, (void *) &appData.trivialDraws, TRUE, (ArgIniType) FALSE },
607   { "ruleMoves", ArgInt, (void *) &appData.ruleMoves, TRUE, (ArgIniType) 51 },
608   { "repeatsToDraw", ArgInt, (void *) &appData.drawRepeats, TRUE, (ArgIniType) 6 },
609   { "backgroundObserve", ArgBoolean, (void *) &appData.bgObserve, TRUE, (ArgIniType) FALSE },
610   { "dualBoard", ArgBoolean, (void *) &appData.dualBoard, TRUE, (ArgIniType) FALSE },
611   { "autoKibitz", ArgTrue, (void *) &appData.autoKibitz, FALSE, INVALID },
612   { "engineDebugOutput", ArgInt, (void *) &appData.engineComments, FALSE, (ArgIniType) 1 },
613   { "userName", ArgString, (void *) &appData.userName, FALSE, INVALID },
614   { "rewindIndex", ArgInt, (void *) &appData.rewindIndex, FALSE, INVALID },
615   { "sameColorGames", ArgInt, (void *) &appData.sameColorGames, FALSE, INVALID },
616   { "smpCores", ArgInt, (void *) &appData.smpCores, TRUE, (ArgIniType) 1 },
617   { "egtFormats", ArgString, (void *) &appData.egtFormats, TRUE, (ArgIniType) "" },
618   { "niceEngines", ArgInt, (void *) &appData.niceEngines, TRUE, INVALID },
619   { "firstLogo", ArgFilename, (void *) &appData.firstLogo, FALSE, INVALID },
620   { "secondLogo", ArgFilename, (void *) &appData.secondLogo, FALSE, INVALID },
621   { "autoLogo", ArgBoolean, (void *) &appData.autoLogo, TRUE, INVALID },
622   { "firstOptions", ArgString, (void *) &appData.firstOptions, FALSE, (ArgIniType) "" },
623   { "secondOptions", ArgString, (void *) &appData.secondOptions, FALSE, (ArgIniType) "" },
624   { "firstFeatures", ArgString, (void *) &appData.features[0], FALSE, (ArgIniType) "" },
625   { "secondFeatures", ArgString, (void *) &appData.features[1], FALSE, (ArgIniType) "" },
626   { "featureDefaults", ArgString, (void *) &appData.featureDefaults, TRUE, (ArgIniType) "" },
627   { "firstNeedsNoncompliantFEN", ArgString, (void *) &appData.fenOverride1, FALSE, (ArgIniType) NULL },
628   { "secondNeedsNoncompliantFEN", ArgString, (void *) &appData.fenOverride2, FALSE, (ArgIniType) NULL },
629   { "keepAlive", ArgInt, (void *) &appData.keepAlive, FALSE, INVALID },
630   { "icstype", ArgInt, (void *) &ics_type, FALSE, INVALID },
631   { "forceIllegalMoves", ArgTrue, (void *) &appData.forceIllegal, FALSE, INVALID },
632   { "showTargetSquares", ArgBoolean, (void *) &appData.markers, TRUE, (ArgIniType) FALSE },
633   { "firstPgnName", ArgString, (void *) &appData.pgnName[0], FALSE, (ArgIniType) "" },
634   { "fn", ArgString, (void *) &appData.pgnName[0], FALSE, INVALID },
635   { "secondPgnName", ArgString, (void *) &appData.pgnName[1], FALSE, (ArgIniType) "" },
636   { "sn", ArgString, (void *) &appData.pgnName[1], FALSE, INVALID },
637   { "absoluteAnalysisScores", ArgBoolean, (void *) &appData.whitePOV, TRUE, FALSE },
638   { "scoreWhite", ArgBoolean, (void *) &appData.scoreWhite, TRUE, FALSE },
639   { "evalZoom", ArgInt, (void *) &appData.zoom, TRUE, (ArgIniType) 1 },
640   { "evalThreshold", ArgInt, (void *) &appData.evalThreshold, TRUE, (ArgIniType) 25 },
641   { "fSAN", ArgTrue, (void *) &appData.pvSAN[0], FALSE, FALSE },
642   { "sSAN", ArgTrue, (void *) &appData.pvSAN[1], FALSE, FALSE },
643   { "pairingEngine", ArgFilename, (void *) &appData.pairingEngine, TRUE, "" },
644   { "defaultTourneyName", ArgFilename, (void *) &appData.defName, TRUE, "" },
645   { "eloThresholdAny", ArgInt, (void *) &appData.eloThreshold1, FALSE, (ArgIniType) 0 },
646   { "eloThresholdBoth", ArgInt, (void *) &appData.eloThreshold2, FALSE, (ArgIniType) 0 },
647   { "dateThreshold", ArgInt, (void *) &appData.dateThreshold, FALSE, (ArgIniType) 0 },
648   { "searchMode", ArgInt, (void *) &appData.searchMode, FALSE, (ArgIniType) 1 },
649   { "stretch", ArgInt, (void *) &appData.stretch, FALSE, (ArgIniType) 1 },
650   { "ignoreColors", ArgBoolean, (void *) &appData.ignoreColors, FALSE, FALSE },
651   { "findMirrorImage", ArgBoolean, (void *) &appData.findMirror, FALSE, FALSE },
652   { "viewer", ArgTrue, (void *) &appData.viewer, FALSE, FALSE },
653   { "viewerOptions", ArgString, (void *) &appData.viewerOptions, TRUE, (ArgIniType) "-ncp -engineOutputUp false -saveSettingsOnExit false" },
654   { "autoCopyPV", ArgBoolean, (void *) &appData.autoCopyPV, TRUE, FALSE },
655
656 #if ZIPPY
657   { "zippyTalk", ArgBoolean, (void *) &appData.zippyTalk, FALSE, (ArgIniType) ZIPPY_TALK },
658   { "zt", ArgTrue, (void *) &appData.zippyTalk, FALSE, INVALID },
659   { "xzt", ArgFalse, (void *) &appData.zippyTalk, FALSE, INVALID },
660   { "-zt", ArgFalse, (void *) &appData.zippyTalk, FALSE, INVALID },
661   { "zippyPlay", ArgBoolean, (void *) &appData.zippyPlay, FALSE, (ArgIniType) ZIPPY_PLAY },
662   { "zp", ArgTrue, (void *) &appData.zippyPlay, FALSE, INVALID },
663   { "xzp", ArgFalse, (void *) &appData.zippyPlay, FALSE, INVALID },
664   { "-zp", ArgFalse, (void *) &appData.zippyPlay, FALSE, INVALID },
665   { "zippyLines", ArgFilename, (void *) &appData.zippyLines, FALSE, (ArgIniType) ZIPPY_LINES },
666   { "zippyPinhead", ArgString, (void *) &appData.zippyPinhead, FALSE, (ArgIniType) ZIPPY_PINHEAD },
667   { "zippyPassword", ArgString, (void *) &appData.zippyPassword, FALSE, (ArgIniType) ZIPPY_PASSWORD },
668   { "zippyPassword2", ArgString, (void *) &appData.zippyPassword2, FALSE, (ArgIniType) ZIPPY_PASSWORD2 },
669   { "zippyWrongPassword", ArgString, (void *) &appData.zippyWrongPassword,
670     FALSE, (ArgIniType) ZIPPY_WRONG_PASSWORD },
671   { "zippyAcceptOnly", ArgString, (void *) &appData.zippyAcceptOnly, FALSE, (ArgIniType) ZIPPY_ACCEPT_ONLY },
672   { "zippyUseI", ArgBoolean, (void *) &appData.zippyUseI, FALSE, (ArgIniType) ZIPPY_USE_I },
673   { "zui", ArgTrue, (void *) &appData.zippyUseI, FALSE, INVALID },
674   { "xzui", ArgFalse, (void *) &appData.zippyUseI, FALSE, INVALID },
675   { "-zui", ArgFalse, (void *) &appData.zippyUseI, FALSE, INVALID },
676   { "zippyBughouse", ArgInt, (void *) &appData.zippyBughouse, FALSE, (ArgIniType) ZIPPY_BUGHOUSE },
677   { "zippyNoplayCrafty", ArgBoolean, (void *) &appData.zippyNoplayCrafty,
678     FALSE, (ArgIniType) ZIPPY_NOPLAY_CRAFTY },
679   { "znc", ArgTrue, (void *) &appData.zippyNoplayCrafty, FALSE, INVALID },
680   { "xznc", ArgFalse, (void *) &appData.zippyNoplayCrafty, FALSE, INVALID },
681   { "-znc", ArgFalse, (void *) &appData.zippyNoplayCrafty, FALSE, INVALID },
682   { "zippyGameEnd", ArgString, (void *) &appData.zippyGameEnd, FALSE, (ArgIniType) ZIPPY_GAME_END },
683   { "zippyGameStart", ArgString, (void *) &appData.zippyGameStart, FALSE, (ArgIniType) ZIPPY_GAME_START },
684   { "zippyAdjourn", ArgBoolean, (void *) &appData.zippyAdjourn, FALSE, (ArgIniType) ZIPPY_ADJOURN },
685   { "zadj", ArgTrue, (void *) &appData.zippyAdjourn, FALSE, INVALID },
686   { "xzadj", ArgFalse, (void *) &appData.zippyAdjourn, FALSE, INVALID },
687   { "-zadj", ArgFalse, (void *) &appData.zippyAdjourn, FALSE, INVALID },
688   { "zippyAbort", ArgBoolean, (void *) &appData.zippyAbort, FALSE, (ArgIniType) ZIPPY_ABORT },
689   { "zab", ArgTrue, (void *) &appData.zippyAbort, FALSE, INVALID },
690   { "xzab", ArgFalse, (void *) &appData.zippyAbort, FALSE, INVALID },
691   { "-zab", ArgFalse, (void *) &appData.zippyAbort, FALSE, INVALID },
692   { "zippyVariants", ArgString, (void *) &appData.zippyVariants, FALSE, (ArgIniType) ZIPPY_VARIANTS },
693   { "zippyMaxGames", ArgInt, (void *)&appData.zippyMaxGames, FALSE, (ArgIniType) ZIPPY_MAX_GAMES},
694   { "zippyReplayTimeout", ArgInt, (void *)&appData.zippyReplayTimeout, FALSE, (ArgIniType) ZIPPY_REPLAY_TIMEOUT },
695   { "zippyShortGame", ArgInt, (void *)&appData.zippyShortGame, FALSE, INVALID },
696   /* Kludge to allow winboard.ini files from buggy 4.0.4 to be read: */
697   { "zippyReplyTimeout", ArgInt, (void *)&junk, FALSE, INVALID },
698 #endif
699   /* [HGM] options for broadcasting and time odds */
700   { "chatBoxes", ArgString, (void *) &appData.chatBoxes, !XBOARD, (ArgIniType) NULL },
701   { "serverMoves", ArgString, (void *) &appData.serverMovesName, FALSE, (ArgIniType) NULL },
702   { "serverFile", ArgString, (void *) &appData.serverFileName, FALSE, (ArgIniType) NULL },
703   { "suppressLoadMoves", ArgBoolean, (void *) &appData.suppressLoadMoves, FALSE, (ArgIniType) FALSE },
704   { "serverPause", ArgInt, (void *) &appData.serverPause, FALSE, (ArgIniType) 15 },
705   { "firstTimeOdds", ArgInt, (void *) &appData.firstTimeOdds, FALSE, (ArgIniType) 1 },
706   { "secondTimeOdds", ArgInt, (void *) &appData.secondTimeOdds, FALSE, (ArgIniType) 1 },
707   { "timeOddsMode", ArgInt, (void *) &appData.timeOddsMode, TRUE, INVALID },
708   { "firstAccumulateTC", ArgInt, (void *) &appData.firstAccumulateTC, FALSE, (ArgIniType) 1 },
709   { "secondAccumulateTC", ArgInt, (void *) &appData.secondAccumulateTC, FALSE, (ArgIniType) 1 },
710   { "firstNPS", ArgInt, (void *) &appData.firstNPS, FALSE, (ArgIniType) -1 },
711   { "secondNPS", ArgInt, (void *) &appData.secondNPS, FALSE, (ArgIniType) -1 },
712   { "noGUI", ArgTrue, (void *) &appData.noGUI, FALSE, INVALID },
713   { "keepLineBreaksICS", ArgBoolean, (void *) &appData.noJoin, TRUE, INVALID },
714   { "wrapContinuationSequence", ArgString, (void *) &appData.wrapContSeq, FALSE, INVALID },
715   { "useInternalWrap", ArgTrue, (void *) &appData.useInternalWrap, FALSE, INVALID }, /* noJoin usurps this if set */
716
717   // [HGM] placement: put all window layouts last in ini file, but man X,Y before all others
718   { "minX", ArgZ, (void *) &minX, FALSE, INVALID }, // [HGM] placement: to make suer auxialary windows can be placed
719   { "minY", ArgZ, (void *) &minY, FALSE, INVALID },
720   { "winWidth",  ArgInt, (void *) &wpMain.width,  TRUE, INVALID }, // [HGM] placement: dummies to remember right & bottom
721   { "winHeight", ArgInt, (void *) &wpMain.height, TRUE, INVALID }, //       for attaching auxiliary windows to them
722   { "x", ArgInt, (void *) &wpMain.x, TRUE, (ArgIniType) CW_USEDEFAULT },
723   { "y", ArgInt, (void *) &wpMain.y, TRUE, (ArgIniType) CW_USEDEFAULT },
724   { "icsX", ArgX,   (void *) &wpConsole.x, TRUE, (ArgIniType) CW_USEDEFAULT },
725   { "icsY", ArgY,   (void *) &wpConsole.y, TRUE, (ArgIniType) CW_USEDEFAULT },
726   { "icsW", ArgInt, (void *) &wpConsole.width, TRUE, (ArgIniType) CW_USEDEFAULT },
727   { "icsH", ArgInt, (void *) &wpConsole.height, TRUE, (ArgIniType) CW_USEDEFAULT },
728   { "analysisX", ArgX,   (void *) &junk, FALSE, INVALID }, // [HGM] placement: analysis window no longer exists
729   { "analysisY", ArgY,   (void *) &junk, FALSE, INVALID }, //       provided for compatibility with old ini files
730   { "analysisW", ArgInt, (void *) &junk, FALSE, INVALID },
731   { "analysisH", ArgInt, (void *) &junk, FALSE, INVALID },
732   { "commentX", ArgX,   (void *) &wpComment.x, TRUE, (ArgIniType) CW_USEDEFAULT },
733   { "commentY", ArgY,   (void *) &wpComment.y, TRUE, (ArgIniType) CW_USEDEFAULT },
734   { "commentW", ArgInt, (void *) &wpComment.width, TRUE, (ArgIniType) CW_USEDEFAULT },
735   { "commentH", ArgInt, (void *) &wpComment.height, TRUE, (ArgIniType) CW_USEDEFAULT },
736   { "tagsX", ArgX,   (void *) &wpTags.x, TRUE, (ArgIniType) CW_USEDEFAULT },
737   { "tagsY", ArgY,   (void *) &wpTags.y, TRUE, (ArgIniType) CW_USEDEFAULT },
738   { "tagsW", ArgInt, (void *) &wpTags.width, TRUE, (ArgIniType) CW_USEDEFAULT },
739   { "tagsH", ArgInt, (void *) &wpTags.height, TRUE, (ArgIniType) CW_USEDEFAULT },
740   { "gameListX", ArgX,   (void *) &wpGameList.x, TRUE, (ArgIniType) CW_USEDEFAULT },
741   { "gameListY", ArgY,   (void *) &wpGameList.y, TRUE, (ArgIniType) CW_USEDEFAULT },
742   { "gameListW", ArgInt, (void *) &wpGameList.width, TRUE, (ArgIniType) CW_USEDEFAULT },
743   { "gameListH", ArgInt, (void *) &wpGameList.height, TRUE, (ArgIniType) CW_USEDEFAULT },
744   /* [AS] Layout stuff */
745   { "moveHistoryUp", ArgBoolean, (void *) &wpMoveHistory.visible, TRUE, (ArgIniType) TRUE },
746   { "moveHistoryX", ArgX,   (void *) &wpMoveHistory.x, TRUE, (ArgIniType) CW_USEDEFAULT },
747   { "moveHistoryY", ArgY,   (void *) &wpMoveHistory.y, TRUE, (ArgIniType) CW_USEDEFAULT },
748   { "moveHistoryW", ArgInt, (void *) &wpMoveHistory.width, TRUE, (ArgIniType) CW_USEDEFAULT },
749   { "moveHistoryH", ArgInt, (void *) &wpMoveHistory.height, TRUE, (ArgIniType) CW_USEDEFAULT },
750
751   { "evalGraphUp", ArgBoolean, (void *) &wpEvalGraph.visible, TRUE, (ArgIniType) TRUE },
752   { "evalGraphX", ArgX,   (void *) &wpEvalGraph.x, TRUE, (ArgIniType) CW_USEDEFAULT },
753   { "evalGraphY", ArgY,   (void *) &wpEvalGraph.y, TRUE, (ArgIniType) CW_USEDEFAULT },
754   { "evalGraphW", ArgInt, (void *) &wpEvalGraph.width, TRUE, (ArgIniType) CW_USEDEFAULT },
755   { "evalGraphH", ArgInt, (void *) &wpEvalGraph.height, TRUE, (ArgIniType) CW_USEDEFAULT },
756
757   { "engineOutputUp", ArgBoolean, (void *) &wpEngineOutput.visible, TRUE, (ArgIniType) TRUE },
758   { "engineOutputX", ArgX,   (void *) &wpEngineOutput.x, TRUE, (ArgIniType) CW_USEDEFAULT },
759   { "engineOutputY", ArgY,   (void *) &wpEngineOutput.y, TRUE, (ArgIniType) CW_USEDEFAULT },
760   { "engineOutputW", ArgInt, (void *) &wpEngineOutput.width, TRUE, (ArgIniType) CW_USEDEFAULT },
761   { "engineOutputH", ArgInt, (void *) &wpEngineOutput.height, TRUE, (ArgIniType) CW_USEDEFAULT },
762
763   { NULL, ArgNone, NULL, FALSE, INVALID }
764 };
765
766
767 /* Kludge for indirection files on command line */
768 char* lastIndirectionFilename;
769 ArgDescriptor argDescriptorIndirection =
770 { "", ArgSettingsFilename, (void *) NULL, FALSE };
771
772 void
773 ExitArgError(char *msg, char *badArg, Boolean quit)
774 {
775   char buf[MSG_SIZ];
776   int len;
777
778   len = snprintf(buf, MSG_SIZ, msg, badArg);
779   if( (len >= MSG_SIZ) && appData.debugMode )
780     fprintf(debugFP, "ExitArgError: buffer truncated. Input: msg=%s badArg=%s\n", msg, badArg);
781
782   if(!quit) { printf(_("%s in settings file\n"), buf); return; } // DisplayError does not work yet at this stage...
783   DisplayFatalError(buf, 0, 2);
784   exit(2);
785 }
786
787 int
788 ValidateInt(char *s)
789 {
790   char *p = s;
791   if(*p == '-' || *p == '+') p++;
792   while(*p) if(!isdigit(*p++)) ExitArgError(_("Bad integer value %s"), s, TRUE);
793   return atoi(s);
794 }
795
796 char
797 StringGet(void *getClosure)
798 {
799   char **p = (char **) getClosure;
800   return *((*p)++);
801 }
802
803 char
804 FileGet(void *getClosure)
805 {
806   int c;
807   FILE* f = (FILE*) getClosure;
808
809   c = getc(f);
810   if (c == '\r') c = getc(f); // work around DOS format files by bypassing the '\r' completely
811   if (c == EOF)
812     return NULLCHAR;
813   else
814     return (char) c;
815 }
816
817 /* Parse settings file named "name". If file found, return the
818    full name in fullname and return TRUE; else return FALSE */
819 Boolean
820 ParseSettingsFile(char *name, char **addr)
821 {
822   FILE *f;
823   int ok,len;
824   char buf[MSG_SIZ], fullname[MSG_SIZ];
825
826
827   ok = MySearchPath(installDir, name, fullname);
828   if(!ok && strchr(name, '.') == NULL)
829     { // append default file-name extension '.ini' when needed
830       len = snprintf(buf,MSG_SIZ, "%s.ini", name);
831       if( (len >= MSG_SIZ) && appData.debugMode )
832         fprintf(debugFP, "ParseSettingsFile: buffer truncated. Input: name=%s \n",name);
833
834       ok = MySearchPath(installDir, buf, fullname);
835     }
836   if (ok) {
837     f = fopen(fullname, "r");
838     if (f != NULL) {
839       if (addr != NULL) {
840             ASSIGN(*addr, fullname);
841       }
842       ParseArgs(FileGet, f);
843       fclose(f);
844       return TRUE;
845     }
846   }
847   return FALSE;
848 }
849
850 void
851 ParseArgs(GetFunc get, void *cl)
852 {
853   char argName[MAX_ARG_LEN];
854   char argValue[MAX_ARG_LEN];
855   ArgDescriptor *ad;
856   char start;
857   char *q;
858   int i, octval;
859   char ch;
860   int posarg = 0;
861
862   ch = get(cl);
863   for (;;) {
864     while (ch == ' ' || ch == '\n' || ch == '\t') ch = get(cl);
865     if (ch == NULLCHAR) break;
866     if (ch == ';') {
867       /* Comment to end of line */
868       ch = get(cl);
869       while (ch != '\n' && ch != NULLCHAR) ch = get(cl);
870       continue;
871     } else if (ch == '/' || ch == '-') {
872       /* Switch */
873       q = argName;
874       while (ch != ' ' && ch != '=' && ch != ':' && ch != NULLCHAR &&
875              ch != '\n' && ch != '\t') {
876         *q++ = ch;
877         ch = get(cl);
878       }
879       *q = NULLCHAR;
880       for (ad = argDescriptors; ad->argName != NULL; ad++)
881         if (strcmp(ad->argName, argName + 1) == 0) break;
882       if (ad->argName == NULL) {
883         ExitArgError(_("Unrecognized argument %s"), argName, get != &FileGet); // [HGM] make unknown argument non-fatal
884         while (ch != '\n' && ch != NULLCHAR) ch = get(cl); // but skip rest of line it is on
885         continue; // so that when it is in a settings file, it is the only setting that will be purged from it
886       }
887     } else if (ch == '@') {
888       /* Indirection file */
889       ad = &argDescriptorIndirection;
890       ch = get(cl);
891     } else {
892       /* Positional argument */
893       ad = &argDescriptors[posarg++];
894       strncpy(argName, ad->argName,sizeof(argName)/sizeof(argName[0]));
895     }
896
897     if (ad->argType == ArgTwo) { // [HGM] kludgey arg type, not suitable for saving
898       *(Boolean *) ad->argLoc = 2;
899       continue;
900     }
901     if (ad->argType == ArgTrue) {
902       *(Boolean *) ad->argLoc = TRUE;
903       continue;
904     }
905     if (ad->argType == ArgFalse) {
906       *(Boolean *) ad->argLoc = FALSE;
907       continue;
908     }
909
910     while (ch == ' ' || ch == '=' || ch == ':' || ch == '\t') ch = get(cl);
911     if (ch == NULLCHAR || ch == '\n') {
912       ExitArgError(_("No value provided for argument %s"), argName, TRUE);
913     }
914     q = argValue;
915     if (ch == '{') {
916       // Quoting with { }.  No characters have to (or can) be escaped.
917       // Thus the string cannot contain a '}' character.
918       start = ch;
919       ch = get(cl);
920       while (start) {
921         switch (ch) {
922         case NULLCHAR:
923           start = NULLCHAR;
924           break;
925
926         case '}':
927           ch = get(cl);
928           start = NULLCHAR;
929           break;
930
931         default:
932           *q++ = ch;
933           ch = get(cl);
934           break;
935         }
936       }
937     } else if (ch == '\'' || ch == '"') {
938       // Quoting with ' ' or " ", with \ as escape character.
939       // Inconvenient for long strings that may contain Windows filenames.
940       start = ch;
941       ch = get(cl);
942       while (start) {
943         switch (ch) {
944         case NULLCHAR:
945           start = NULLCHAR;
946           break;
947
948         default:
949         not_special:
950           *q++ = ch;
951           ch = get(cl);
952           break;
953
954         case '\'':
955         case '\"':
956           if (ch == start) {
957             ch = get(cl);
958             start = NULLCHAR;
959             break;
960           } else {
961             goto not_special;
962           }
963
964         case '\\':
965           if (ad->argType == ArgFilename
966               || ad->argType == ArgSettingsFilename) {
967               goto not_special;
968           }
969           ch = get(cl);
970           switch (ch) {
971           case NULLCHAR:
972             ExitArgError(_("Incomplete \\ escape in value for %s"), argName, TRUE);
973             break;
974           case 'n':
975             *q++ = '\n';
976             ch = get(cl);
977             break;
978           case 'r':
979             *q++ = '\r';
980             ch = get(cl);
981             break;
982           case 't':
983             *q++ = '\t';
984             ch = get(cl);
985             break;
986           case 'b':
987             *q++ = '\b';
988             ch = get(cl);
989             break;
990           case 'f':
991             *q++ = '\f';
992             ch = get(cl);
993             break;
994           default:
995             octval = 0;
996             for (i = 0; i < 3; i++) {
997               if (ch >= '0' && ch <= '7') {
998                 octval = octval*8 + (ch - '0');
999                 ch = get(cl);
1000               } else {
1001                 break;
1002               }
1003             }
1004             if (i > 0) {
1005               *q++ = (char) octval;
1006             } else {
1007               *q++ = ch;
1008               ch = get(cl);
1009             }
1010             break;
1011           }
1012           break;
1013         }
1014       }
1015     } else {
1016       while (ch != ' ' && ch != NULLCHAR && ch != '\t' && ch != '\n') {
1017         *q++ = ch;
1018         ch = get(cl);
1019       }
1020     }
1021     *q = NULLCHAR;
1022
1023     switch (ad->argType) {
1024     case ArgInt:
1025       *(int *) ad->argLoc = ValidateInt(argValue);
1026       break;
1027
1028     case ArgX:
1029       *(int *) ad->argLoc = ValidateInt(argValue) + wpMain.x; // [HGM] placement: translate stored relative to absolute
1030       break;
1031
1032     case ArgY:
1033       *(int *) ad->argLoc = ValidateInt(argValue) + wpMain.y; // (this is really kludgey, it should be done where used...)
1034       break;
1035
1036     case ArgZ:
1037       *(int *) ad->argLoc = ValidateInt(argValue);
1038       EnsureOnScreen(&wpMain.x, &wpMain.y, minX, minY);
1039       break;
1040
1041     case ArgFloat:
1042       *(float *) ad->argLoc = (float) atof(argValue);
1043       break;
1044
1045     case ArgString:
1046     case ArgFilename:
1047       ASSIGN(*(char **) ad->argLoc, argValue);
1048       break;
1049
1050     case ArgSettingsFilename:
1051       {
1052         if (ParseSettingsFile(argValue, (char**)ad->argLoc)) {
1053         } else {
1054           if (ad->argLoc != NULL) {
1055           } else {
1056             ExitArgError(_("Failed to open indirection file %s"), argValue, TRUE);
1057           }
1058         }
1059       }
1060       break;
1061
1062     case ArgBoolean:
1063       switch (argValue[0]) {
1064       case 't':
1065       case 'T':
1066         *(Boolean *) ad->argLoc = TRUE;
1067         break;
1068       case 'f':
1069       case 'F':
1070         *(Boolean *) ad->argLoc = FALSE;
1071         break;
1072       default:
1073         ExitArgError(_("Unrecognized boolean argument value %s"), argValue, TRUE);
1074         break;
1075       }
1076       break;
1077
1078     case ArgColor:
1079       ParseColor((int)(intptr_t)ad->argLoc, argValue);
1080       break;
1081
1082     case ArgAttribs: {
1083       ColorClass cc = (ColorClass)ad->argLoc;
1084         ParseTextAttribs(cc, argValue); // [HGM] wrapper for platform independency
1085       }
1086       break;
1087
1088     case ArgBoardSize:
1089       ParseBoardSize(ad->argLoc, argValue);
1090       break;
1091
1092     case ArgFont:
1093       ParseFont(argValue, (int)(intptr_t)ad->argLoc);
1094       break;
1095
1096     case ArgCommSettings:
1097       ParseCommPortSettings(argValue);
1098       break;
1099
1100     case ArgNone:
1101       ExitArgError(_("Unrecognized argument %s"), argValue, TRUE);
1102       break;
1103     case ArgTwo:
1104     case ArgTrue:
1105     case ArgFalse: ;
1106     }
1107   }
1108 }
1109
1110 void
1111 ParseArgsFromString(char *p)
1112 {
1113     ParseArgs(StringGet, &p);
1114 }
1115
1116 void
1117 ParseArgsFromFile(FILE *f)
1118 {
1119     ParseArgs(FileGet, f);
1120 }
1121
1122 void
1123 ParseIcsTextMenu(char *icsTextMenuString)
1124 {
1125 //  int flags = 0;
1126   IcsTextMenuEntry *e = icsTextMenuEntry;
1127   char *p = icsTextMenuString;
1128   while (e->item != NULL && e < icsTextMenuEntry + ICS_TEXT_MENU_SIZE) {
1129     free(e->item);
1130     e->item = NULL;
1131     if (e->command != NULL) {
1132       free(e->command);
1133       e->command = NULL;
1134     }
1135     e++;
1136   }
1137   e = icsTextMenuEntry;
1138   while (*p && e < icsTextMenuEntry + ICS_TEXT_MENU_SIZE) {
1139     if (*p == ';' || *p == '\n') {
1140       e->item = strdup("-");
1141       e->command = NULL;
1142       p++;
1143     } else if (*p == '-') {
1144       e->item = strdup("-");
1145       e->command = NULL;
1146       p++;
1147       if (*p) p++;
1148     } else {
1149       char *q, *r, *s, *t;
1150       char c;
1151       q = strchr(p, ',');
1152       if (q == NULL) break;
1153       *q = NULLCHAR;
1154       r = strchr(q + 1, ',');
1155       if (r == NULL) break;
1156       *r = NULLCHAR;
1157       s = strchr(r + 1, ',');
1158       if (s == NULL) break;
1159       *s = NULLCHAR;
1160       c = ';';
1161       t = strchr(s + 1, c);
1162       if (t == NULL) {
1163         c = '\n';
1164         t = strchr(s + 1, c);
1165       }
1166       if (t != NULL) *t = NULLCHAR;
1167       e->item = strdup(p);
1168       e->command = strdup(q + 1);
1169       e->getname = *(r + 1) != '0';
1170       e->immediate = *(s + 1) != '0';
1171       *q = ',';
1172       *r = ',';
1173       *s = ',';
1174       if (t == NULL) break;
1175       *t = c;
1176       p = t + 1;
1177     }
1178     e++;
1179   }
1180 }
1181
1182 void
1183 SetDefaultTextAttribs()
1184 {
1185   ColorClass cc;
1186   for (cc = (ColorClass)0; cc < ColorNone; cc++) {
1187     ParseTextAttribs(cc, defaultTextAttribs[cc]);
1188   }
1189 }
1190
1191 void
1192 SetDefaultsFromList()
1193 { // [HGM] ini: take defaults from argDescriptor list
1194   int i;
1195
1196   for(i=0; argDescriptors[i].argName != NULL; i++) {
1197     if(argDescriptors[i].defaultValue != INVALID)
1198       switch(argDescriptors[i].argType) {
1199         case ArgBoolean:
1200         case ArgTwo:
1201         case ArgTrue:
1202         case ArgFalse:
1203           *(Boolean *) argDescriptors[i].argLoc = (int)(intptr_t)argDescriptors[i].defaultValue;
1204           break;
1205         case ArgInt:
1206         case ArgX:
1207         case ArgY:
1208         case ArgZ:
1209           *(int *) argDescriptors[i].argLoc = (int)(intptr_t)argDescriptors[i].defaultValue;
1210           break;
1211         case ArgString:
1212         case ArgFilename:
1213         case ArgSettingsFilename:
1214           if((char *)argDescriptors[i].defaultValue)
1215           *(char **) argDescriptors[i].argLoc = strdup((char *)argDescriptors[i].defaultValue);
1216           break;
1217         case ArgBoardSize:
1218           *(int *) argDescriptors[i].argLoc = (int)(intptr_t)argDescriptors[i].defaultValue;
1219           break;
1220         case ArgColor:
1221           ParseColor((int)(intptr_t)argDescriptors[i].argLoc, (char*)argDescriptors[i].defaultValue);
1222           break;
1223         case ArgFloat: // floats cannot be casted to int without precision loss
1224         default: ; // some arg types cannot be initialized through table
1225     }
1226   }
1227 }
1228
1229 void
1230 InitAppData(char *lpCmdLine)
1231 {
1232   int i;
1233   char buf[MAX_ARG_LEN], currDir[MSG_SIZ];
1234   char *p;
1235
1236   /* Initialize to defaults */
1237   SetDefaultsFromList(); // this sets most defaults
1238
1239   // some parameters for which there are no options!
1240   appData.Iconic = FALSE; /*unused*/
1241   appData.icsEngineAnalyze = FALSE;
1242
1243   // float: casting to int is not harmless, so default cannot be contained in table
1244   appData.timeDelay = TIME_DELAY;
1245   appData.timeIncrement = TIME_INCREMENT;
1246
1247   // some complex, platform-dependent stuff that could not be handled from table
1248   SetDefaultTextAttribs();
1249   SetFontDefaults();
1250   SetCommPortDefaults();
1251
1252   /* Parse default settings file if any */
1253   ParseSettingsFile(settingsFileName, &settingsFileName);
1254
1255   /* Parse command line */
1256   ParseArgs(StringGet, &lpCmdLine);
1257
1258   if(appData.viewer && appData.viewerOptions[0]) ParseArgsFromString(appData.viewerOptions);
1259
1260   /* [HGM] make sure board size is acceptable */
1261   if(appData.NrFiles > BOARD_FILES ||
1262      appData.NrRanks > BOARD_RANKS   )
1263       DisplayFatalError("Recompile with BOARD_RANKS or BOARD_FILES, to support this size", 0, 2);
1264
1265   /* [HGM] After parsing the options from the .ini file, and overruling them
1266    * with options from the command line, we now make an even higher priority
1267    * overrule by WB options attached to the engine command line. This so that
1268    * tournament managers can use WB options (such as /timeOdds) that follow
1269    * the engines.
1270    */
1271   if(appData.firstChessProgram != NULL) {
1272       char *p = StrStr(appData.firstChessProgram, "WBopt");
1273       static char *f = "first";
1274       char buf[MSG_SIZ], *q = buf;
1275       int len;
1276
1277       if(p != NULL)
1278         { // engine command line contains WinBoard options
1279           len = snprintf(buf, MSG_SIZ, p+6, f, f, f, f, f, f, f, f, f, f); // replace %s in them by "first"
1280           if( (len >= MSG_SIZ) && appData.debugMode )
1281             fprintf(debugFP, "InitAppData: buffer truncated.\n");
1282
1283           ParseArgs(StringGet, &q);
1284           p[-1] = 0; // cut them offengine command line
1285         }
1286   }
1287   // now do same for second chess program
1288   if(appData.secondChessProgram != NULL) {
1289       char *p = StrStr(appData.secondChessProgram, "WBopt");
1290       static char *s = "second";
1291       char buf[MSG_SIZ], *q = buf;
1292       int len;
1293
1294       if(p != NULL)
1295         { // engine command line contains WinBoard options
1296           len = snprintf(buf,MSG_SIZ, p+6, s, s, s, s, s, s, s, s, s, s); // replace %s in them by "first"
1297           if( (len >= MSG_SIZ) && appData.debugMode )
1298             fprintf(debugFP, "InitAppData: buffer truncated.\n");
1299
1300           ParseArgs(StringGet, &q);
1301           p[-1] = 0; // cut them offengine command line
1302         }
1303   }
1304
1305   /* Propagate options that affect others */
1306   if (appData.matchMode || appData.matchGames) chessProgram = TRUE;
1307   if (appData.icsActive || appData.noChessProgram) {
1308      chessProgram = FALSE;  /* not local chess program mode */
1309   }
1310
1311   /* Open startup dialog if needed */
1312   if ((!appData.noChessProgram && !chessProgram && !appData.icsActive) ||
1313       (appData.icsActive && *appData.icsHost == NULLCHAR) ||
1314       (chessProgram && (*appData.firstChessProgram == NULLCHAR ||
1315                         *appData.secondChessProgram == NULLCHAR)))
1316                 PopUpStartupDialog();
1317
1318   /* Make sure save files land in the right (?) directory */
1319   if (MyGetFullPathName(appData.saveGameFile, buf)) {
1320     appData.saveGameFile = strdup(buf);
1321   }
1322   if (MyGetFullPathName(appData.savePositionFile, buf)) {
1323     appData.savePositionFile = strdup(buf);
1324   }
1325
1326   /* Finish initialization for fonts and sounds */
1327   CreateFonts();
1328
1329   GetCurrentDirectory(MSG_SIZ, currDir);
1330   SetCurrentDirectory(installDir);
1331   LoadAllSounds();
1332   SetCurrentDirectory(currDir);
1333
1334   p = icsTextMenuString;
1335   if (p[0] == '@') {
1336     FILE* f = fopen(p + 1, "r");
1337     if (f == NULL) {
1338       DisplayFatalError(p + 1, errno, 2);
1339       return;
1340     }
1341     i = fread(buf, 1, sizeof(buf)-1, f);
1342     fclose(f);
1343     buf[i] = NULLCHAR;
1344     p = buf;
1345   }
1346   ParseIcsTextMenu(strdup(p));
1347 }
1348
1349 void
1350 SaveSettings(char* name)
1351 {
1352   FILE *f;
1353   ArgDescriptor *ad;
1354   char dir[MSG_SIZ], buf[MSG_SIZ];
1355
1356   if (!MainWindowUp()) return;
1357
1358   GetCurrentDirectory(MSG_SIZ, dir);
1359   if(MySearchPath(installDir, name, buf)) {
1360     f = fopen(buf, "w");
1361   } else {
1362     SetCurrentDirectory(installDir);
1363     f = fopen(name, "w");
1364     SetCurrentDirectory(dir);
1365   }
1366   if (f == NULL) {
1367     DisplayError(name, errno);
1368     return;
1369   }
1370
1371   fprintf(f, ";\n");
1372   fprintf(f, "; %s Save Settings file\n", PACKAGE_STRING);
1373   fprintf(f, ";\n");
1374   fprintf(f, "; You can edit the values of options that are already set in this file,\n");
1375   fprintf(f, "; but if you add other options, the next Save Settings will not save them.\n");
1376   fprintf(f, "; Use a shortcut, an @indirection file, or a .bat file instead.\n");
1377   fprintf(f, ";\n");
1378
1379   GetWindowCoords();
1380
1381   /* [AS] Move history */
1382   wpMoveHistory.visible = MoveHistoryIsUp();
1383
1384   /* [AS] Eval graph */
1385   wpEvalGraph.visible = EvalGraphIsUp();
1386
1387   /* [AS] Engine output */
1388   wpEngineOutput.visible = EngineOutputIsUp();
1389
1390   // [HGM] in WB we have to copy sound names to appData first
1391   ExportSounds();
1392
1393   for (ad = argDescriptors; ad->argName != NULL; ad++) {
1394     if (!ad->save) continue;
1395     switch (ad->argType) {
1396     case ArgString:
1397       {
1398         char *p = *(char **)ad->argLoc;
1399         if(p == NULL) break; // just in case
1400         if ((strchr(p, '\\') || strchr(p, '\n')) && !strchr(p, '}')) {
1401           /* Quote multiline values or \-containing values
1402              with { } if possible */
1403           fprintf(f, OPTCHAR "%s" SEPCHAR "{%s}\n", ad->argName, p);
1404         } else {
1405           /* Else quote with " " */
1406           fprintf(f, OPTCHAR "%s" SEPCHAR "\"", ad->argName);
1407           while (*p) {
1408             if (*p == '\n') fprintf(f, "\n");
1409             else if (*p == '\r') fprintf(f, "\\r");
1410             else if (*p == '\t') fprintf(f, "\\t");
1411             else if (*p == '\b') fprintf(f, "\\b");
1412             else if (*p == '\f') fprintf(f, "\\f");
1413             else if (*p < ' ') fprintf(f, "\\%03o", *p);
1414             else if (*p == '\"') fprintf(f, "\\\"");
1415             else if (*p == '\\') fprintf(f, "\\\\");
1416             else putc(*p, f);
1417             p++;
1418           }
1419           fprintf(f, "\"\n");
1420         }
1421       }
1422       break;
1423     case ArgInt:
1424     case ArgZ:
1425       fprintf(f, OPTCHAR "%s" SEPCHAR "%d\n", ad->argName, *(int *)ad->argLoc);
1426       break;
1427     case ArgX:
1428       fprintf(f, OPTCHAR "%s" SEPCHAR "%d\n", ad->argName, *(int *)ad->argLoc - wpMain.x); // [HGM] placement: store relative value
1429       break;
1430     case ArgY:
1431       fprintf(f, OPTCHAR "%s" SEPCHAR "%d\n", ad->argName, *(int *)ad->argLoc - wpMain.y);
1432       break;
1433     case ArgFloat:
1434       fprintf(f, OPTCHAR "%s" SEPCHAR "%g\n", ad->argName, *(float *)ad->argLoc);
1435       break;
1436     case ArgBoolean:
1437       fprintf(f, OPTCHAR "%s" SEPCHAR "%s\n", ad->argName,
1438         (*(Boolean *)ad->argLoc) ? "true" : "false");
1439       break;
1440     case ArgTrue:
1441       if (*(Boolean *)ad->argLoc) fprintf(f, OPTCHAR "%s\n", ad->argName);
1442       break;
1443     case ArgFalse:
1444       if (!*(Boolean *)ad->argLoc) fprintf(f, OPTCHAR "%s\n", ad->argName);
1445       break;
1446     case ArgColor:
1447       SaveColor(f, ad);
1448       break;
1449     case ArgAttribs:
1450       SaveAttribsArg(f, ad);
1451       break;
1452     case ArgFilename:
1453       if(*(char**)ad->argLoc == NULL) break; // just in case
1454       if (strchr(*(char **)ad->argLoc, '\"')) {
1455         fprintf(f, OPTCHAR "%s" SEPCHAR "'%s'\n", ad->argName, *(char **)ad->argLoc);
1456       } else {
1457         fprintf(f, OPTCHAR "%s" SEPCHAR "\"%s\"\n", ad->argName, *(char **)ad->argLoc);
1458       }
1459       break;
1460     case ArgBoardSize:
1461       SaveBoardSize(f, ad->argName, ad->argLoc);
1462       break;
1463     case ArgFont:
1464       SaveFontArg(f, ad);
1465       break;
1466     case ArgCommSettings:
1467       PrintCommPortSettings(f, ad->argName);
1468     case ArgTwo:
1469     case ArgNone:
1470     case ArgSettingsFilename: ;
1471     }
1472   }
1473   fclose(f);
1474 }
1475
1476 Boolean
1477 GetArgValue(char *name)
1478 { // retrieve (as text) current value of string or int argument given by name
1479   // (this is used for maing the values available in the adapter command)
1480   ArgDescriptor *ad;
1481   int len;
1482
1483   for (ad = argDescriptors; ad->argName != NULL; ad++)
1484     if (strcmp(ad->argName, name) == 0) break;
1485
1486   if (ad->argName == NULL) return FALSE;
1487
1488   switch(ad->argType) {
1489     case ArgString:
1490     case ArgFilename:
1491       strncpy(name, *(char**) ad->argLoc, MSG_SIZ);
1492
1493       return TRUE;
1494     case ArgInt:
1495       len = snprintf(name, MSG_SIZ, "%d", *(int*) ad->argLoc);
1496       if( (len >= MSG_SIZ) && appData.debugMode )
1497         fprintf(debugFP, "GetArgValue: buffer truncated.\n");
1498
1499       return TRUE;
1500     case ArgBoolean:
1501       len = snprintf(name, MSG_SIZ, "%s", *(Boolean*) ad->argLoc ? "true" : "false");
1502       if( (len >= MSG_SIZ) && appData.debugMode )
1503         fprintf(debugFP, "GetArgValue: buffer truncated.\n");
1504
1505       return TRUE;
1506     default: ;
1507   }
1508
1509   return FALSE;
1510 }