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 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,
  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;\r
 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, INVALID },
 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, !XBOARD, INVALID },
 320   { "font", ArgFont, (void *) MESSAGE_FONT, XBOARD, INVALID },
 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   { "boardSize", ArgBoardSize, (void *) &boardSize,
 327     TRUE, (ArgIniType) -1 }, /* must come after all fonts */
 328   { "size", ArgBoardSize, (void *) &boardSize, FALSE, INVALID },
 329   { "ringBellAfterMoves", ArgBoolean, (void *) &appData.ringBellAfterMoves,
 330     FALSE, (ArgIniType) TRUE }, /* historical; kept only so old winboard.ini files will parse */
 331   { "bell", ArgTrue, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
 332   { "xbell", ArgFalse, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
 333   { "movesound", ArgTrue, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
 334   { "xmovesound", ArgFalse, (void *) &appData.ringBellAfterMoves, FALSE, INVALID }, // for XB
 335   { "alwaysOnTop", ArgBoolean, (void *) &alwaysOnTop, TRUE, INVALID },
 336   { "top", ArgTrue, (void *) &alwaysOnTop, FALSE, INVALID },
 337   { "xtop", ArgFalse, (void *) &alwaysOnTop, FALSE, INVALID },
 338   { "-top", ArgFalse, (void *) &alwaysOnTop, FALSE, INVALID },
 339   { "autoCallFlag", ArgBoolean, (void *) &appData.autoCallFlag, TRUE, (ArgIniType) FALSE },
 340   { "autoflag", ArgTrue, (void *) &appData.autoCallFlag, FALSE, INVALID },
 341   { "xautoflag", ArgFalse, (void *) &appData.autoCallFlag, FALSE, INVALID },
 342   { "-autoflag", ArgFalse, (void *) &appData.autoCallFlag, FALSE, INVALID },
 343   { "autoComment", ArgBoolean, (void *) &appData.autoComment, TRUE, (ArgIniType) FALSE },
 344   { "autocomm", ArgTrue, (void *) &appData.autoComment, FALSE, INVALID },
 345   { "xautocomm", ArgFalse, (void *) &appData.autoComment, FALSE, INVALID },
 346   { "-autocomm", ArgFalse, (void *) &appData.autoComment, FALSE, INVALID },
 347   { "autoObserve", ArgBoolean, (void *) &appData.autoObserve, TRUE, (ArgIniType) FALSE },
 348   { "autobs", ArgTrue, (void *) &appData.autoObserve, FALSE, INVALID },
 349   { "xautobs", ArgFalse, (void *) &appData.autoObserve, FALSE, INVALID },
 350   { "-autobs", ArgFalse, (void *) &appData.autoObserve, FALSE, INVALID },
 351   { "flipView", ArgBoolean, (void *) &appData.flipView, FALSE, (ArgIniType) FALSE },
 352   { "flip", ArgTrue, (void *) &appData.flipView, FALSE, INVALID },
 353   { "xflip", ArgFalse, (void *) &appData.flipView, FALSE, INVALID },
 354   { "-flip", ArgFalse, (void *) &appData.flipView, FALSE, INVALID },
 355   { "autoFlipView", ArgBoolean, (void *) &appData.autoFlipView, TRUE, (ArgIniType) TRUE },
 356   { "autoflip", ArgTrue, (void *) &appData.autoFlipView, FALSE, INVALID },
 357   { "xautoflip", ArgFalse, (void *) &appData.autoFlipView, FALSE, INVALID },
 358   { "-autoflip", ArgFalse, (void *) &appData.autoFlipView, FALSE, INVALID },
 359   { "autoRaiseBoard", ArgBoolean, (void *) &appData.autoRaiseBoard, TRUE, (ArgIniType) TRUE },
 360   { "autoraise", ArgTrue, (void *) &appData.autoRaiseBoard, FALSE, INVALID },
 361   { "xautoraise", ArgFalse, (void *) &appData.autoRaiseBoard, FALSE, INVALID },
 362   { "-autoraise", ArgFalse, (void *) &appData.autoRaiseBoard, FALSE, INVALID },
 363   { "alwaysPromoteToQueen", ArgBoolean, (void *) &appData.alwaysPromoteToQueen, TRUE, (ArgIniType) FALSE },
 364   { "queen", ArgTrue, (void *) &appData.alwaysPromoteToQueen, FALSE, INVALID },
 365   { "xqueen", ArgFalse, (void *) &appData.alwaysPromoteToQueen, FALSE, INVALID },
 366   { "-queen", ArgFalse, (void *) &appData.alwaysPromoteToQueen, FALSE, INVALID },
 367   { "oldSaveStyle", ArgBoolean, (void *) &appData.oldSaveStyle, TRUE, (ArgIniType) FALSE },
 368   { "oldsave", ArgTrue, (void *) &appData.oldSaveStyle, FALSE, INVALID },
 369   { "xoldsave", ArgFalse, (void *) &appData.oldSaveStyle, FALSE, INVALID },
 370   { "-oldsave", ArgFalse, (void *) &appData.oldSaveStyle, FALSE, INVALID },
 371   { "quietPlay", ArgBoolean, (void *) &appData.quietPlay, TRUE, (ArgIniType) FALSE },
 372   { "quiet", ArgTrue, (void *) &appData.quietPlay, FALSE, INVALID },
 373   { "xquiet", ArgFalse, (void *) &appData.quietPlay, FALSE, INVALID },
 374   { "-quiet", ArgFalse, (void *) &appData.quietPlay, FALSE, INVALID },
 375   { "getMoveList", ArgBoolean, (void *) &appData.getMoveList, TRUE, (ArgIniType) TRUE },
 376   { "moves", ArgTrue, (void *) &appData.getMoveList, FALSE, INVALID },
 377   { "xmoves", ArgFalse, (void *) &appData.getMoveList, FALSE, INVALID },
 378   { "-moves", ArgFalse, (void *) &appData.getMoveList, FALSE, INVALID },
 379   { "testLegality", ArgBoolean, (void *) &appData.testLegality, TRUE, (ArgIniType) TRUE },
 380   { "legal", ArgTrue, (void *) &appData.testLegality, FALSE, INVALID },
 381   { "xlegal", ArgFalse, (void *) &appData.testLegality, FALSE, INVALID },
 382   { "-legal", ArgFalse, (void *) &appData.testLegality, FALSE, INVALID },
 383   { "premove", ArgBoolean, (void *) &appData.premove, TRUE, (ArgIniType) TRUE },
 384   { "pre", ArgTrue, (void *) &appData.premove, FALSE, INVALID },
 385   { "xpre", ArgFalse, (void *) &appData.premove, FALSE, INVALID },
 386   { "-pre", ArgFalse, (void *) &appData.premove, FALSE, INVALID },
 387   { "premoveWhite", ArgBoolean, (void *) &appData.premoveWhite, TRUE, (ArgIniType) FALSE },
 388   { "prewhite", ArgTrue, (void *) &appData.premoveWhite, FALSE, INVALID },
 389   { "xprewhite", ArgFalse, (void *) &appData.premoveWhite, FALSE, INVALID },
 390   { "-prewhite", ArgFalse, (void *) &appData.premoveWhite, FALSE, INVALID },
 391   { "premoveWhiteText", ArgString, (void *) &appData.premoveWhiteText, TRUE, (ArgIniType) "" },
 392   { "premoveBlack", ArgBoolean, (void *) &appData.premoveBlack, TRUE, (ArgIniType) FALSE },
 393   { "preblack", ArgTrue, (void *) &appData.premoveBlack, FALSE, INVALID },
 394   { "xpreblack", ArgFalse, (void *) &appData.premoveBlack, FALSE, INVALID },
 395   { "-preblack", ArgFalse, (void *) &appData.premoveBlack, FALSE, INVALID },
 396   { "premoveBlackText", ArgString, (void *) &appData.premoveBlackText, TRUE, (ArgIniType) "" },
 397   { "icsAlarm", ArgBoolean, (void *) &appData.icsAlarm, TRUE, (ArgIniType) TRUE},
 398   { "alarm", ArgTrue, (void *) &appData.icsAlarm, FALSE},
 399   { "xalarm", ArgFalse, (void *) &appData.icsAlarm, FALSE},
 400   { "-alarm", ArgFalse, (void *) &appData.icsAlarm, FALSE},
 401   { "icsAlarmTime", ArgInt, (void *) &appData.icsAlarmTime, TRUE, (ArgIniType) 5000},
 402   { "localLineEditing", ArgBoolean, (void *) &appData.localLineEditing, FALSE, (ArgIniType) TRUE},
 403   { "edit", ArgTrue, (void *) &appData.localLineEditing, FALSE, INVALID },
 404   { "xedit", ArgFalse, (void *) &appData.localLineEditing, FALSE, INVALID },
 405   { "-edit", ArgFalse, (void *) &appData.localLineEditing, FALSE, INVALID },
 406   { "animateMoving", ArgBoolean, (void *) &appData.animate, TRUE, (ArgIniType) TRUE },
 407   { "animate", ArgTrue, (void *) &appData.animate, FALSE, INVALID },
 408   { "xanimate", ArgFalse, (void *) &appData.animate, FALSE, INVALID },
 409   { "-animate", ArgFalse, (void *) &appData.animate, FALSE, INVALID },
 410   { "animateSpeed", ArgInt, (void *) &appData.animSpeed, TRUE, (ArgIniType) 10 },
 411   { "animateDragging", ArgBoolean, (void *) &appData.animateDragging, TRUE, (ArgIniType) TRUE },
 412   { "drag", ArgTrue, (void *) &appData.animateDragging, FALSE, INVALID },
 413   { "xdrag", ArgFalse, (void *) &appData.animateDragging, FALSE, INVALID },
 414   { "-drag", ArgFalse, (void *) &appData.animateDragging, FALSE, INVALID },
 415   { "blindfold", ArgBoolean, (void *) &appData.blindfold, TRUE, (ArgIniType) FALSE },
 416   { "blind", ArgTrue, (void *) &appData.blindfold, FALSE, INVALID },
 417   { "xblind", ArgFalse, (void *) &appData.blindfold, FALSE, INVALID },
 418   { "-blind", ArgFalse, (void *) &appData.blindfold, FALSE, INVALID },
 419   { "highlightLastMove", ArgBoolean,
 420     (void *) &appData.highlightLastMove, TRUE, (ArgIniType) TRUE },
 421   { "highlight", ArgTrue, (void *) &appData.highlightLastMove, FALSE, INVALID },
 422   { "xhighlight", ArgFalse, (void *) &appData.highlightLastMove, FALSE, INVALID },
 423   { "-highlight", ArgFalse, (void *) &appData.highlightLastMove, FALSE, INVALID },
 424   { "highlightDragging", ArgBoolean,
 425     (void *) &appData.highlightDragging, TRUE, INVALID },
 426   { "highdrag", ArgTrue, (void *) &appData.highlightDragging, FALSE, INVALID },
 427   { "xhighdrag", ArgFalse, (void *) &appData.highlightDragging, FALSE, INVALID },
 428   { "-highdrag", ArgFalse, (void *) &appData.highlightDragging, FALSE, INVALID },
 429   { "colorizeMessages", ArgBoolean, (void *) &appData.colorize, TRUE, (ArgIniType) TRUE },
 430   { "colorize", ArgTrue, (void *) &appData.colorize, FALSE, INVALID },
 431   { "xcolorize", ArgFalse, (void *) &appData.colorize, FALSE, INVALID },
 432   { "-colorize", ArgFalse, (void *) &appData.colorize, FALSE, INVALID },
 433   { "colorShout", ArgAttribs, (void *) ColorShout, TRUE, INVALID },
 434   { "colorSShout", ArgAttribs, (void *) ColorSShout, TRUE, INVALID },
 435   { "colorCShout", ArgAttribs, (void *) ColorSShout, FALSE, INVALID }, // for XB
 436   { "colorChannel1", ArgAttribs, (void *) ColorChannel1, TRUE, INVALID },
 437   { "colorChannel", ArgAttribs, (void *) ColorChannel, TRUE, INVALID },
 438   { "colorKibitz", ArgAttribs, (void *) ColorKibitz, TRUE, INVALID },
 439   { "colorTell", ArgAttribs, (void *) ColorTell, TRUE, INVALID },
 440   { "colorChallenge", ArgAttribs, (void *) ColorChallenge, TRUE, INVALID },
 441   { "colorRequest", ArgAttribs, (void *) ColorRequest, TRUE, INVALID },
 442   { "colorSeek", ArgAttribs, (void *) ColorSeek, TRUE, INVALID },
 443   { "colorNormal", ArgAttribs, (void *) ColorNormal, TRUE, INVALID },
 444   { "colorBackground", ArgColor, (void *) 7, TRUE, COLOR_BKGD },
 445   { "soundShout", ArgFilename, (void *) &appData.soundShout, TRUE, (ArgIniType) "" },
 446   { "soundSShout", ArgFilename, (void *) &appData.soundSShout, TRUE, (ArgIniType) "" },
 447   { "soundCShout", ArgFilename, (void *) &appData.soundSShout, FALSE, (ArgIniType) "" }, // for XB
 448   { "soundChannel1", ArgFilename, (void *) &appData.soundChannel1, TRUE, (ArgIniType) "" },
 449   { "soundChannel", ArgFilename, (void *) &appData.soundChannel, TRUE, (ArgIniType) "" },
 450   { "soundKibitz", ArgFilename, (void *) &appData.soundKibitz, TRUE, (ArgIniType) "" },
 451   { "soundTell", ArgFilename, (void *) &appData.soundTell, TRUE, (ArgIniType) "" },
 452   { "soundChallenge", ArgFilename, (void *) &appData.soundChallenge, TRUE, (ArgIniType) "" },
 453   { "soundRequest", ArgFilename, (void *) &appData.soundRequest, TRUE, (ArgIniType) "" },
 454   { "soundSeek", ArgFilename, (void *) &appData.soundSeek, TRUE, (ArgIniType) "" },
 455   { "soundMove", ArgFilename, (void *) &appData.soundMove, TRUE, (ArgIniType) "" },
 456   { "soundBell", ArgFilename, (void *) &appData.soundBell, TRUE, (ArgIniType) SOUND_BELL },
 457   { "soundIcsWin", ArgFilename, (void *) &appData.soundIcsWin, TRUE, (ArgIniType) "" },
 458   { "soundIcsLoss", ArgFilename, (void *) &appData.soundIcsLoss, TRUE, (ArgIniType) "" },
 459   { "soundIcsDraw", ArgFilename, (void *) &appData.soundIcsDraw, TRUE, (ArgIniType) "" },
 460   { "soundIcsUnfinished", ArgFilename, (void *) &appData.soundIcsUnfinished, TRUE, (ArgIniType) "" },
 461   { "soundIcsAlarm", ArgFilename, (void *) &appData.soundIcsAlarm, TRUE, (ArgIniType) "" },
 462   { "disguisePromotedPieces", ArgBoolean, (void *) &appData.disguise, TRUE, (ArgIniType) TRUE },
 463   { "reuseFirst", ArgBoolean, (void *) &appData.reuseFirst, FALSE, (ArgIniType) TRUE },
 464   { "reuse", ArgTrue, (void *) &appData.reuseFirst, FALSE, INVALID },
 465   { "xreuse", ArgFalse, (void *) &appData.reuseFirst, FALSE, INVALID },
 466   { "-reuse", ArgFalse, (void *) &appData.reuseFirst, FALSE, INVALID },
 467   { "reuseChessPrograms", ArgBoolean,
 468     (void *) &appData.reuseFirst, FALSE, INVALID }, /* backward compat only */
 469   { "reuseSecond", ArgBoolean, (void *) &appData.reuseSecond, FALSE, (ArgIniType) TRUE },
 470   { "reuse2", ArgTrue, (void *) &appData.reuseSecond, FALSE, INVALID },
 471   { "xreuse2", ArgFalse, (void *) &appData.reuseSecond, FALSE, INVALID },
 472   { "-reuse2", ArgFalse, (void *) &appData.reuseSecond, FALSE, INVALID },
 473   { "comPortSettings", ArgCommSettings, (void *) /*&dcb*/ 0, TRUE, INVALID },
 474   { "settingsFile", ArgSettingsFilename, (void *) &settingsFileName, FALSE, (ArgIniType) SETTINGS_FILE },
 475   { "ini", ArgSettingsFilename, (void *) &settingsFileName, FALSE, INVALID },
 476   { "saveSettingsFile", ArgFilename, (void *) &settingsFileName, FALSE, INVALID },
 477   { "saveSettingsOnExit", ArgBoolean, (void *) &saveSettingsOnExit, TRUE, (ArgIniType) TRUE },
 478   { "chessProgram", ArgBoolean, (void *) &chessProgram, FALSE, (ArgIniType) FALSE },
 479   { "cp", ArgTrue, (void *) &chessProgram, FALSE, INVALID },
 480   { "xcp", ArgFalse, (void *) &chessProgram, FALSE, INVALID },
 481   { "-cp", ArgFalse, (void *) &chessProgram, FALSE, INVALID },
 482   { "icsMenu", ArgString, (void *) &icsTextMenuString, TRUE, (ArgIniType) ICS_TEXT_MENU_DEFAULT },
 483   { "icsNames", ArgString, (void *) &icsNames, TRUE, (ArgIniType) ICS_NAMES },
 484   { "singleEngineList", ArgBoolean, (void *) &singleList, !XBOARD, (ArgIniType) FALSE },
 485   { "firstChessProgramNames", ArgString, (void *) &firstChessProgramNames,
 486     TRUE, (ArgIniType) FCP_NAMES },
 487   { "secondChessProgramNames", ArgString, (void *) &secondChessProgramNames,
 488     !XBOARD, (ArgIniType) SCP_NAMES },
 489   { "initialMode", ArgString, (void *) &appData.initialMode, FALSE, (ArgIniType) "" },
 490   { "mode", ArgString, (void *) &appData.initialMode, FALSE, INVALID },
 491   { "variant", ArgString, (void *) &appData.variant, FALSE, (ArgIniType) "normal" },
 492   { "firstProtocolVersion", ArgInt, (void *) &appData.firstProtocolVersion, FALSE, (ArgIniType) PROTOVER },
 493   { "secondProtocolVersion", ArgInt, (void *) &appData.secondProtocolVersion,FALSE, (ArgIniType) PROTOVER },
 494   { "showButtonBar", ArgBoolean, (void *) &appData.showButtonBar, TRUE, (ArgIniType) TRUE },
 495   { "buttons", ArgTrue, (void *) &appData.showButtonBar, FALSE, INVALID },
 496   { "xbuttons", ArgFalse, (void *) &appData.showButtonBar, FALSE, INVALID },
 497   { "-buttons", ArgFalse, (void *) &appData.showButtonBar, FALSE, INVALID },
 498
 499   /* [AS] New features */
 500   { "firstScoreAbs", ArgBoolean, (void *) &appData.firstScoreIsAbsolute, FALSE, (ArgIniType) FALSE },
 501   { "secondScoreAbs", ArgBoolean, (void *) &appData.secondScoreIsAbsolute, FALSE, (ArgIniType) FALSE },
 502   { "pgnExtendedInfo", ArgBoolean, (void *) &appData.saveExtendedInfoInPGN, TRUE, (ArgIniType) FALSE },
 503   { "hideThinkingFromHuman", ArgBoolean, (void *) &appData.hideThinkingFromHuman, TRUE, (ArgIniType) FALSE },
 504   { "liteBackTextureFile", ArgString, (void *) &appData.liteBackTextureFile, TRUE, (ArgIniType) "" },
 505   { "darkBackTextureFile", ArgString, (void *) &appData.darkBackTextureFile, TRUE, (ArgIniType) "" },
 506   { "liteBackTextureMode", ArgInt, (void *) &appData.liteBackTextureMode, TRUE, (ArgIniType) BACK_TEXTURE_MODE_PLAIN },
 507   { "darkBackTextureMode", ArgInt, (void *) &appData.darkBackTextureMode, TRUE, (ArgIniType) BACK_TEXTURE_MODE_PLAIN },
 508   { "renderPiecesWithFont", ArgString, (void *) &appData.renderPiecesWithFont, TRUE, (ArgIniType) "" },
 509   { "fontPieceToCharTable", ArgString, (void *) &appData.fontToPieceTable, TRUE, (ArgIniType) "" },
 510   { "fontPieceBackColorWhite", ArgColor, (void *) 8, TRUE, (ArgIniType) WHITE_PIECE_COLOR },
 511   { "fontPieceForeColorWhite", ArgColor, (void *) 9, TRUE, (ArgIniType) WHITE_PIECE_COLOR },
 512   { "fontPieceBackColorBlack", ArgColor, (void *) 10, TRUE, (ArgIniType) BLACK_PIECE_COLOR },
 513   { "fontPieceForeColorBlack", ArgColor, (void *) 11, TRUE, (ArgIniType) BLACK_PIECE_COLOR },
 514   { "fontPieceSize", ArgInt, (void *) &appData.fontPieceSize, TRUE, (ArgIniType) 80 },
 515   { "overrideLineGap", ArgInt, (void *) &appData.overrideLineGap, TRUE, (ArgIniType) 1 },
 516   { "adjudicateLossThreshold", ArgInt, (void *) &appData.adjudicateLossThreshold, TRUE, (ArgIniType) 0 },
 517   { "delayBeforeQuit", ArgInt, (void *) &appData.delayBeforeQuit, TRUE, (ArgIniType) 0 },
 518   { "delayAfterQuit", ArgInt, (void *) &appData.delayAfterQuit, TRUE, (ArgIniType) 0 },
 519   { "nameOfDebugFile", ArgFilename, (void *) &appData.nameOfDebugFile, FALSE, (ArgIniType) DEBUG_FILE },
 520   { "debugfile", ArgFilename, (void *) &appData.nameOfDebugFile, FALSE, INVALID },
 521   { "pgnEventHeader", ArgString, (void *) &appData.pgnEventHeader, TRUE, (ArgIniType) "Computer Chess Game" },
 522   { "defaultFrcPosition", ArgInt, (void *) &appData.defaultFrcPosition, TRUE, (ArgIniType) -1 },
 523   { "shuffleOpenings", ArgTrue, (void *) &shuffleOpenings, FALSE, INVALID },
 524   { "gameListTags", ArgString, (void *) &appData.gameListTags, TRUE, (ArgIniType) GLT_DEFAULT_TAGS },
 525   { "saveOutOfBookInfo", ArgBoolean, (void *) &appData.saveOutOfBookInfo, TRUE, (ArgIniType) TRUE },
 526   { "showEvalInMoveHistory", ArgBoolean, (void *) &appData.showEvalInMoveHistory, TRUE, (ArgIniType) TRUE },
 527   { "evalHistColorWhite", ArgColor, (void *) 12, TRUE, (ArgIniType) "#FFFFB0" },
 528   { "evalHistColorBlack", ArgColor, (void *) 13, TRUE, (ArgIniType) "#AD5D3D" },
 529   { "highlightMoveWithArrow", ArgBoolean, (void *) &appData.highlightMoveWithArrow, TRUE, (ArgIniType) FALSE },
 530   { "highlightArrowColor", ArgColor, (void *) 14, TRUE, (ArgIniType) "#FFFF80" },
 531   { "stickyWindows", ArgBoolean, (void *) &appData.useStickyWindows, TRUE, (ArgIniType) TRUE },
 532   { "adjudicateDrawMoves", ArgInt, (void *) &appData.adjudicateDrawMoves, TRUE, (ArgIniType) 0 },
 533   { "autoDisplayComment", ArgBoolean, (void *) &appData.autoDisplayComment, TRUE, (ArgIniType) TRUE },
 534   { "autoDisplayTags", ArgBoolean, (void *) &appData.autoDisplayTags, TRUE, (ArgIniType) TRUE },
 535   { "firstIsUCI", ArgBoolean, (void *) &appData.firstIsUCI, FALSE, (ArgIniType) FALSE },
 536   { "fUCI", ArgTrue, (void *) &appData.firstIsUCI, FALSE, INVALID },
 537   { "firstUCI", ArgTrue, (void *) &appData.firstIsUCI, FALSE, INVALID },
 538   { "secondIsUCI", ArgBoolean, (void *) &appData.secondIsUCI, FALSE, (ArgIniType) FALSE },
 539   { "sUCI", ArgTrue, (void *) &appData.secondIsUCI, FALSE, INVALID },
 540   { "secondUCI", ArgTrue, (void *) &appData.secondIsUCI, FALSE, INVALID },
 541   { "firstHasOwnBookUCI", ArgBoolean, (void *) &appData.firstHasOwnBookUCI, FALSE, (ArgIniType) TRUE },
 542   { "fNoOwnBookUCI", ArgFalse, (void *) &appData.firstHasOwnBookUCI, FALSE, INVALID },
 543   { "firstXBook", ArgFalse, (void *) &appData.firstHasOwnBookUCI, FALSE, INVALID },
 544   { "secondHasOwnBookUCI", ArgBoolean, (void *) &appData.secondHasOwnBookUCI, FALSE, (ArgIniType) TRUE },
 545   { "sNoOwnBookUCI", ArgFalse, (void *) &appData.secondHasOwnBookUCI, FALSE, INVALID },
 546   { "secondXBook", ArgFalse, (void *) &appData.secondHasOwnBookUCI, FALSE, INVALID },
 547   { "adapterCommand", ArgFilename, (void *) &appData.adapterCommand, TRUE, (ArgIniType) "polyglot -noini -ec \"%fcp\" -ed \"%fd\"" },
 548   { "polyglotDir", ArgFilename, (void *) &appData.polyglotDir, TRUE, (ArgIniType) "" },
 549   { "usePolyglotBook", ArgBoolean, (void *) &appData.usePolyglotBook, TRUE, (ArgIniType) FALSE },
 550   { "polyglotBook", ArgFilename, (void *) &appData.polyglotBook, TRUE, (ArgIniType) "" },
 551   { "bookDepth", ArgInt, (void *) &appData.bookDepth, TRUE, (ArgIniType) 12 },
 552   { "bookVariation", ArgInt, (void *) &appData.bookStrength, TRUE, (ArgIniType) 50 },
 553   { "defaultHashSize", ArgInt, (void *) &appData.defaultHashSize, TRUE, (ArgIniType) 64 },
 554   { "defaultCacheSizeEGTB", ArgInt, (void *) &appData.defaultCacheSizeEGTB, TRUE, (ArgIniType) 4 },
 555   { "defaultPathEGTB", ArgFilename, (void *) &appData.defaultPathEGTB, TRUE, (ArgIniType) "c:\\egtb" },
 556   { "language", ArgFilename, (void *) &appData.language, TRUE, (ArgIniType) "" },
 557   { "userFileDirectory", ArgFilename, (void *) &homeDir, FALSE, (ArgIniType) installDir },
 558
 559   // [HGM] tournament options
 560   { "tourney", ArgFilename, (void *) &appData.tourneyFile, FALSE, (ArgIniType) "" },
 561   { "tf", ArgFilename, (void *) &appData.tourneyFile, FALSE, INVALID },
 562   { "processes", ArgString, (void *) &appData.processes, FALSE, (ArgIniType) "        " },
 563   { "participants", ArgString, (void *) &appData.participants, FALSE, (ArgIniType) "" },
 564   { "tourneyType", ArgInt, (void *) &appData.tourneyType, FALSE, (ArgIniType) 0 },
 565   { "tt", ArgInt, (void *) &appData.tourneyType, FALSE, INVALID },
 566   { "tourneyCycles", ArgInt, (void *) &appData.tourneyCycles, FALSE, (ArgIniType) 1 },
 567   { "cy", ArgInt, (void *) &appData.tourneyCycles, FALSE, INVALID },
 568   { "results", ArgString, (void *) &appData.results, FALSE, (ArgIniType) "" },
 569   { "syncAfterRound", ArgBoolean, (void *) &appData.roundSync, FALSE, (ArgIniType) FALSE },
 570   { "syncAfterCycle", ArgBoolean, (void *) &appData.cycleSync, FALSE, (ArgIniType) TRUE },
 571
 572   /* [HGM] board-size, adjudication and misc. options */
 573   { "oneClickMove", ArgBoolean, (void *) &appData.oneClick, TRUE, (ArgIniType) FALSE },
 574   { "boardWidth", ArgInt, (void *) &appData.NrFiles, FALSE, (ArgIniType) -1 },
 575   { "boardHeight", ArgInt, (void *) &appData.NrRanks, FALSE, (ArgIniType) -1 },
 576   { "holdingsSize", ArgInt, (void *) &appData.holdingsSize, FALSE, (ArgIniType) -1 },
 577   { "defaultMatchGames", ArgInt, (void *) &appData.defaultMatchGames, TRUE, (ArgIniType) 10 },
 578   { "matchPause", ArgInt, (void *) &appData.matchPause, TRUE, (ArgIniType) 10000 },
 579   { "pieceToCharTable", ArgString, (void *) &appData.pieceToCharTable, FALSE, INVALID },
 580   { "pieceNickNames", ArgString, (void *) &appData.pieceNickNames, FALSE, INVALID },
 581   { "colorNickNames", ArgString, (void *) &appData.colorNickNames, FALSE, INVALID },
 582   { "flipBlack", ArgBoolean, (void *) &appData.upsideDown, FALSE, (ArgIniType) FALSE },
 583   { "allWhite", ArgBoolean, (void *) &appData.allWhite, FALSE, (ArgIniType) FALSE },
 584   { "alphaRank", ArgBoolean, (void *) &appData.alphaRank, FALSE, (ArgIniType) FALSE },
 585   { "firstAlphaRank", ArgBoolean, (void *) &first.alphaRank, FALSE, (ArgIniType) FALSE },
 586   { "secondAlphaRank", ArgBoolean, (void *) &second.alphaRank, FALSE, (ArgIniType) FALSE },
 587   { "testClaims", ArgBoolean, (void *) &appData.testClaims, TRUE, (ArgIniType) FALSE },
 588   { "checkMates", ArgBoolean, (void *) &appData.checkMates, TRUE, (ArgIniType) FALSE },
 589   { "materialDraws", ArgBoolean, (void *) &appData.materialDraws, TRUE, (ArgIniType) FALSE },
 590   { "trivialDraws", ArgBoolean, (void *) &appData.trivialDraws, TRUE, (ArgIniType) FALSE },
 591   { "ruleMoves", ArgInt, (void *) &appData.ruleMoves, TRUE, (ArgIniType) 51 },
 592   { "repeatsToDraw", ArgInt, (void *) &appData.drawRepeats, TRUE, (ArgIniType) 6 },
 593   { "backgroundObserve", ArgBoolean, (void *) &appData.bgObserve, TRUE, (ArgIniType) FALSE },
 594   { "dualBoard", ArgBoolean, (void *) &appData.dualBoard, TRUE, (ArgIniType) FALSE },
 595   { "autoKibitz", ArgTrue, (void *) &appData.autoKibitz, FALSE, INVALID },
 596   { "engineDebugOutput", ArgInt, (void *) &appData.engineComments, FALSE, (ArgIniType) 1 },
 597   { "userName", ArgString, (void *) &appData.userName, FALSE, INVALID },
 598   { "rewindIndex", ArgInt, (void *) &appData.rewindIndex, FALSE, INVALID },
 599   { "sameColorGames", ArgInt, (void *) &appData.sameColorGames, FALSE, INVALID },
 600   { "smpCores", ArgInt, (void *) &appData.smpCores, TRUE, (ArgIniType) 1 },
 601   { "egtFormats", ArgString, (void *) &appData.egtFormats, TRUE, (ArgIniType) "" },
 602   { "niceEngines", ArgInt, (void *) &appData.niceEngines, TRUE, INVALID },
 603   { "firstLogo", ArgFilename, (void *) &appData.firstLogo, FALSE, INVALID },
 604   { "secondLogo", ArgFilename, (void *) &appData.secondLogo, FALSE, INVALID },
 605   { "autoLogo", ArgBoolean, (void *) &appData.autoLogo, TRUE, INVALID },
 606   { "firstOptions", ArgString, (void *) &appData.firstOptions, FALSE, (ArgIniType) "" },
 607   { "secondOptions", ArgString, (void *) &appData.secondOptions, FALSE, (ArgIniType) "" },
 608   { "firstNeedsNoncompliantFEN", ArgString, (void *) &appData.fenOverride1, FALSE, (ArgIniType) NULL },
 609   { "secondNeedsNoncompliantFEN", ArgString, (void *) &appData.fenOverride2, FALSE, (ArgIniType) NULL },
 610   { "keepAlive", ArgInt, (void *) &appData.keepAlive, FALSE, INVALID },
 611   { "icstype", ArgInt, (void *) &ics_type, FALSE, INVALID },
 612   { "forceIllegalMoves", ArgTrue, (void *) &appData.forceIllegal, FALSE, INVALID },
 613   { "showTargetSquares", ArgBoolean, (void *) &appData.markers, TRUE, FALSE },
 614   { "firstPgnName", ArgString, (void *) &appData.pgnName[0], FALSE, (ArgIniType) "" },
 615   { "fn", ArgString, (void *) &appData.pgnName[0], FALSE, INVALID },
 616   { "secondPgnName", ArgString, (void *) &appData.pgnName[1], FALSE, (ArgIniType) "" },
 617   { "sn", ArgString, (void *) &appData.pgnName[1], FALSE, INVALID },
 618   { "absoluteAnalysisScores", ArgBoolean, (void *) &appData.whitePOV, TRUE, FALSE },
 619
 620 #if ZIPPY
 621   { "zippyTalk", ArgBoolean, (void *) &appData.zippyTalk, FALSE, (ArgIniType) ZIPPY_TALK },
 622   { "zt", ArgTrue, (void *) &appData.zippyTalk, FALSE, INVALID },
 623   { "xzt", ArgFalse, (void *) &appData.zippyTalk, FALSE, INVALID },
 624   { "-zt", ArgFalse, (void *) &appData.zippyTalk, FALSE, INVALID },
 625   { "zippyPlay", ArgBoolean, (void *) &appData.zippyPlay, FALSE, (ArgIniType) ZIPPY_PLAY },
 626   { "zp", ArgTrue, (void *) &appData.zippyPlay, FALSE, INVALID },
 627   { "xzp", ArgFalse, (void *) &appData.zippyPlay, FALSE, INVALID },
 628   { "-zp", ArgFalse, (void *) &appData.zippyPlay, FALSE, INVALID },
 629   { "zippyLines", ArgFilename, (void *) &appData.zippyLines, FALSE, (ArgIniType) ZIPPY_LINES },
 630   { "zippyPinhead", ArgString, (void *) &appData.zippyPinhead, FALSE, (ArgIniType) ZIPPY_PINHEAD },
 631   { "zippyPassword", ArgString, (void *) &appData.zippyPassword, FALSE, (ArgIniType) ZIPPY_PASSWORD },
 632   { "zippyPassword2", ArgString, (void *) &appData.zippyPassword2, FALSE, (ArgIniType) ZIPPY_PASSWORD2 },
 633   { "zippyWrongPassword", ArgString, (void *) &appData.zippyWrongPassword,
 634     FALSE, (ArgIniType) ZIPPY_WRONG_PASSWORD },
 635   { "zippyAcceptOnly", ArgString, (void *) &appData.zippyAcceptOnly, FALSE, (ArgIniType) ZIPPY_ACCEPT_ONLY },
 636   { "zippyUseI", ArgBoolean, (void *) &appData.zippyUseI, FALSE, (ArgIniType) ZIPPY_USE_I },
 637   { "zui", ArgTrue, (void *) &appData.zippyUseI, FALSE, INVALID },
 638   { "xzui", ArgFalse, (void *) &appData.zippyUseI, FALSE, INVALID },
 639   { "-zui", ArgFalse, (void *) &appData.zippyUseI, FALSE, INVALID },
 640   { "zippyBughouse", ArgInt, (void *) &appData.zippyBughouse, FALSE, (ArgIniType) ZIPPY_BUGHOUSE },
 641   { "zippyNoplayCrafty", ArgBoolean, (void *) &appData.zippyNoplayCrafty,
 642     FALSE, (ArgIniType) ZIPPY_NOPLAY_CRAFTY },
 643   { "znc", ArgTrue, (void *) &appData.zippyNoplayCrafty, FALSE, INVALID },
 644   { "xznc", ArgFalse, (void *) &appData.zippyNoplayCrafty, FALSE, INVALID },
 645   { "-znc", ArgFalse, (void *) &appData.zippyNoplayCrafty, FALSE, INVALID },
 646   { "zippyGameEnd", ArgString, (void *) &appData.zippyGameEnd, FALSE, (ArgIniType) ZIPPY_GAME_END },
 647   { "zippyGameStart", ArgString, (void *) &appData.zippyGameStart, FALSE, (ArgIniType) ZIPPY_GAME_START },
 648   { "zippyAdjourn", ArgBoolean, (void *) &appData.zippyAdjourn, FALSE, (ArgIniType) ZIPPY_ADJOURN },
 649   { "zadj", ArgTrue, (void *) &appData.zippyAdjourn, FALSE, INVALID },
 650   { "xzadj", ArgFalse, (void *) &appData.zippyAdjourn, FALSE, INVALID },
 651   { "-zadj", ArgFalse, (void *) &appData.zippyAdjourn, FALSE, INVALID },
 652   { "zippyAbort", ArgBoolean, (void *) &appData.zippyAbort, FALSE, (ArgIniType) ZIPPY_ABORT },
 653   { "zab", ArgTrue, (void *) &appData.zippyAbort, FALSE, INVALID },
 654   { "xzab", ArgFalse, (void *) &appData.zippyAbort, FALSE, INVALID },
 655   { "-zab", ArgFalse, (void *) &appData.zippyAbort, FALSE, INVALID },
 656   { "zippyVariants", ArgString, (void *) &appData.zippyVariants, FALSE, (ArgIniType) ZIPPY_VARIANTS },
 657   { "zippyMaxGames", ArgInt, (void *)&appData.zippyMaxGames, FALSE, (ArgIniType) ZIPPY_MAX_GAMES},
 658   { "zippyReplayTimeout", ArgInt, (void *)&appData.zippyReplayTimeout, FALSE, (ArgIniType) ZIPPY_REPLAY_TIMEOUT },
 659   { "zippyShortGame", ArgInt, (void *)&appData.zippyShortGame, FALSE, INVALID },
 660   /* Kludge to allow winboard.ini files from buggy 4.0.4 to be read: */
 661   { "zippyReplyTimeout", ArgInt, (void *)&junk, FALSE, INVALID },
 662 #endif
 663   /* [HGM] options for broadcasting and time odds */
 664   { "chatBoxes", ArgString, (void *) &appData.chatBoxes, !XBOARD, (ArgIniType) NULL },
 665   { "serverMoves", ArgString, (void *) &appData.serverMovesName, FALSE, (ArgIniType) NULL },
 666   { "suppressLoadMoves", ArgBoolean, (void *) &appData.suppressLoadMoves, FALSE, (ArgIniType) FALSE },
 667   { "serverPause", ArgInt, (void *) &appData.serverPause, FALSE, (ArgIniType) 15 },
 668   { "firstTimeOdds", ArgInt, (void *) &appData.firstTimeOdds, FALSE, (ArgIniType) 1 },
 669   { "secondTimeOdds", ArgInt, (void *) &appData.secondTimeOdds, FALSE, (ArgIniType) 1 },
 670   { "timeOddsMode", ArgInt, (void *) &appData.timeOddsMode, TRUE, INVALID },
 671   { "firstAccumulateTC", ArgInt, (void *) &appData.firstAccumulateTC, FALSE, (ArgIniType) 1 },
 672   { "secondAccumulateTC", ArgInt, (void *) &appData.secondAccumulateTC, FALSE, (ArgIniType) 1 },
 673   { "firstNPS", ArgInt, (void *) &appData.firstNPS, FALSE, (ArgIniType) -1 },
 674   { "secondNPS", ArgInt, (void *) &appData.secondNPS, FALSE, (ArgIniType) -1 },
 675   { "noGUI", ArgTrue, (void *) &appData.noGUI, FALSE, INVALID },
 676   { "keepLineBreaksICS", ArgBoolean, (void *) &appData.noJoin, TRUE, INVALID },
 677   { "wrapContinuationSequence", ArgString, (void *) &appData.wrapContSeq, FALSE, INVALID },
 678   { "useInternalWrap", ArgTrue, (void *) &appData.useInternalWrap, FALSE, INVALID }, /* noJoin usurps this if set */
 679
 680   // [HGM] placement: put all window layouts last in ini file, but man X,Y before all others
 681   { "minX", ArgZ, (void *) &minX, FALSE, INVALID }, // [HGM] placement: to make suer auxialary windows can be placed
 682   { "minY", ArgZ, (void *) &minY, FALSE, INVALID },
 683   { "winWidth",  ArgInt, (void *) &wpMain.width,  TRUE, INVALID }, // [HGM] placement: dummies to remember right & bottom
 684   { "winHeight", ArgInt, (void *) &wpMain.height, TRUE, INVALID }, //       for attaching auxiliary windows to them
 685   { "x", ArgInt, (void *) &wpMain.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 686   { "y", ArgInt, (void *) &wpMain.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 687   { "icsX", ArgX,   (void *) &wpConsole.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 688   { "icsY", ArgY,   (void *) &wpConsole.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 689   { "icsW", ArgInt, (void *) &wpConsole.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 690   { "icsH", ArgInt, (void *) &wpConsole.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 691   { "analysisX", ArgX,   (void *) &junk, FALSE, INVALID }, // [HGM] placement: analysis window no longer exists
 692   { "analysisY", ArgY,   (void *) &junk, FALSE, INVALID }, //       provided for compatibility with old ini files
 693   { "analysisW", ArgInt, (void *) &junk, FALSE, INVALID },
 694   { "analysisH", ArgInt, (void *) &junk, FALSE, INVALID },
 695   { "commentX", ArgX,   (void *) &wpComment.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 696   { "commentY", ArgY,   (void *) &wpComment.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 697   { "commentW", ArgInt, (void *) &wpComment.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 698   { "commentH", ArgInt, (void *) &wpComment.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 699   { "tagsX", ArgX,   (void *) &wpTags.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 700   { "tagsY", ArgY,   (void *) &wpTags.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 701   { "tagsW", ArgInt, (void *) &wpTags.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 702   { "tagsH", ArgInt, (void *) &wpTags.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 703   { "gameListX", ArgX,   (void *) &wpGameList.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 704   { "gameListY", ArgY,   (void *) &wpGameList.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 705   { "gameListW", ArgInt, (void *) &wpGameList.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 706   { "gameListH", ArgInt, (void *) &wpGameList.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 707   /* [AS] Layout stuff */
 708   { "moveHistoryUp", ArgBoolean, (void *) &wpMoveHistory.visible, TRUE, (ArgIniType) TRUE },
 709   { "moveHistoryX", ArgX,   (void *) &wpMoveHistory.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 710   { "moveHistoryY", ArgY,   (void *) &wpMoveHistory.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 711   { "moveHistoryW", ArgInt, (void *) &wpMoveHistory.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 712   { "moveHistoryH", ArgInt, (void *) &wpMoveHistory.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 713
 714   { "evalGraphUp", ArgBoolean, (void *) &wpEvalGraph.visible, TRUE, (ArgIniType) TRUE },
 715   { "evalGraphX", ArgX,   (void *) &wpEvalGraph.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 716   { "evalGraphY", ArgY,   (void *) &wpEvalGraph.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 717   { "evalGraphW", ArgInt, (void *) &wpEvalGraph.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 718   { "evalGraphH", ArgInt, (void *) &wpEvalGraph.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 719
 720   { "engineOutputUp", ArgBoolean, (void *) &wpEngineOutput.visible, TRUE, (ArgIniType) TRUE },
 721   { "engineOutputX", ArgX,   (void *) &wpEngineOutput.x, TRUE, (ArgIniType) CW_USEDEFAULT },
 722   { "engineOutputY", ArgY,   (void *) &wpEngineOutput.y, TRUE, (ArgIniType) CW_USEDEFAULT },
 723   { "engineOutputW", ArgInt, (void *) &wpEngineOutput.width, TRUE, (ArgIniType) CW_USEDEFAULT },
 724   { "engineOutputH", ArgInt, (void *) &wpEngineOutput.height, TRUE, (ArgIniType) CW_USEDEFAULT },
 725
 726   { NULL, ArgNone, NULL, FALSE, INVALID }
 727 };
 728
 729
 730 /* Kludge for indirection files on command line */
 731 char* lastIndirectionFilename;
 732 ArgDescriptor argDescriptorIndirection =
 733 { "", ArgSettingsFilename, (void *) NULL, FALSE };
 734
 735 void
 736 ExitArgError(char *msg, char *badArg)
 737 {
 738   char buf[MSG_SIZ];
 739   int len;
 740
 741   len = snprintf(buf,MSG_SIZ, "%s %s", msg, badArg);
 742   if( (len > MSG_SIZ) && appData.debugMode )
 743     fprintf(debugFP, "ExitArgError: buffer truncated. Input: msg=%s badArg=%s\n", msg, badArg);
 744
 745   DisplayFatalError(buf, 0, 2);
 746   exit(2);
 747 }
 748
 749 int
 750 ValidateInt(char *s)
 751 {
 752   char *p = s;
 753   if(*p == '-' || *p == '+') p++;
 754   while(*p) if(!isdigit(*p++)) ExitArgError("Bad integer value", s);
 755   return atoi(s);
 756 }
 757
 758 char
 759 StringGet(void *getClosure)
 760 {
 761   char **p = (char **) getClosure;
 762   return *((*p)++);
 763 }
 764
 765 char
 766 FileGet(void *getClosure)
 767 {
 768   int c;
 769   FILE* f = (FILE*) getClosure;
 770
 771   c = getc(f);
 772   if (c == '\r') c = getc(f); // work around DOS format files by bypassing the '\r' completely
 773   if (c == EOF)
 774     return NULLCHAR;
 775   else
 776     return (char) c;
 777 }
 778
 779 /* Parse settings file named "name". If file found, return the
 780    full name in fullname and return TRUE; else return FALSE */
 781 Boolean
 782 ParseSettingsFile(char *name, char **addr)
 783 {
 784   FILE *f;
 785   int ok,len;
 786   char buf[MSG_SIZ], fullname[MSG_SIZ];
 787
 788
 789   ok = MySearchPath(installDir, name, fullname);
 790   if(!ok && strchr(name, '.') == NULL)
 791     { // append default file-name extension '.ini' when needed
 792       len = snprintf(buf,MSG_SIZ, "%s.ini", name);
 793       if( (len > MSG_SIZ) && appData.debugMode )
 794         fprintf(debugFP, "ParseSettingsFile: buffer truncated. Input: name=%s \n",name);
 795
 796       ok = MySearchPath(installDir, buf, fullname);
 797     }
 798   if (ok) {
 799     f = fopen(fullname, "r");
 800     if (f != NULL) {
 801       if (addr != NULL) {
 802             ASSIGN(*addr, fullname);
 803       }
 804       ParseArgs(FileGet, f);
 805       fclose(f);
 806       return TRUE;
 807     }
 808   }
 809   return FALSE;
 810 }
 811
 812 void
 813 ParseArgs(GetFunc get, void *cl)
 814 {
 815   char argName[MAX_ARG_LEN];
 816   char argValue[MAX_ARG_LEN];
 817   ArgDescriptor *ad;
 818   char start;
 819   char *q;
 820   int i, octval;
 821   char ch;
 822   int posarg = 0;
 823
 824   ch = get(cl);
 825   for (;;) {
 826     while (ch == ' ' || ch == '\n' || ch == '\t') ch = get(cl);
 827     if (ch == NULLCHAR) break;
 828     if (ch == ';') {
 829       /* Comment to end of line */
 830       ch = get(cl);
 831       while (ch != '\n' && ch != NULLCHAR) ch = get(cl);
 832       continue;
 833     } else if (ch == '/' || ch == '-') {
 834       /* Switch */
 835       q = argName;
 836       while (ch != ' ' && ch != '=' && ch != ':' && ch != NULLCHAR &&
 837              ch != '\n' && ch != '\t') {
 838         *q++ = ch;
 839         ch = get(cl);
 840       }
 841       *q = NULLCHAR;
 842       for (ad = argDescriptors; ad->argName != NULL; ad++)
 843         if (strcmp(ad->argName, argName + 1) == 0) break;
 844       if (ad->argName == NULL)
 845         ExitArgError("Unrecognized argument", argName);
 846
 847     } else if (ch == '@') {
 848       /* Indirection file */
 849       ad = &argDescriptorIndirection;
 850       ch = get(cl);
 851     } else {
 852       /* Positional argument */
 853       ad = &argDescriptors[posarg++];
 854       strncpy(argName, ad->argName,sizeof(argName)/sizeof(argName[0]));
 855     }
 856
 857     if (ad->argType == ArgTrue) {
 858       *(Boolean *) ad->argLoc = TRUE;
 859       continue;
 860     }
 861     if (ad->argType == ArgFalse) {
 862       *(Boolean *) ad->argLoc = FALSE;
 863       continue;
 864     }
 865
 866     while (ch == ' ' || ch == '=' || ch == ':' || ch == '\t') ch = get(cl);
 867     if (ch == NULLCHAR || ch == '\n') {
 868       ExitArgError("No value provided for argument", argName);
 869     }
 870     q = argValue;
 871     if (ch == '{') {
 872       // Quoting with { }.  No characters have to (or can) be escaped.
 873       // Thus the string cannot contain a '}' character.
 874       start = ch;
 875       ch = get(cl);
 876       while (start) {
 877         switch (ch) {
 878         case NULLCHAR:
 879           start = NULLCHAR;
 880           break;
 881
 882         case '}':
 883           ch = get(cl);
 884           start = NULLCHAR;
 885           break;
 886
 887         default:
 888           *q++ = ch;
 889           ch = get(cl);
 890           break;
 891         }
 892       }
 893     } else if (ch == '\'' || ch == '"') {
 894       // Quoting with ' ' or " ", with \ as escape character.
 895       // Inconvenient for long strings that may contain Windows filenames.
 896       start = ch;
 897       ch = get(cl);
 898       while (start) {
 899         switch (ch) {
 900         case NULLCHAR:
 901           start = NULLCHAR;
 902           break;
 903
 904         default:
 905         not_special:
 906           *q++ = ch;
 907           ch = get(cl);
 908           break;
 909
 910         case '\'':
 911         case '\"':
 912           if (ch == start) {
 913             ch = get(cl);
 914             start = NULLCHAR;
 915             break;
 916           } else {
 917             goto not_special;
 918           }
 919
 920         case '\\':
 921           if (ad->argType == ArgFilename
 922               || ad->argType == ArgSettingsFilename) {
 923               goto not_special;
 924           }
 925           ch = get(cl);
 926           switch (ch) {
 927           case NULLCHAR:
 928             ExitArgError("Incomplete \\ escape in value for", argName);
 929             break;
 930           case 'n':
 931             *q++ = '\n';
 932             ch = get(cl);
 933             break;
 934           case 'r':
 935             *q++ = '\r';
 936             ch = get(cl);
 937             break;
 938           case 't':
 939             *q++ = '\t';
 940             ch = get(cl);
 941             break;
 942           case 'b':
 943             *q++ = '\b';
 944             ch = get(cl);
 945             break;
 946           case 'f':
 947             *q++ = '\f';
 948             ch = get(cl);
 949             break;
 950           default:
 951             octval = 0;
 952             for (i = 0; i < 3; i++) {
 953               if (ch >= '0' && ch <= '7') {
 954                 octval = octval*8 + (ch - '0');
 955                 ch = get(cl);
 956               } else {
 957                 break;
 958               }
 959             }
 960             if (i > 0) {
 961               *q++ = (char) octval;
 962             } else {
 963               *q++ = ch;
 964               ch = get(cl);
 965             }
 966             break;
 967           }
 968           break;
 969         }
 970       }
 971     } else {
 972       while (ch != ' ' && ch != NULLCHAR && ch != '\t' && ch != '\n') {
 973         *q++ = ch;
 974         ch = get(cl);
 975       }
 976     }
 977     *q = NULLCHAR;
 978
 979     switch (ad->argType) {
 980     case ArgInt:
 981       *(int *) ad->argLoc = ValidateInt(argValue);
 982       break;
 983
 984     case ArgX:
 985       *(int *) ad->argLoc = ValidateInt(argValue) + wpMain.x; // [HGM] placement: translate stored relative to absolute
 986       break;
 987
 988     case ArgY:
 989       *(int *) ad->argLoc = ValidateInt(argValue) + wpMain.y; // (this is really kludgey, it should be done where used...)
 990       break;
 991
 992     case ArgZ:
 993       *(int *) ad->argLoc = ValidateInt(argValue);
 994       EnsureOnScreen(&wpMain.x, &wpMain.y, minX, minY);
 995       break;
 996
 997     case ArgFloat:
 998       *(float *) ad->argLoc = (float) atof(argValue);
 999       break;
1000
1001     case ArgString:
1002     case ArgFilename:
1003       ASSIGN(*(char **) ad->argLoc, argValue);
1004       break;
1005
1006     case ArgSettingsFilename:
1007       {
1008         if (ParseSettingsFile(argValue, (char**)ad->argLoc)) {
1009         } else {
1010           if (ad->argLoc != NULL) {
1011           } else {
1012             ExitArgError("Failed to open indirection file", argValue);
1013           }
1014         }
1015       }
1016       break;
1017
1018     case ArgBoolean:
1019       switch (argValue[0]) {
1020       case 't':
1021       case 'T':
1022         *(Boolean *) ad->argLoc = TRUE;
1023         break;
1024       case 'f':
1025       case 'F':
1026         *(Boolean *) ad->argLoc = FALSE;
1027         break;
1028       default:
1029         ExitArgError("Unrecognized boolean argument value", argValue);
1030         break;
1031       }
1032       break;
1033
1034     case ArgColor:
1035       ParseColor((int)(intptr_t)ad->argLoc, argValue);
1036       break;
1037
1038     case ArgAttribs: {
1039       ColorClass cc = (ColorClass)ad->argLoc;
1040         ParseTextAttribs(cc, argValue); // [HGM] wrapper for platform independency
1041       }
1042       break;
1043
1044     case ArgBoardSize:
1045       ParseBoardSize(ad->argLoc, argValue);
1046       break;
1047
1048     case ArgFont:
1049       ParseFont(argValue, (int)(intptr_t)ad->argLoc);
1050       break;
1051
1052     case ArgCommSettings:
1053       ParseCommPortSettings(argValue);
1054       break;
1055
1056     case ArgNone:
1057       ExitArgError("Unrecognized argument", argValue);
1058       break;
1059     case ArgTrue:
1060     case ArgFalse: ;
1061     }
1062   }
1063 }
1064
1065 void
1066 ParseArgsFromString(char *p)
1067 {
1068     ParseArgs(StringGet, &p);
1069 }
1070
1071 void
1072 ParseArgsFromFile(FILE *f)
1073 {
1074     ParseArgs(FileGet, f);
1075 }
1076
1077 void
1078 ParseIcsTextMenu(char *icsTextMenuString)
1079 {
1080 //  int flags = 0;
1081   IcsTextMenuEntry *e = icsTextMenuEntry;
1082   char *p = icsTextMenuString;
1083   while (e->item != NULL && e < icsTextMenuEntry + ICS_TEXT_MENU_SIZE) {
1084     free(e->item);
1085     e->item = NULL;
1086     if (e->command != NULL) {
1087       free(e->command);
1088       e->command = NULL;
1089     }
1090     e++;
1091   }
1092   e = icsTextMenuEntry;
1093   while (*p && e < icsTextMenuEntry + ICS_TEXT_MENU_SIZE) {
1094     if (*p == ';' || *p == '\n') {
1095       e->item = strdup("-");
1096       e->command = NULL;
1097       p++;
1098     } else if (*p == '-') {
1099       e->item = strdup("-");
1100       e->command = NULL;
1101       p++;
1102       if (*p) p++;
1103     } else {
1104       char *q, *r, *s, *t;
1105       char c;
1106       q = strchr(p, ',');
1107       if (q == NULL) break;
1108       *q = NULLCHAR;
1109       r = strchr(q + 1, ',');
1110       if (r == NULL) break;
1111       *r = NULLCHAR;
1112       s = strchr(r + 1, ',');
1113       if (s == NULL) break;
1114       *s = NULLCHAR;
1115       c = ';';
1116       t = strchr(s + 1, c);
1117       if (t == NULL) {
1118         c = '\n';
1119         t = strchr(s + 1, c);
1120       }
1121       if (t != NULL) *t = NULLCHAR;
1122       e->item = strdup(p);
1123       e->command = strdup(q + 1);
1124       e->getname = *(r + 1) != '0';
1125       e->immediate = *(s + 1) != '0';
1126       *q = ',';
1127       *r = ',';
1128       *s = ',';
1129       if (t == NULL) break;
1130       *t = c;
1131       p = t + 1;
1132     }
1133     e++;
1134   }
1135 }
1136
1137 void
1138 SetDefaultTextAttribs()
1139 {
1140   ColorClass cc;
1141   for (cc = (ColorClass)0; cc < ColorNone; cc++) {
1142     ParseTextAttribs(cc, defaultTextAttribs[cc]);
1143   }
1144 }
1145
1146 void
1147 SetDefaultsFromList()
1148 { // [HGM] ini: take defaults from argDescriptor list
1149   int i;
1150
1151   for(i=0; argDescriptors[i].argName != NULL; i++) {
1152     if(argDescriptors[i].defaultValue != INVALID)
1153       switch(argDescriptors[i].argType) {
1154         case ArgBoolean:
1155         case ArgTrue:
1156         case ArgFalse:
1157           *(Boolean *) argDescriptors[i].argLoc = (int)(intptr_t)argDescriptors[i].defaultValue;
1158           break;
1159         case ArgInt:
1160         case ArgX:
1161         case ArgY:
1162         case ArgZ:
1163           *(int *) argDescriptors[i].argLoc = (int)(intptr_t)argDescriptors[i].defaultValue;
1164           break;
1165         case ArgString:
1166         case ArgFilename:
1167         case ArgSettingsFilename:
1168           if((char *)argDescriptors[i].defaultValue)
1169           *(char **) argDescriptors[i].argLoc = strdup((char *)argDescriptors[i].defaultValue);
1170           break;
1171         case ArgBoardSize:
1172           *(int *) argDescriptors[i].argLoc = (int)(intptr_t)argDescriptors[i].defaultValue;
1173           break;
1174         case ArgColor:
1175           ParseColor((int)(intptr_t)argDescriptors[i].argLoc, (char*)argDescriptors[i].defaultValue);
1176           break;
1177         case ArgFloat: // floats cannot be casted to int without precision loss
1178         default: ; // some arg types cannot be initialized through table
1179     }
1180   }
1181 }
1182
1183 void
1184 InitAppData(char *lpCmdLine)
1185 {
1186   int i;
1187   char buf[MAX_ARG_LEN], currDir[MSG_SIZ];
1188   char *p;
1189
1190   /* Initialize to defaults */
1191   SetDefaultsFromList(); // this sets most defaults
1192
1193   // some parameters for which there are no options!
1194   appData.Iconic = FALSE; /*unused*/
1195   appData.icsEngineAnalyze = FALSE;
1196
1197   // float: casting to int is not harmless, so default cannot be contained in table
1198   appData.timeDelay = TIME_DELAY;
1199   appData.timeIncrement = TIME_INCREMENT;
1200
1201   // some complex, platform-dependent stuff that could not be handled from table
1202   SetDefaultTextAttribs();
1203   SetFontDefaults();
1204   SetCommPortDefaults();
1205
1206   /* Parse default settings file if any */
1207   ParseSettingsFile(settingsFileName, &settingsFileName);
1208
1209   /* Parse command line */
1210   ParseArgs(StringGet, &lpCmdLine);
1211
1212   /* [HGM] make sure board size is acceptable */
1213   if(appData.NrFiles > BOARD_FILES ||
1214      appData.NrRanks > BOARD_RANKS   )
1215       DisplayFatalError("Recompile with BOARD_RANKS or BOARD_FILES, to support this size", 0, 2);
1216
1217   /* [HGM] After parsing the options from the .ini file, and overruling them
1218    * with options from the command line, we now make an even higher priority
1219    * overrule by WB options attached to the engine command line. This so that
1220    * tournament managers can use WB options (such as /timeOdds) that follow
1221    * the engines.
1222    */
1223   if(appData.firstChessProgram != NULL) {
1224       char *p = StrStr(appData.firstChessProgram, "WBopt");
1225       static char *f = "first";
1226       char buf[MSG_SIZ], *q = buf;
1227       int len;
1228
1229       if(p != NULL)
1230         { // engine command line contains WinBoard options
1231           len = snprintf(buf, MSG_SIZ, p+6, f, f, f, f, f, f, f, f, f, f); // replace %s in them by "first"
1232           if( (len > MSG_SIZ) && appData.debugMode )
1233             fprintf(debugFP, "InitAppData: buffer truncated.\n");
1234
1235           ParseArgs(StringGet, &q);
1236           p[-1] = 0; // cut them offengine command line
1237         }
1238   }
1239   // now do same for second chess program
1240   if(appData.secondChessProgram != NULL) {
1241       char *p = StrStr(appData.secondChessProgram, "WBopt");
1242       static char *s = "second";
1243       char buf[MSG_SIZ], *q = buf;
1244       int len;
1245
1246       if(p != NULL)
1247         { // engine command line contains WinBoard options
1248           len = snprintf(buf,MSG_SIZ, p+6, s, s, s, s, s, s, s, s, s, s); // replace %s in them by "first"
1249           if( (len > MSG_SIZ) && appData.debugMode )
1250             fprintf(debugFP, "InitAppData: buffer truncated.\n");
1251
1252           ParseArgs(StringGet, &q);
1253           p[-1] = 0; // cut them offengine command line
1254         }
1255   }
1256
1257   /* Propagate options that affect others */
1258   if (appData.matchMode || appData.matchGames) chessProgram = TRUE;
1259   if (appData.icsActive || appData.noChessProgram) {
1260      chessProgram = FALSE;  /* not local chess program mode */
1261   }
1262
1263   /* Open startup dialog if needed */
1264   if ((!appData.noChessProgram && !chessProgram && !appData.icsActive) ||
1265       (appData.icsActive && *appData.icsHost == NULLCHAR) ||
1266       (chessProgram && (*appData.firstChessProgram == NULLCHAR ||
1267                         *appData.secondChessProgram == NULLCHAR)))
1268                 PopUpStartupDialog();
1269
1270   /* Make sure save files land in the right (?) directory */
1271   if (MyGetFullPathName(appData.saveGameFile, buf)) {
1272     appData.saveGameFile = strdup(buf);
1273   }
1274   if (MyGetFullPathName(appData.savePositionFile, buf)) {
1275     appData.savePositionFile = strdup(buf);
1276   }
1277
1278   /* Finish initialization for fonts and sounds */
1279   CreateFonts();
1280
1281   GetCurrentDirectory(MSG_SIZ, currDir);
1282   SetCurrentDirectory(installDir);
1283   LoadAllSounds();
1284   SetCurrentDirectory(currDir);
1285
1286   p = icsTextMenuString;
1287   if (p[0] == '@') {
1288     FILE* f = fopen(p + 1, "r");
1289     if (f == NULL) {
1290       DisplayFatalError(p + 1, errno, 2);
1291       return;
1292     }
1293     i = fread(buf, 1, sizeof(buf)-1, f);
1294     fclose(f);
1295     buf[i] = NULLCHAR;
1296     p = buf;
1297   }
1298   ParseIcsTextMenu(strdup(p));
1299 }
1300
1301 void
1302 SaveSettings(char* name)
1303 {
1304   FILE *f;
1305   ArgDescriptor *ad;
1306   char dir[MSG_SIZ], buf[MSG_SIZ];
1307
1308   if (!MainWindowUp()) return;
1309
1310   GetCurrentDirectory(MSG_SIZ, dir);
1311   if(MySearchPath(installDir, name, buf)) {
1312     f = fopen(buf, "w");
1313   } else {
1314     SetCurrentDirectory(installDir);
1315     f = fopen(name, "w");
1316     SetCurrentDirectory(dir);
1317   }
1318   if (f == NULL) {
1319     DisplayError(name, errno);
1320     return;
1321   }
1322
1323   fprintf(f, ";\n");
1324   fprintf(f, "; %s Save Settings file\n", PACKAGE_STRING);
1325   fprintf(f, ";\n");
1326   fprintf(f, "; You can edit the values of options that are already set in this file,\n");
1327   fprintf(f, "; but if you add other options, the next Save Settings will not save them.\n");
1328   fprintf(f, "; Use a shortcut, an @indirection file, or a .bat file instead.\n");
1329   fprintf(f, ";\n");
1330
1331   GetWindowCoords();
1332
1333   /* [AS] Move history */
1334   wpMoveHistory.visible = MoveHistoryIsUp();
1335
1336   /* [AS] Eval graph */
1337   wpEvalGraph.visible = EvalGraphIsUp();
1338
1339   /* [AS] Engine output */
1340   wpEngineOutput.visible = EngineOutputIsUp();
1341
1342   // [HGM] in WB we have to copy sound names to appData first
1343   ExportSounds();
1344
1345   for (ad = argDescriptors; ad->argName != NULL; ad++) {
1346     if (!ad->save) continue;
1347     switch (ad->argType) {
1348     case ArgString:
1349       {
1350         char *p = *(char **)ad->argLoc;
1351         if(p == NULL) break; // just in case
1352         if ((strchr(p, '\\') || strchr(p, '\n')) && !strchr(p, '}')) {
1353           /* Quote multiline values or \-containing values
1354              with { } if possible */
1355           fprintf(f, OPTCHAR "%s" SEPCHAR "{%s}\n", ad->argName, p);
1356         } else {
1357           /* Else quote with " " */
1358           fprintf(f, OPTCHAR "%s" SEPCHAR "\"", ad->argName);
1359           while (*p) {
1360             if (*p == '\n') fprintf(f, "\n");
1361             else if (*p == '\r') fprintf(f, "\\r");
1362             else if (*p == '\t') fprintf(f, "\\t");
1363             else if (*p == '\b') fprintf(f, "\\b");
1364             else if (*p == '\f') fprintf(f, "\\f");
1365             else if (*p < ' ') fprintf(f, "\\%03o", *p);
1366             else if (*p == '\"') fprintf(f, "\\\"");
1367             else if (*p == '\\') fprintf(f, "\\\\");
1368             else putc(*p, f);
1369             p++;
1370           }
1371           fprintf(f, "\"\n");
1372         }
1373       }
1374       break;
1375     case ArgInt:
1376     case ArgZ:
1377       fprintf(f, OPTCHAR "%s" SEPCHAR "%d\n", ad->argName, *(int *)ad->argLoc);
1378       break;
1379     case ArgX:
1380       fprintf(f, OPTCHAR "%s" SEPCHAR "%d\n", ad->argName, *(int *)ad->argLoc - wpMain.x); // [HGM] placement: store relative value
1381       break;
1382     case ArgY:
1383       fprintf(f, OPTCHAR "%s" SEPCHAR "%d\n", ad->argName, *(int *)ad->argLoc - wpMain.y);
1384       break;
1385     case ArgFloat:
1386       fprintf(f, OPTCHAR "%s" SEPCHAR "%g\n", ad->argName, *(float *)ad->argLoc);
1387       break;
1388     case ArgBoolean:
1389       fprintf(f, OPTCHAR "%s" SEPCHAR "%s\n", ad->argName,
1390         (*(Boolean *)ad->argLoc) ? "true" : "false");
1391       break;
1392     case ArgTrue:
1393       if (*(Boolean *)ad->argLoc) fprintf(f, OPTCHAR "%s\n", ad->argName);
1394       break;
1395     case ArgFalse:
1396       if (!*(Boolean *)ad->argLoc) fprintf(f, OPTCHAR "%s\n", ad->argName);
1397       break;
1398     case ArgColor:
1399       SaveColor(f, ad);
1400       break;
1401     case ArgAttribs:
1402       SaveAttribsArg(f, ad);
1403       break;
1404     case ArgFilename:
1405       if(*(char**)ad->argLoc == NULL) break; // just in case
1406       if (strchr(*(char **)ad->argLoc, '\"')) {
1407         fprintf(f, OPTCHAR "%s" SEPCHAR "'%s'\n", ad->argName, *(char **)ad->argLoc);
1408       } else {
1409         fprintf(f, OPTCHAR "%s" SEPCHAR "\"%s\"\n", ad->argName, *(char **)ad->argLoc);
1410       }
1411       break;
1412     case ArgBoardSize:
1413       SaveBoardSize(f, ad->argName, ad->argLoc);
1414       break;
1415     case ArgFont:
1416       SaveFontArg(f, ad);
1417       break;
1418     case ArgCommSettings:
1419       PrintCommPortSettings(f, ad->argName);
1420     case ArgNone:
1421     case ArgSettingsFilename: ;
1422     }
1423   }
1424   fclose(f);
1425 }
1426
1427 Boolean
1428 GetArgValue(char *name)
1429 { // retrieve (as text) current value of string or int argument given by name
1430   // (this is used for maing the values available in the adapter command)
1431   ArgDescriptor *ad;
1432   int len;
1433
1434   for (ad = argDescriptors; ad->argName != NULL; ad++)
1435     if (strcmp(ad->argName, name) == 0) break;
1436
1437   if (ad->argName == NULL) return FALSE;
1438
1439   switch(ad->argType) {
1440     case ArgString:
1441     case ArgFilename:
1442       strncpy(name, *(char**) ad->argLoc, MSG_SIZ);
1443
1444       return TRUE;
1445     case ArgInt:
1446       len = snprintf(name, MSG_SIZ, "%d", *(int*) ad->argLoc);
1447       if( (len > MSG_SIZ) && appData.debugMode )
1448         fprintf(debugFP, "GetArgValue: buffer truncated.\n");
1449
1450       return TRUE;
1451     case ArgBoolean:
1452       len = snprintf(name, MSG_SIZ, "%s", *(Boolean*) ad->argLoc ? "true" : "false");
1453       if( (len > MSG_SIZ) && appData.debugMode )
1454         fprintf(debugFP, "GetArgValue: buffer truncated.\n");
1455
1456       return TRUE;
1457     default: ;
1458   }
1459
1460   return FALSE;
1461 }