src/xdefaults.C

   1 /*----------------------------------------------------------------------*
   2  * File:        xdefaults.C
   3  *----------------------------------------------------------------------*
   4  *
   5  * All portions of code are copyright by their respective author/s.
   6  * Copyright (c) 1994      Robert Nation <nation@rocket.sanders.lockheed.com>
   7  *                              - original version
   8  * Copyright (c) 1997,1998 mj olesen <olesen@me.queensu.ca>
   9  * Copyright (c) 2003-2006 Marc Lehmann <pcg@goof.com>
  10  * Copyright (c) 2007      Emanuele Giaquinta <e.giaquinta@glauco.it>
  11  *
  12  * This program is free software; you can redistribute it and/or modify
  13  * it under the terms of the GNU General Public License as published by
  14  * the Free Software Foundation; either version 2 of the License, or
  15  * (at your option) any later version.
  16  *
  17  * This program is distributed in the hope that it will be useful,
  18  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  19  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20  * GNU General Public License for more details.
  21  *
  22  * You should have received a copy of the GNU General Public License
  23  * along with this program; if not, write to the Free Software
  24  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  25  *----------------------------------------------------------------------*/
  26
  27 #include "../config.h"
  28 #include "rxvt.h"
  29 #include "version.h"
  30
  31 #ifdef KEYSYM_RESOURCE
  32 # include "keyboard.h"
  33 #endif
  34
  35 /* place holders used for parsing command-line options */
  36 #define Optflag_Reverse              1
  37 #define Optflag_Boolean              2
  38 #define Optflag_Switch               4
  39
  40 /* monolithic option/resource structure: */
  41 /*
  42  * `string' options MUST have a usage argument
  43  * `switch' and `boolean' options have no argument
  44  * if there's no desc (ription), it won't appear in rxvt_usage ()
  45  */
  46
  47 /* INFO () - descriptive information only */
  48 #define INFO(opt, arg, desc)                                    \
  49     {0, 0, -1, NULL, (opt), (arg), (desc)}
  50
  51 /* STRG () - command-line option, with/without resource */
  52 #define STRG(rsp, kw, opt, arg, desc)                           \
  53     {0, 0, (rsp), (kw), (opt), (arg), (desc)}
  54
  55 /* RSTRG () - resource/long-option */
  56 #define RSTRG(rsp, kw, arg)                                     \
  57     {0, 0, (rsp), (kw), NULL, (arg), NULL}
  58
  59 /* BOOL () - regular boolean `-/+' flag */
  60 #define BOOL(rsp, kw, opt, option, flag, desc)                  \
  61     { (option), (Optflag_Boolean | (flag)), (rsp), (kw), (opt), NULL, (desc)}
  62
  63 /* SWCH () - `-' flag */
  64 #define SWCH(opt, option, flag, desc)                           \
  65     { (option), (Optflag_Switch | (flag)), -1, NULL, (opt), NULL, (desc)}
  66
  67 /* convenient macros */
  68 #define optList_isString(i)                                             \
  69     (optList[i].flag == 0)
  70 #define optList_isBool(i)                                               \
  71     (optList[i].flag & Optflag_Boolean)
  72 #define optList_isReverse(i)                                            \
  73     (optList[i].flag & Optflag_Reverse)
  74 #define optList_size                                                    \
  75     (sizeof (optList) / sizeof (optList[0]))
  76
  77 static const struct
  78   {
  79     const uint8_t   index;      /* Option index */
  80     const uint8_t   flag;       /* Option flag */
  81     const int16_t   doff;       /* resource value index or -1 */
  82     const char     *kw;         /* keyword */
  83     const char     *opt;        /* option */
  84     const char     *arg;        /* argument */
  85     const char     *desc;       /* description */
  86   }
  87 optList[] = {
  88               STRG (Rs_display_name, NULL, "d", NULL, NULL),    /* short form */
  89               STRG (Rs_display_name, NULL, "display", "string", "X server to contact"),
  90               STRG (Rs_term_name, "termName", "tn", "string", "value of the TERM environment variable"),
  91               STRG (Rs_geometry, NULL, "g", NULL, NULL),        /* short form */
  92               STRG (Rs_geometry, "geometry", "geometry", "geometry", "size (in characters) and position"),
  93               SWCH ("C", Opt_console, 0, "intercept console messages"),
  94               SWCH ("iconic", Opt_iconic, 0, "start iconic"),
  95               SWCH ("ic", Opt_iconic, 0, NULL), /* short form */
  96               STRG (Rs_chdir, "chdir", "cd", "string", "start shell in this directory"),
  97               BOOL (Rs_reverseVideo, "reverseVideo", "rv", Opt_reverseVideo, 0, "reverse video"),
  98               BOOL (Rs_loginShell, "loginShell", "ls", Opt_loginShell, 0, "login shell"),
  99               BOOL (Rs_jumpScroll, "jumpScroll", "j", Opt_jumpScroll, 0, "jump scrolling"),
 100               BOOL (Rs_skipScroll, "skipScroll", "ss", Opt_skipScroll, 0, "skip scrolling"),
 101               BOOL (Rs_pastableTabs, "pastableTabs", "ptab", Opt_pastableTabs, 0, "tab characters are pastable"),
 102               RSTRG (Rs_scrollstyle, "scrollstyle", "mode"),
 103               BOOL (Rs_scrollBar, "scrollBar", "sb", Opt_scrollBar, 0, "scrollbar"),
 104               BOOL (Rs_scrollBar_right, "scrollBar_right", "sr", Opt_scrollBar_right, 0, "scrollbar right"),
 105               BOOL (Rs_scrollBar_floating, "scrollBar_floating", "st", Opt_scrollBar_floating, 0, "scrollbar without a trough"),
 106               RSTRG (Rs_scrollBar_align, "scrollBar_align", "mode"),
 107               STRG (Rs_scrollBar_thickness, "thickness", "sbt", "number", "scrollbar thickness/width in pixels"),
 108               BOOL (Rs_scrollTtyOutput, "scrollTtyOutput", NULL, Opt_scrollTtyOutput, 0, NULL),
 109               BOOL (Rs_scrollTtyOutput, NULL, "si",  Opt_scrollTtyOutput, Optflag_Reverse, "scroll-on-tty-output inhibit"),
 110               BOOL (Rs_scrollTtyKeypress, "scrollTtyKeypress", "sk", Opt_scrollTtyKeypress, 0, "scroll-on-keypress"),
 111               BOOL (Rs_scrollWithBuffer, "scrollWithBuffer", "sw", Opt_scrollWithBuffer, 0, "scroll-with-buffer"),
 112 #if ENABLE_TRANSPARENCY
 113               BOOL (Rs_transparent, "inheritPixmap", "ip", Opt_transparent, 0, "inherit parent pixmap"),
 114               BOOL (Rs_transparent, "transparent", "tr", Opt_transparent, 0, "inherit parent pixmap"),
 115               STRG (Rs_color + Color_tint, "tintColor", "tint", "color", "tint color"),
 116               STRG (Rs_shade, "shading", "sh", "number", "shade background by number %."),
 117 #endif
 118 #if OFF_FOCUS_FADING
 119               STRG (Rs_fade, "fading", "fade", "number", "fade colors by number % when losing focus"),
 120               STRG (Rs_color + Color_fade, "fadeColor", "fadecolor", "color", "target color for off-focus fading"),
 121 #endif
 122               BOOL (Rs_utmpInhibit, "utmpInhibit", "ut", Opt_utmpInhibit, 0, "utmp inhibit"),
 123 #ifndef NO_BELL
 124 # if ENABLE_FRILLS
 125               BOOL (Rs_urgentOnBell, "urgentOnBell", NULL, Opt_urgentOnBell, 0, NULL),
 126 # endif
 127               BOOL (Rs_visualBell, "visualBell", "vb", Opt_visualBell, 0, "visual bell"),
 128 # if ! defined(NO_MAPALERT) && defined(MAPALERT_OPTION)
 129               BOOL (Rs_mapAlert, "mapAlert", NULL, Opt_mapAlert, 0, NULL),
 130 # endif
 131 #endif
 132 #ifdef META8_OPTION
 133               BOOL (Rs_meta8, "meta8", NULL, Opt_meta8, 0, NULL),
 134 #endif
 135 #ifdef MOUSE_WHEEL
 136               BOOL (Rs_mouseWheelScrollPage, "mouseWheelScrollPage", NULL, Opt_mouseWheelScrollPage, 0, NULL),
 137 #endif
 138 #if ENABLE_FRILLS
 139               BOOL (Rs_tripleclickwords, "tripleclickwords", "tcw", Opt_tripleclickwords, 0, "triple click word selection"),
 140               BOOL (Rs_insecure, "insecure", "insecure", Opt_insecure, 0, "enable possibly insecure escape sequences"),
 141               BOOL (Rs_cursorUnderline, "cursorUnderline", "uc", Opt_cursorUnderline, 0, "underline cursor"),
 142 #endif
 143 #if CURSOR_BLINK
 144               BOOL (Rs_cursorBlink, "cursorBlink", "bc", Opt_cursorBlink, 0, "blinking cursor"),
 145 #endif
 146 #ifdef POINTER_BLANK
 147               BOOL (Rs_pointerBlank, "pointerBlank", "pb", Opt_pointerBlank, 0, "switch off pointer after delay"),
 148 #endif
 149               STRG (Rs_color + Color_bg, "background", "bg", "color", "background color"),
 150               STRG (Rs_color + Color_fg, "foreground", "fg", "color", "foreground color"),
 151               RSTRG (Rs_color + minCOLOR + 0, "color0", "color"),
 152               RSTRG (Rs_color + minCOLOR + 1, "color1", "color"),
 153               RSTRG (Rs_color + minCOLOR + 2, "color2", "color"),
 154               RSTRG (Rs_color + minCOLOR + 3, "color3", "color"),
 155               RSTRG (Rs_color + minCOLOR + 4, "color4", "color"),
 156               RSTRG (Rs_color + minCOLOR + 5, "color5", "color"),
 157               RSTRG (Rs_color + minCOLOR + 6, "color6", "color"),
 158               RSTRG (Rs_color + minCOLOR + 7, "color7", "color"),
 159               RSTRG (Rs_color + minBrightCOLOR + 0, "color8", "color"),
 160               RSTRG (Rs_color + minBrightCOLOR + 1, "color9", "color"),
 161               RSTRG (Rs_color + minBrightCOLOR + 2, "color10", "color"),
 162               RSTRG (Rs_color + minBrightCOLOR + 3, "color11", "color"),
 163               RSTRG (Rs_color + minBrightCOLOR + 4, "color12", "color"),
 164               RSTRG (Rs_color + minBrightCOLOR + 5, "color13", "color"),
 165               RSTRG (Rs_color + minBrightCOLOR + 6, "color14", "color"),
 166               RSTRG (Rs_color + minBrightCOLOR + 7, "color15", "color"),
 167 #ifndef NO_BOLD_UNDERLINE_REVERSE
 168               RSTRG (Rs_color + Color_BD, "colorBD", "color"),
 169               RSTRG (Rs_color + Color_IT, "colorIT", "color"),
 170               RSTRG (Rs_color + Color_UL, "colorUL", "color"),
 171               RSTRG (Rs_color + Color_RV, "colorRV", "color"),
 172 #endif /* ! NO_BOLD_UNDERLINE_REVERSE */
 173 #if ENABLE_FRILLS
 174               RSTRG (Rs_color + Color_underline, "underlineColor", "color"),
 175 #endif
 176               RSTRG (Rs_color + Color_scroll, "scrollColor", "color"),
 177 #ifdef RXVT_SCROLLBAR
 178               RSTRG (Rs_color + Color_trough, "troughColor", "color"),
 179 #endif
 180 #ifdef OPTION_HC
 181               STRG (Rs_color + Color_HC, "highlightColor", "hc", "color", "highlight color"),
 182 #endif
 183 #ifndef NO_CURSORCOLOR
 184               STRG (Rs_color + Color_cursor, "cursorColor", "cr", "color", "cursor color"),
 185               /* command-line option = resource name */
 186               RSTRG (Rs_color + Color_cursor2, "cursorColor2", "color"),
 187 #endif /* NO_CURSORCOLOR */
 188               STRG (Rs_color + Color_pointer_fg, "pointerColor", "pr", "color", "pointer color"),
 189               STRG (Rs_color + Color_pointer_bg, "pointerColor2", "pr2", "color", "pointer bg color"),
 190               STRG (Rs_color + Color_border, "borderColor", "bd", "color", "border color"),
 191 #ifdef BG_IMAGE_FROM_FILE
 192               RSTRG (Rs_path, "path", "search path"),
 193               STRG (Rs_backgroundPixmap, "backgroundPixmap", "pixmap", "file[;geom]", "background pixmap"),
 194 #endif
 195               /* fonts: command-line option = resource name */
 196               STRG (Rs_font, "font", "fn", "fontname", "normal text font"),
 197 #if ENABLE_STYLES
 198               STRG (Rs_boldFont, "boldFont", "fb", "fontname", "bold font"),
 199               STRG (Rs_italicFont, "italicFont", "fi", "fontname", "italic font"),
 200               STRG (Rs_boldItalicFont, "boldItalicFont", "fbi", "fontname", "bold italic font"),
 201               BOOL (Rs_intensityStyles, "intensityStyles", "is", Opt_intensityStyles, 0, "font styles imply intensity changes"),
 202 #endif
 203 #ifdef USE_XIM
 204               STRG (Rs_inputMethod, "inputMethod", "im", "name", "name of input method"),
 205               STRG (Rs_preeditType, "preeditType", "pt", "style", "input style: style = OverTheSpot|OffTheSpot|Root"),
 206               STRG (Rs_imLocale, "imLocale", "imlocale", "string", "locale to use for input method"),
 207               STRG (Rs_imFont, "imFont", "imfont", "fontname", "fontset for styles OverTheSpot and OffTheSpot"),
 208 #endif /* USE_XIM */
 209               STRG (Rs_name, NULL, "name", "string", "client instance, icon, and title strings"),
 210               STRG (Rs_title, "title", "title", "string", "title name for window"),
 211               STRG (Rs_title, NULL, "T", NULL, NULL),   /* short form */
 212               STRG (Rs_iconName, "iconName", "n", "string", "icon name for window"),
 213               STRG (Rs_saveLines, "saveLines", "sl", "number", "number of scrolled lines to save"),
 214 #if ENABLE_XEMBED
 215               STRG (Rs_embed, NULL, "embed", "windowid", "window id to embed terminal in"),
 216 #endif
 217 #if XFT
 218               STRG (Rs_depth, "depth", "depth", "number", "depth of visual to request"),
 219               BOOL (Rs_buffered, "buffered", NULL, Opt_buffered, 0, NULL),
 220 #endif
 221 #if ENABLE_FRILLS
 222               RSTRG (Rs_transient_for, "transient-for", "windowid"),
 223               BOOL (Rs_override_redirect, "override-redirect", "override-redirect", Opt_override_redirect, 0, "set override-redirect on the terminal window"),
 224               STRG (Rs_pty_fd, NULL, "pty-fd", "fileno", "file descriptor of pty to use"),
 225               BOOL (Rs_hold, "hold", "hold", Opt_hold, 0, "retain window after shell exit"),
 226               STRG (Rs_ext_bwidth, "externalBorder", "w", "number", "external border in pixels"),
 227               STRG (Rs_ext_bwidth, NULL, "bw", NULL, NULL),
 228               STRG (Rs_ext_bwidth, NULL, "borderwidth", NULL, NULL),
 229               STRG (Rs_int_bwidth, "internalBorder", "b", "number", "internal border in pixels"),
 230               BOOL (Rs_borderLess, "borderLess", "bl", Opt_borderLess, 0, "borderless window"),
 231               STRG (Rs_lineSpace, "lineSpace", "lsp", "number", "number of extra pixels between rows"),
 232               STRG (Rs_letterSpace, "letterSpace", "letsp", "number", "letter spacing adjustment"),
 233 #endif
 234 #ifdef BUILTIN_GLYPHS
 235               BOOL (Rs_skipBuiltinGlyphs, "skipBuiltinGlyphs", "sbg", Opt_skipBuiltinGlyphs, 0, "do not use internal glyphs"),
 236 #endif
 237 #ifdef POINTER_BLANK
 238               RSTRG (Rs_pointerBlankDelay, "pointerBlankDelay", "number"),
 239 #endif
 240 #ifndef NO_BACKSPACE_KEY
 241               RSTRG (Rs_backspace_key, "backspacekey", "string"),
 242 #endif
 243 #ifndef NO_DELETE_KEY
 244               RSTRG (Rs_delete_key, "deletekey", "string"),
 245 #endif
 246 #ifdef PRINTPIPE
 247               RSTRG (Rs_print_pipe, "print-pipe", "string"),
 248 #endif
 249               STRG (Rs_modifier, "modifier", "mod", "modifier", "meta modifier = alt|meta|hyper|super|mod1|...|mod5"),
 250               RSTRG (Rs_cutchars, "cutchars", "string"),
 251               RSTRG (Rs_answerbackstring, "answerbackString", "string"),
 252 #ifndef NO_SECONDARY_SCREEN
 253               BOOL (Rs_secondaryScreen, "secondaryScreen", "ssc", Opt_secondaryScreen, 0, "enable secondary screen"),
 254               BOOL (Rs_secondaryScroll, "secondaryScroll", "ssr", Opt_secondaryScroll, 0, "enable secondary screen scroll"),
 255 #endif
 256 #if ENABLE_PERL
 257               RSTRG (Rs_perl_lib, "perl-lib", "string"), //, "colon-separated directories with extension scripts"),TODO
 258               RSTRG (Rs_perl_eval, "perl-eval", "perl-eval"), // "string", "code to be evaluated after all extensions have been loaded"),TODO
 259               RSTRG (Rs_perl_ext_1, "perl-ext-common", "string"), //, "colon-separated list of perl extensions to enable"),TODO
 260               STRG (Rs_perl_ext_2, "perl-ext", "pe", "string", "colon-separated list of perl extensions to enable for this instance"),
 261 #endif
 262 #if ISO_14755
 263               BOOL (Rs_iso14755, "iso14755", NULL, Opt_iso14755, 0, NULL),
 264               BOOL (Rs_iso14755_52, "iso14755_52", NULL, Opt_iso14755_52, 0, NULL),
 265 #endif
 266 #ifdef HAVE_AFTERIMAGE
 267               STRG (Rs_blendtype, "blendType", "blt", "string", "background image blending type - alpha, tint, etc..."),
 268               STRG (Rs_blurradius, "blurRadius", "blr", "HxV", "gaussian blur radii to apply to the root background"),
 269 # if ENABLE_EWMH
 270               STRG (Rs_iconfile, "iconFile", "icon", "file", "path to application icon image"),
 271 # endif
 272 #endif
 273               INFO ("e", "command arg ...", "command to execute")
 274             };
 275
 276 #undef INFO
 277 #undef STRG
 278 #undef RSTRG
 279 #undef SWCH
 280 #undef BOOL
 281
 282 static const char releasestring[] = "rxvt-unicode (" RXVTNAME ") v" VERSION " - released: " DATE "\n";
 283 static const char optionsstring[] = "options: "
 284 #if ENABLE_PERL
 285                                     "perl,"
 286 #endif
 287 #if XFT
 288                                     "xft,"
 289 #endif
 290 #if ENABLE_STYLES
 291                                     "styles,"
 292 #endif
 293 #if ENABLE_COMBINING
 294                                     "combining,"
 295 #endif
 296 #if TEXT_BLINK
 297                                     "blink,"
 298 #endif
 299 #if ISO_14755
 300                                     "iso14755,"
 301 #endif
 302 #if UNICODE_3
 303                                     "unicode3,"
 304 #endif
 305                                     "encodings=eu+vn"
 306 #if ENCODING_JP
 307                                     "+jp"
 308 #endif
 309 #if ENCODING_JP_EXT
 310                                     "+jp-ext"
 311 #endif
 312 #if ENCODING_KR
 313                                     "+kr"
 314 #endif
 315 #if ENCODING_ZH
 316                                     "+zh"
 317 #endif
 318 #if ENCODING_ZH_EXT
 319                                     "+zh-ext"
 320 #endif
 321                                     ","
 322 #if OFF_FOCUS_FADING
 323                                     "fade,"
 324 #endif
 325 #if defined(ENABLE_TRANSPARENCY)
 326                                     "transparent,"
 327                                     "tint,"
 328 #endif
 329 #if HAVE_AFTERIMAGE
 330                                     "afterimage,"
 331 #endif
 332 #if defined(USE_XIM)
 333                                     "XIM,"
 334 #endif
 335 #if defined(NO_BACKSPACE_KEY)
 336                                     "no_backspace,"
 337 #endif
 338 #if defined(NO_DELETE_KEY)
 339                                     "no_delete,"
 340 #endif
 341 #if EIGHT_BIT_CONTROLS
 342                                     "8bitctrls,"
 343 #endif
 344 #if defined(ENABLE_FRILLS)
 345                                     "frills,"
 346 #endif
 347 #if defined(SELECTION_SCROLLING)
 348                                     "selectionscrolling,"
 349 #endif
 350 #if MOUSE_WHEEL
 351                                     "wheel,"
 352 #endif
 353 #if MOUSE_SLIP_WHEELING
 354                                     "slipwheel,"
 355 #endif
 356 #if defined(SMART_RESIZE)
 357                                     "smart-resize,"
 358 #endif
 359 #if defined(CURSOR_BLINK)
 360                                     "cursorBlink,"
 361 #endif
 362 #if defined(POINTER_BLANK)
 363                                     "pointerBlank,"
 364 #endif
 365 #if defined(NO_RESOURCES)
 366                                     "NoResources,"
 367 #endif
 368                                     "scrollbars=plain"
 369 #if defined(RXVT_SCROLLBAR)
 370                                     "+rxvt"
 371 #endif
 372 #if defined(NEXT_SCROLLBAR)
 373                                     "+NeXT"
 374 #endif
 375 #if defined(XTERM_SCROLLBAR)
 376                                     "+xterm"
 377 #endif
 378                                     "\nUsage: ";                /* Usage */
 379
 380 #define INDENT 18
 381
 382 const char rxvt_term::resval_undef [] = "<undef>";
 383 const char rxvt_term::resval_on []    = "on";
 384 const char rxvt_term::resval_off []   = "off";
 385
 386 /*{{{ usage: */
 387 /*----------------------------------------------------------------------*/
 388 static void
 389 rxvt_usage (int type)
 390 {
 391   unsigned int i, col;
 392
 393   rxvt_log ("%s%s%s", releasestring, optionsstring, RESNAME);
 394
 395   switch (type)
 396     {
 397       case 0:                   /* brief listing */
 398         rxvt_log (" [-help] [--help]\n");
 399
 400         for (col = 1, i = 0; i < optList_size; i++)
 401           if (optList[i].desc != NULL)
 402             {
 403               int len = 0;
 404
 405               if (optList[i].arg)
 406                 len = strlen (optList[i].arg) + 1;
 407               assert (optList[i].opt != NULL);
 408               len += 4 + strlen (optList[i].opt) + (optList_isBool (i) ? 2: 0);
 409               col += len;
 410               if (col > 79)
 411                 {
 412                   /* assume regular width */
 413                   rxvt_log ("\n");
 414                   col = 1 + len;
 415                 }
 416
 417               rxvt_log (" [-%s%s", (optList_isBool (i) ? "/+" : ""), optList[i].opt);
 418               if (optList[i].arg)
 419                 rxvt_log (" %s]", optList[i].arg);
 420               else
 421                 rxvt_log ("]");
 422             }
 423         break;
 424
 425       case 1:                   /* full command-line listing */
 426         rxvt_log (" [options] [-e command args]\n\nwhere options include:\n");
 427
 428         for (i = 0; i < optList_size; i++)
 429           if (optList[i].desc != NULL)
 430             {
 431               assert (optList[i].opt != NULL);
 432               rxvt_log ("  %s%s %-*s%s%s\n",
 433                          (optList_isBool (i) ? "-/+" : "-"), optList[i].opt,
 434                          (INDENT - strlen (optList[i].opt)
 435                           + (optList_isBool (i) ? 0 : 2)),
 436                          (optList[i].arg ? optList[i].arg : ""),
 437                          (optList_isBool (i) ? "turn on/off " : ""),
 438                          optList[i].desc);
 439             }
 440         rxvt_log ("\n  --help to list long-options");
 441         break;
 442
 443       case 2:                   /* full resource listing */
 444         rxvt_log (" [options] [-e command args]\n\n"
 445                    "where resources (long-options) include:\n");
 446
 447         for (i = 0; i < optList_size; i++)
 448           if (optList[i].kw != NULL)
 449             rxvt_log ("  %s: %*s%s\n",
 450                     optList[i].kw,
 451                     (INDENT - strlen (optList[i].kw)), "", /* XXX */
 452                     (optList_isBool (i) ? "boolean" : optList[i].arg));
 453 #ifdef KEYSYM_RESOURCE
 454         rxvt_log ("  " "keysym.sym" ": %*s%s\n",
 455                 (INDENT - sizeof ("keysym.sym") + 1), "", /* XXX */
 456                 "keysym");
 457 #endif
 458         rxvt_log ("\n  -help to list options");
 459         break;
 460     }
 461
 462   rxvt_log ("\n\n");
 463   rxvt_exit_failure ();
 464   /* NOTREACHED */
 465 }
 466
 467 /*}}} */
 468
 469 /*{{{ get command-line options before getting resources */
 470 void
 471 rxvt_term::get_options (int argc, const char *const *argv)
 472 {
 473   int i, bad_option = 0;
 474
 475   for (i = 1; i < argc; i++)
 476     {
 477       unsigned int entry, longopt = 0;
 478       const char *opt;
 479       int flag;
 480
 481       opt = argv[i];
 482
 483       if (*opt == '-')
 484         {
 485           flag = 1;
 486
 487           if (*++opt == '-')
 488             longopt = *opt++;   /* long option */
 489         }
 490       else if (*opt == '+')
 491         {
 492           flag = 0;
 493
 494           if (*++opt == '+')
 495             longopt = *opt++;   /* long option */
 496         }
 497       else
 498         {
 499           bad_option = 1;
 500           rxvt_warn ("\"%s\": malformed option.\n", opt);
 501           continue;
 502         }
 503
 504       if (!strcmp (opt, "help"))
 505         rxvt_usage (longopt ? 2 : 1);
 506
 507       if (!strcmp (opt, "h"))
 508         rxvt_usage (0);
 509
 510       /* feature: always try to match long-options */
 511       for (entry = 0; entry < optList_size; entry++)
 512         if ((optList[entry].kw && !strcmp (opt, optList[entry].kw))
 513             || (!longopt
 514                 && optList[entry].opt && !strcmp (opt, optList[entry].opt)))
 515           break;
 516
 517       if (entry < optList_size)
 518         {
 519           if (optList_isReverse (entry))
 520             flag = !flag;
 521
 522           if (optList_isString (entry))
 523             {
 524               /*
 525                * special cases are handled in main.c:main () to allow
 526                * X resources to set these values before we settle for
 527                * default values
 528                */
 529
 530               if (optList[entry].doff != -1)
 531                 {
 532                   if (flag && i+1 == argc)
 533                     rxvt_fatal ("option '%s' requires an argument, aborting.\n", argv [i]);
 534
 535                   rs[optList[entry].doff] = flag ? argv[++i] : resval_undef;
 536                 }
 537             }
 538           else
 539             {
 540               /* boolean value */
 541               set_option (optList[entry].index, flag);
 542
 543               if (optList[entry].doff != -1)
 544                 rs[optList[entry].doff] = flag ? resval_on : resval_off;
 545             }
 546         }
 547 #ifndef NO_RESOURCES
 548       else if (!strcmp (opt, "xrm"))
 549         {
 550           if (i+1 < argc)
 551             XrmPutLineResource (&option_db, argv[++i]);
 552         }
 553 #endif
 554 #ifdef KEYSYM_RESOURCE
 555       else if (!strncmp (opt, "keysym.", sizeof ("keysym.") - 1))
 556         {
 557           if (i+1 < argc)
 558             {
 559               char *res = (char *)malloc (strlen (opt) + strlen (argv[++i]) + 6);
 560               sprintf (res, "*.%s: %s\n", opt, argv[i]);
 561               XrmPutLineResource (&option_db, res);
 562               free (res);
 563             }
 564         }
 565 #endif
 566       else
 567         {
 568           bad_option = 1;
 569           rxvt_warn ("\"%s\": unknown or malformed option.\n", opt);
 570         }
 571     }
 572
 573   if (bad_option)
 574     rxvt_usage (0);
 575 }
 576
 577 /*}}} */
 578
 579 #ifndef NO_RESOURCES
 580 /*----------------------------------------------------------------------*/
 581
 582 # ifdef KEYSYM_RESOURCE
 583 /*
 584  * Define key from XrmEnumerateDatabase.
 585  *   quarks will be something like
 586  *      "rxvt" "keysym" "0xFF01"
 587  *   value will be a string
 588  */
 589 /* ARGSUSED */
 590 int
 591 rxvt_define_key (XrmDatabase *database UNUSED,
 592                  XrmBindingList bindings UNUSED,
 593                  XrmQuarkList quarks,
 594                  XrmRepresentation *type UNUSED,
 595                  XrmValue *value,
 596                  XPointer closure UNUSED)
 597 {
 598   int last;
 599
 600   for (last = 0; quarks[last] != NULLQUARK; last++)     /* look for last quark in list */
 601     ;
 602
 603   last--;
 604   GET_R->parse_keysym (XrmQuarkToString (quarks[last]), (char *)value->addr);//D//TODO
 605   return False;
 606 }
 607
 608 /*
 609  * look for something like this (XK_Delete)
 610  * rxvt*keysym.0xFFFF: "\177"
 611  */
 612
 613 struct keysym_vocabulary_t
 614 {
 615   const char    *name;
 616   unsigned short len;
 617   unsigned short value;
 618 };
 619 static const keysym_vocabulary_t keysym_vocabulary[] =
 620 {
 621   { "ISOLevel3", 9, Level3Mask    },
 622   { "AppKeypad", 9, AppKeypadMask },
 623   { "Control",   7, ControlMask   },
 624   { "NumLock",   7, NumLockMask   },
 625   { "Shift",     5, ShiftMask     },
 626   { "Meta",      4, MetaMask      },
 627   { "Lock",      4, LockMask      },
 628   { "Mod1",      4, Mod1Mask      },
 629   { "Mod2",      4, Mod2Mask      },
 630   { "Mod3",      4, Mod3Mask      },
 631   { "Mod4",      4, Mod4Mask      },
 632   { "Mod5",      4, Mod5Mask      },
 633   { "I",         1, Level3Mask    },
 634   { "K",         1, AppKeypadMask },
 635   { "C",         1, ControlMask   },
 636   { "N",         1, NumLockMask   },
 637   { "S",         1, ShiftMask     },
 638   { "M",         1, MetaMask      },
 639   { "A",         1, MetaMask      },
 640   { "L",         1, LockMask      },
 641   { "1",         1, Mod1Mask      },
 642   { "2",         1, Mod2Mask      },
 643   { "3",         1, Mod3Mask      },
 644   { "4",         1, Mod4Mask      },
 645   { "5",         1, Mod5Mask      },
 646 };
 647
 648 int
 649 rxvt_term::parse_keysym (const char *str, const char *arg)
 650 {
 651   int sym;
 652   unsigned int state = 0;
 653   const char *key = strrchr (str, '-');
 654
 655   if (!key)
 656     key = str;
 657   else
 658     key++;
 659
 660   // string or key is empty
 661   if (*arg == '\0' || *key == '\0')
 662     return -1;
 663
 664   // parse modifiers
 665   while (str < key)
 666     {
 667       unsigned int i;
 668
 669       for (i=0; i < sizeof (keysym_vocabulary) / sizeof (keysym_vocabulary_t); ++i)
 670         {
 671           if (strncmp (str, keysym_vocabulary [i].name, keysym_vocabulary [i].len) == 0)
 672             {
 673               state |= keysym_vocabulary[i].value;
 674               str += keysym_vocabulary[i].len;
 675               break;
 676             }
 677         }
 678
 679       if (i >= sizeof (keysym_vocabulary) / sizeof (keysym_vocabulary_t))
 680         return -1;
 681
 682       if (*str == '-')
 683         ++str;
 684     }
 685
 686   // convert keysym name to keysym number
 687   if ((sym = XStringToKeysym (str)) == None)
 688     {
 689       // fallback on hexadecimal parsing
 690       char *end;
 691       sym = strtol (str, &end, 16);
 692       if (*end)
 693         return -1;
 694     }
 695
 696   keyboard->register_user_translation (sym, state, arg);
 697   return 1;
 698 }
 699
 700 # endif /* KEYSYM_RESOURCE */
 701 #endif /* NO_RESOURCES */
 702
 703 static char *
 704 get_res (XrmDatabase database, const char *program, const char *option)
 705 {
 706   char resource[512];
 707   char *type;
 708   XrmValue result;
 709
 710   snprintf (resource, sizeof (resource), "%s.%s", program, option);
 711   XrmGetResource (database, resource, resource, &type, &result);
 712
 713   return result.addr;
 714 }
 715
 716 const char *
 717 rxvt_term::x_resource (const char *name)
 718 {
 719   XrmDatabase database = XrmGetDatabase (dpy);
 720
 721   const char *p = get_res (database, rs[Rs_name], name);
 722   const char *p0 = get_res (database, "!INVALIDPROGRAMMENAMEDONTMATCH!", name);
 723
 724   if (p == NULL || (p0 && strcmp (p, p0) == 0))
 725     {
 726       p = get_res (database, RESCLASS, name);
 727 #ifdef RESFALLBACK
 728       if (p == NULL || (p0 && strcmp (p, p0) == 0))
 729         p = get_res (database, RESFALLBACK, name);
 730 #endif
 731     }
 732
 733   if (p == NULL && p0)
 734     p = p0;
 735
 736   return p;
 737 }
 738
 739 void
 740 rxvt_term::extract_resources ()
 741 {
 742 #ifndef NO_RESOURCES
 743   XrmDatabase database = XrmGetDatabase (dpy);
 744   XrmMergeDatabases (option_db, &database);
 745   option_db = NULL;
 746   /*
 747    * Query resources for options that affect us
 748    */
 749   for (int entry = 0; entry < optList_size; entry++)
 750     {
 751       int s;
 752       const char *kw = optList[entry].kw;
 753
 754       if (kw == NULL || rs[optList[entry].doff] != NULL)
 755         continue; // previously set
 756
 757       const char *p = x_resource (kw);
 758
 759       if (p)
 760         {
 761           p = strdup (p);
 762           allocated.push_back ((void *)p);
 763           rs[optList[entry].doff] = p;
 764
 765           if (optList_isBool (entry))
 766             {
 767               s = strcasecmp (p, "TRUE") == 0
 768                   || strcasecmp (p, "YES") == 0
 769                   || strcasecmp (p, "ON") == 0
 770                   || strcasecmp (p, "1") == 0;
 771
 772               if (optList_isReverse (entry))
 773                 s = !s;
 774
 775               set_option (optList[entry].index, s);
 776             }
 777         }
 778     }
 779
 780   /*
 781    * [R5 or later]: enumerate the resource database
 782    */
 783 #  ifdef KEYSYM_RESOURCE
 784   XrmName name_prefix[3];
 785   XrmClass class_prefix[3];
 786
 787   name_prefix[0] = XrmStringToName (rs[Rs_name]);
 788   name_prefix[1] = XrmStringToName ("keysym");
 789   name_prefix[2] = NULLQUARK;
 790   class_prefix[0] = XrmStringToName (RESCLASS);
 791   class_prefix[1] = XrmStringToName ("Keysym");
 792   class_prefix[2] = NULLQUARK;
 793   /* XXX: Need to check sizeof (rxvt_t) == sizeof (XPointer) */
 794   XrmEnumerateDatabase (database, name_prefix, class_prefix,
 795                         XrmEnumOneLevel, rxvt_define_key, NULL);
 796 #   ifdef RESFALLBACK
 797   name_prefix[0] = XrmStringToName (RESFALLBACK);
 798   name_prefix[1] = XrmStringToName ("keysym");
 799   class_prefix[0] = XrmStringToName (RESFALLBACK);
 800   class_prefix[1] = XrmStringToName ("Keysym");
 801   /* XXX: Need to check sizeof (rxvt_t) == sizeof (XPointer) */
 802   XrmEnumerateDatabase (database, name_prefix, class_prefix,
 803                         XrmEnumOneLevel, rxvt_define_key, NULL);
 804 #   endif
 805 #  endif
 806
 807 #endif /* NO_RESOURCES */
 808 }
 809
 810 /*----------------------- end-of-file (C source) -----------------------*/