ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/xdefaults.C
Revision: 1.200
Committed: Fri Dec 23 21:46:46 2022 UTC (16 months, 2 weeks ago) by root
Content type: text/plain
Branch: MAIN
CVS Tags: HEAD
Changes since 1.199: +1 -0 lines
Log Message:
*** empty log message ***

File Contents

# Content
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 <schmorp@schmorp.de>
10 * Copyright (c) 2007,2015 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 3 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 #define Optflag_Info 8
40
41 /* monolithic option/resource structure: */
42 /*
43 * `string' options MUST have a usage argument
44 * `switch' and `boolean' options have no argument
45 * if there's no desc (ription), it won't appear in rxvt_usage ()
46 */
47
48 /* INFO () - descriptive information only */
49 #define INFO(opt, arg, desc) \
50 {0, Optflag_Info, -1, NULL, (opt), (arg), (desc)}
51
52 #define RINFO(kw, arg) \
53 {0, Optflag_Info, -1, (kw), NULL, (arg), NULL}
54
55 /* STRG () - command-line option, with/without resource */
56 #define STRG(rsp, kw, opt, arg, desc) \
57 {0, 0, (rsp), (kw), (opt), (arg), (desc)}
58
59 /* RSTRG () - resource/long-option */
60 #define RSTRG(rsp, kw, arg) \
61 {0, 0, (rsp), (kw), NULL, (arg), NULL}
62
63 /* BOOL () - regular boolean `-/+' flag */
64 #define BOOL(rsp, kw, opt, option, flag, desc) \
65 { (option), (Optflag_Boolean | (flag)), (rsp), (kw), (opt), NULL, (desc)}
66
67 /* SWCH () - `-' flag */
68 #define SWCH(opt, option, flag, desc) \
69 { (option), (Optflag_Switch | (flag)), -1, NULL, (opt), NULL, (desc)}
70
71 /* convenient macros */
72 #define optList_isString(i) \
73 (optList[i].flag == 0)
74 #define optList_isBool(i) \
75 (optList[i].flag & Optflag_Boolean)
76 #define optList_isReverse(i) \
77 (optList[i].flag & Optflag_Reverse)
78 #define optList_isInfo(i) \
79 (optList[i].flag & Optflag_Info)
80
81 static const struct
82 {
83 const uint8_t index; /* Option index */
84 const uint8_t flag; /* Option flag */
85 const int16_t doff; /* resource value index or -1 */
86 const char *kw; /* keyword */
87 const char *opt; /* option */
88 const char *arg; /* argument */
89 const char *desc; /* description */
90 }
91 optList[] = {
92 STRG (Rs_display_name, NULL, "d", NULL, NULL), /* short form */
93 STRG (Rs_display_name, NULL, "display", "string", "X server to contact"),
94 STRG (Rs_term_name, "termName", "tn", "string", "value of the TERM environment variable"),
95 STRG (Rs_geometry, NULL, "g", NULL, NULL), /* short form */
96 STRG (Rs_geometry, "geometry", "geometry", "geometry", "size (in characters) and position"),
97 SWCH ("C", Opt_console, 0, "intercept console messages"),
98 SWCH ("iconic", Opt_iconic, 0, "start iconic"),
99 SWCH ("ic", Opt_iconic, 0, NULL), /* short form */
100 STRG (Rs_chdir, "chdir", "cd", "string", "start shell in this directory"),
101 SWCH ("dockapp", Opt_dockapp, 0, "start as dockapp"),
102 BOOL (Rs_reverseVideo, "reverseVideo", "rv", Opt_reverseVideo, 0, "reverse video"),
103 BOOL (Rs_loginShell, "loginShell", "ls", Opt_loginShell, 0, "login shell"),
104 STRG (Rs_multiClickTime, "multiClickTime", "mc", "number", "maximum time (in ms) between multi-click selections"),
105 BOOL (Rs_jumpScroll, "jumpScroll", "j", Opt_jumpScroll, 0, "jump scrolling"),
106 BOOL (Rs_skipScroll, "skipScroll", "ss", Opt_skipScroll, 0, "skip scrolling"),
107 BOOL (Rs_pastableTabs, "pastableTabs", "ptab", Opt_pastableTabs, 0, "tab characters are pastable"),
108 RSTRG (Rs_scrollstyle, "scrollstyle", "mode"),
109 BOOL (Rs_scrollBar, "scrollBar", "sb", Opt_scrollBar, 0, "scrollbar"),
110 BOOL (Rs_scrollBar_right, "scrollBar_right", "sr", Opt_scrollBar_right, 0, "scrollbar right"),
111 BOOL (Rs_scrollBar_floating, "scrollBar_floating", "st", Opt_scrollBar_floating, 0, "scrollbar without a trough"),
112 RSTRG (Rs_scrollBar_align, "scrollBar_align", "mode"),
113 STRG (Rs_scrollBar_thickness, "thickness", "sbt", "number", "scrollbar thickness/width in pixels"),
114 BOOL (Rs_scrollTtyOutput, "scrollTtyOutput", NULL, Opt_scrollTtyOutput, 0, NULL),
115 BOOL (Rs_scrollTtyOutput, NULL, "si", Opt_scrollTtyOutput, Optflag_Reverse, "scroll-on-tty-output inhibit"),
116 BOOL (Rs_scrollTtyKeypress, "scrollTtyKeypress", "sk", Opt_scrollTtyKeypress, 0, "scroll-on-keypress"),
117 BOOL (Rs_scrollWithBuffer, "scrollWithBuffer", "sw", Opt_scrollWithBuffer, 0, "scroll-with-buffer"),
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_disablePasteBrackets, "disablePasteBrackets", "dpb", Opt_disablePasteBrackets, 0, "paste bracket suppression"),
140 BOOL (Rs_tripleclickwords, "tripleclickwords", "tcw", Opt_tripleclickwords, 0, "triple click word selection"),
141 BOOL (Rs_insecure, "insecure", "insecure", Opt_insecure, 0, "enable possibly insecure escape sequences"),
142 BOOL (Rs_cursorUnderline, "cursorUnderline", "uc", Opt_cursorUnderline, 0, "underline cursor"),
143 #endif
144 #if CURSOR_BLINK
145 BOOL (Rs_cursorBlink, "cursorBlink", "bc", Opt_cursorBlink, 0, "blinking cursor"),
146 #endif
147 #ifdef POINTER_BLANK
148 BOOL (Rs_pointerBlank, "pointerBlank", "pb", Opt_pointerBlank, 0, "switch off pointer after delay"),
149 #endif
150 STRG (Rs_color + Color_bg, "background", "bg", "color", "background color"),
151 STRG (Rs_color + Color_fg, "foreground", "fg", "color", "foreground color"),
152 RSTRG (Rs_color + minCOLOR + 0, "color0", "color"),
153 RSTRG (Rs_color + minCOLOR + 1, "color1", "color"),
154 RSTRG (Rs_color + minCOLOR + 2, "color2", "color"),
155 RSTRG (Rs_color + minCOLOR + 3, "color3", "color"),
156 RSTRG (Rs_color + minCOLOR + 4, "color4", "color"),
157 RSTRG (Rs_color + minCOLOR + 5, "color5", "color"),
158 RSTRG (Rs_color + minCOLOR + 6, "color6", "color"),
159 RSTRG (Rs_color + minCOLOR + 7, "color7", "color"),
160 RSTRG (Rs_color + minBrightCOLOR + 0, "color8", "color"),
161 RSTRG (Rs_color + minBrightCOLOR + 1, "color9", "color"),
162 RSTRG (Rs_color + minBrightCOLOR + 2, "color10", "color"),
163 RSTRG (Rs_color + minBrightCOLOR + 3, "color11", "color"),
164 RSTRG (Rs_color + minBrightCOLOR + 4, "color12", "color"),
165 RSTRG (Rs_color + minBrightCOLOR + 5, "color13", "color"),
166 RSTRG (Rs_color + minBrightCOLOR + 6, "color14", "color"),
167 RSTRG (Rs_color + minBrightCOLOR + 7, "color15", "color"),
168 #ifndef NO_BOLD_UNDERLINE_REVERSE
169 RSTRG (Rs_color + Color_BD, "colorBD", "color"),
170 RSTRG (Rs_color + Color_IT, "colorIT", "color"),
171 RSTRG (Rs_color + Color_UL, "colorUL", "color"),
172 RSTRG (Rs_color + Color_RV, "colorRV", "color"),
173 #endif /* ! NO_BOLD_UNDERLINE_REVERSE */
174 #if ENABLE_FRILLS
175 RSTRG (Rs_color + Color_underline, "underlineColor", "color"),
176 #endif
177 RSTRG (Rs_color + Color_scroll, "scrollColor", "color"),
178 #ifdef RXVT_SCROLLBAR
179 RSTRG (Rs_color + Color_trough, "troughColor", "color"),
180 #endif
181 #ifdef OPTION_HC
182 STRG (Rs_color + Color_HC, "highlightColor", "hc", "color", "highlight color"),
183 RSTRG (Rs_color + Color_HTC, "highlightTextColor", "color"),
184 #endif
185 #ifndef NO_CURSORCOLOR
186 STRG (Rs_color + Color_cursor, "cursorColor", "cr", "color", "cursor color"),
187 /* command-line option = resource name */
188 RSTRG (Rs_color + Color_cursor2, "cursorColor2", "color"),
189 #endif /* NO_CURSORCOLOR */
190 STRG (Rs_color + Color_pointer_fg, "pointerColor", "pr", "color", "pointer color"),
191 STRG (Rs_color + Color_pointer_bg, "pointerColor2", "pr2", "color", "pointer bg color"),
192 STRG (Rs_color + Color_border, "borderColor", "bd", "color", "border color"),
193 #if ENABLE_EWMH
194 STRG (Rs_iconfile, "iconFile", "icon", "file", "path to application icon image"),
195 #endif
196 #ifdef HAVE_XMU
197 RSTRG (Rs_pointerShape, "pointerShape", "string"),
198 #endif
199 /* fonts: command-line option = resource name */
200 STRG (Rs_font, "font", "fn", "fontname", "normal text font"),
201 #if ENABLE_STYLES
202 STRG (Rs_boldFont, "boldFont", "fb", "fontname", "bold font"),
203 STRG (Rs_italicFont, "italicFont", "fi", "fontname", "italic font"),
204 STRG (Rs_boldItalicFont, "boldItalicFont", "fbi", "fontname", "bold italic font"),
205 BOOL (Rs_intensityStyles, "intensityStyles", "is", Opt_intensityStyles, 0, "font styles imply intensity changes"),
206 #endif
207 #if USE_XIM
208 STRG (Rs_inputMethod, "inputMethod", "im", "name", "name of input method"),
209 STRG (Rs_preeditType, "preeditType", "pt", "style", "input style: style = OverTheSpot|OffTheSpot|Root"),
210 STRG (Rs_imLocale, "imLocale", "imlocale", "string", "locale to use for input method"),
211 STRG (Rs_imFont, "imFont", "imfont", "fontname", "fontset for styles OverTheSpot and OffTheSpot"),
212 #endif /* USE_XIM */
213 STRG (Rs_name, NULL, "name", "string", "client instance, icon, and title strings"),
214 STRG (Rs_title, "title", "title", "string", "title name for window"),
215 STRG (Rs_title, NULL, "T", NULL, NULL), /* short form */
216 STRG (Rs_iconName, "iconName", "n", "string", "icon name for window"),
217 STRG (Rs_saveLines, "saveLines", "sl", "number", "number of scrolled lines to save"),
218 #if ENABLE_XEMBED
219 STRG (Rs_embed, NULL, "embed", "windowid", "window id to embed terminal in"),
220 #endif
221 #if XFT
222 BOOL (Rs_buffered, "buffered", NULL, Opt_buffered, 0, NULL),
223 #endif
224 #if ENABLE_FRILLS
225 STRG (Rs_refreshRate, "refreshRate", "fps", "number", "refresh rate / frames per second"),
226 STRG (Rs_depth, "depth", "depth", "number", "depth of visual to request"),
227 STRG (Rs_visual, "visual", "visual", "number", "visual id to request"),
228 RSTRG (Rs_transient_for, "transient-for", "windowid"),
229 BOOL (Rs_override_redirect, "override-redirect", "override-redirect", Opt_override_redirect, 0, "override-redirect on the terminal window"),
230 STRG (Rs_pty_fd, NULL, "pty-fd", "fileno", "file descriptor of pty to use"),
231 BOOL (Rs_hold, "hold", "hold", Opt_hold, 0, "retain window after shell exit"),
232 STRG (Rs_ext_bwidth, "externalBorder", "w", "number", "external border in pixels"),
233 STRG (Rs_ext_bwidth, NULL, "bw", NULL, NULL),
234 STRG (Rs_ext_bwidth, NULL, "borderwidth", NULL, NULL),
235 STRG (Rs_int_bwidth, "internalBorder", "b", "number", "internal border in pixels"),
236 BOOL (Rs_borderLess, "borderLess", "bl", Opt_borderLess, 0, "borderless window"),
237 STRG (Rs_lineSpace, "lineSpace", "lsp", "number", "number of extra pixels between rows"),
238 STRG (Rs_letterSpace, "letterSpace", "letsp", "number", "letter spacing adjustment"),
239 #endif
240 #ifdef BUILTIN_GLYPHS
241 BOOL (Rs_skipBuiltinGlyphs, "skipBuiltinGlyphs", "sbg", Opt_skipBuiltinGlyphs, 0, "use of font glyphs instead of internal glyphs"),
242 #endif
243 #ifdef POINTER_BLANK
244 RSTRG (Rs_pointerBlankDelay, "pointerBlankDelay", "number"),
245 #endif
246 #ifndef NO_BACKSPACE_KEY
247 RSTRG (Rs_backspace_key, "backspacekey", "string"),
248 #endif
249 #ifndef NO_DELETE_KEY
250 RSTRG (Rs_delete_key, "deletekey", "string"),
251 #endif
252 #ifdef PRINTPIPE
253 RSTRG (Rs_print_pipe, "print-pipe", "string"),
254 #endif
255 STRG (Rs_modifier, "modifier", "mod", "modifier", "meta modifier = alt|meta|hyper|super|mod1|...|mod5"),
256 RSTRG (Rs_cutchars, "cutchars", "string"),
257 RSTRG (Rs_answerbackstring, "answerbackString", "string"),
258 #ifndef NO_SECONDARY_SCREEN
259 BOOL (Rs_secondaryScreen, "secondaryScreen", "ssc", Opt_secondaryScreen, 0, "secondary screen"),
260 BOOL (Rs_secondaryScroll, "secondaryScroll", "ssr", Opt_secondaryScroll, 0, "secondary screen scroll"),
261 #endif
262 #if ENABLE_FRILLS
263 STRG (Rs_rewrapMode, "rewrapMode", "rm", "string", "rewrap mode (auto, always, never)"),
264 #endif
265 #if ENABLE_PERL
266 RSTRG (Rs_perl_lib, "perl-lib", "string"), //, "colon-separated directories with extension scripts"),TODO
267 RSTRG (Rs_perl_eval, "perl-eval", "perl-eval"), // "string", "code to be evaluated after all extensions have been loaded"),TODO
268 RSTRG (Rs_perl_ext_1, "perl-ext-common", "string"), //, "colon-separated list of perl extensions to enable"),TODO
269 STRG (Rs_perl_ext_2, "perl-ext", "pe", "string", "colon-separated list of perl extensions to enable for this instance"),
270 #endif
271 #if ISO_14755
272 BOOL (Rs_iso14755, "iso14755", NULL, Opt_iso14755, 0, NULL),
273 BOOL (Rs_iso14755_52, "iso14755_52", NULL, Opt_iso14755_52, 0, NULL),
274 #endif
275 #ifndef NO_RESOURCES
276 RINFO ("xrm", "string"),
277 #endif
278 #ifdef KEYSYM_RESOURCE
279 RINFO ("keysym.sym", "keysym"),
280 #endif
281 INFO ("e", "command arg ...", "command to execute")
282 };
283
284 #undef INFO
285 #undef RINFO
286 #undef STRG
287 #undef RSTRG
288 #undef SWCH
289 #undef BOOL
290
291 static const char releasestring[] = "rxvt-unicode (" RXVTNAME ") v" VERSION " - released: " DATE "\n";
292 static const char optionsstring[] = "options: "
293 #if ENABLE_PERL
294 "perl,"
295 #endif
296 #if XFT
297 "xft,"
298 #endif
299 #if ENABLE_STYLES
300 "styles,"
301 #endif
302 #if ENABLE_COMBINING
303 "combining,"
304 #endif
305 #if TEXT_BLINK
306 "blink,"
307 #endif
308 #if ISO_14755
309 "iso14755,"
310 #endif
311 #if UNICODE_3
312 "unicode3,"
313 #endif
314 "encodings=eu+vn"
315 #if ENCODING_JP
316 "+jp"
317 #endif
318 #if ENCODING_JP_EXT
319 "+jp-ext"
320 #endif
321 #if ENCODING_KR
322 "+kr"
323 #endif
324 #if ENCODING_ZH
325 "+zh"
326 #endif
327 #if ENCODING_ZH_EXT
328 "+zh-ext"
329 #endif
330 ","
331 #if OFF_FOCUS_FADING
332 "fade,"
333 #endif
334 #if defined(ENABLE_TRANSPARENCY)
335 "transparent,"
336 "tint,"
337 #endif
338 #if HAVE_PIXBUF
339 "pixbuf,"
340 #endif
341 #if defined(USE_XIM)
342 "XIM,"
343 #endif
344 #if defined(NO_BACKSPACE_KEY)
345 "no_backspace,"
346 #endif
347 #if defined(NO_DELETE_KEY)
348 "no_delete,"
349 #endif
350 #if EIGHT_BIT_CONTROLS
351 "8bitctrls,"
352 #endif
353 #if defined(ENABLE_FRILLS)
354 "frills,"
355 #endif
356 #if defined(SELECTION_SCROLLING)
357 "selectionscrolling,"
358 #endif
359 #if MOUSE_WHEEL
360 "wheel,"
361 #endif
362 #if MOUSE_SLIP_WHEELING
363 "slipwheel,"
364 #endif
365 #if defined(SMART_RESIZE)
366 "smart-resize,"
367 #endif
368 #if defined(CURSOR_BLINK)
369 "cursorBlink,"
370 #endif
371 #if defined(POINTER_BLANK)
372 "pointerBlank,"
373 #endif
374 #if defined(NO_RESOURCES)
375 "NoResources,"
376 #endif
377 "scrollbars=plain"
378 #if defined(RXVT_SCROLLBAR)
379 "+rxvt"
380 #endif
381 #if defined(NEXT_SCROLLBAR)
382 "+NeXT"
383 #endif
384 #if defined(XTERM_SCROLLBAR)
385 "+xterm"
386 #endif
387 "\nUsage: "; /* Usage */
388
389 #define INDENT 28
390
391 const char rxvt_term::resval_undef [] = "<undef>";
392 const char rxvt_term::resval_on [] = "on";
393 const char rxvt_term::resval_off [] = "off";
394
395 /*{{{ usage: */
396 /*----------------------------------------------------------------------*/
397 void
398 rxvt_term::rxvt_usage (int type)
399 {
400 unsigned int i, col;
401
402 rxvt_log ("%s%s%s", releasestring, optionsstring, RESNAME);
403
404 switch (type)
405 {
406 case 0: /* brief listing */
407 rxvt_log (" [-help] [--help]\n");
408
409 for (col = 1, i = 0; i < ecb_array_length (optList); i++)
410 if (optList[i].desc != NULL)
411 {
412 int len = 0;
413
414 if (optList[i].arg)
415 len = strlen (optList[i].arg) + 1;
416
417 assert (optList[i].opt != NULL);
418 len += 4 + strlen (optList[i].opt) + (optList_isBool (i) ? 2 : 0);
419 col += len;
420
421 if (col > 79)
422 {
423 /* assume regular width */
424 rxvt_log ("\n");
425 col = 1 + len;
426 }
427
428 rxvt_log (" [-%s%s", (optList_isBool (i) ? "/+" : ""), optList[i].opt);
429
430 if (optList[i].arg)
431 rxvt_log (" %s]", optList[i].arg);
432 else
433 rxvt_log ("]");
434 }
435 break;
436
437 case 1: /* full command-line listing */
438 rxvt_log (" [options] [-e command args]\n\nwhere options include:\n");
439
440 for (i = 0; i < ecb_array_length (optList); i++)
441 if (optList[i].desc != NULL)
442 {
443 assert (optList[i].opt != NULL);
444 rxvt_log (" %s%s %-*s%s%s\n",
445 (optList_isBool (i) ? "-/+" : "-"), optList[i].opt,
446 (INDENT - strlen (optList[i].opt)
447 + (optList_isBool (i) ? 0 : 2)),
448 (optList[i].arg ? optList[i].arg : ""),
449 (optList_isBool (i) ? "turn on/off " : ""),
450 optList[i].desc);
451 }
452
453 #if ENABLE_PERL
454 rxvt_perl.init (this);
455 rxvt_perl.usage (this, 1);
456 #endif
457
458 rxvt_log ("\n --help to list long-options");
459 break;
460
461 case 2: /* full resource listing */
462 rxvt_log (" [options] [-e command args]\n\n"
463 "where resources (long-options) include:\n");
464
465 for (i = 0; i < ecb_array_length (optList); i++)
466 if (optList[i].kw != NULL)
467 rxvt_log (" %s: %*s%s\n",
468 optList[i].kw,
469 (INDENT + 2 - strlen (optList[i].kw)), "", /* XXX */
470 (optList_isBool (i) ? "boolean" : optList[i].arg));
471
472 #if ENABLE_PERL
473 rxvt_perl.init (this);
474 rxvt_perl.usage (this, 2);
475 #endif
476
477 rxvt_log ("\n -help to list options");
478 break;
479 }
480
481 rxvt_log ("\n\n");
482 rxvt_exit_failure ();
483 }
484
485 /*}}} */
486
487 /*{{{ get command-line options before getting resources */
488 const char **
489 rxvt_term::get_options (int argc, const char *const *argv)
490 {
491 int i, bad_option = 0;
492
493 for (i = 1; i < argc; i++)
494 {
495 unsigned int entry, longopt = 0;
496 const char *opt;
497 int flag;
498
499 opt = argv[i];
500
501 if (*opt == '-')
502 {
503 flag = 1;
504
505 if (*++opt == '-')
506 longopt = *opt++; /* long option */
507 }
508 else if (*opt == '+')
509 {
510 flag = 0;
511
512 if (*++opt == '+')
513 longopt = *opt++; /* long option */
514 }
515 else
516 {
517 bad_option = 1;
518 rxvt_warn ("\"%s\": malformed option.\n", opt);
519 continue;
520 }
521
522 if (!strcmp (opt, "help"))
523 rxvt_usage (longopt ? 2 : 1);
524
525 if (!strcmp (opt, "h"))
526 rxvt_usage (0);
527
528 /* feature: always try to match long-options */
529 for (entry = 0; entry < ecb_array_length (optList); entry++)
530 if ((optList[entry].kw && !strcmp (opt, optList[entry].kw))
531 || (!longopt
532 && optList[entry].opt && !strcmp (opt, optList[entry].opt)))
533 break;
534
535 if (entry < ecb_array_length (optList)
536 && !optList_isInfo (entry))
537 {
538 if (optList_isReverse (entry))
539 flag = !flag;
540
541 if (optList_isString (entry))
542 {
543 /*
544 * special cases are handled in init_resources () to allow
545 * X resources to set these values before we settle for
546 * default values
547 */
548
549 if (optList[entry].doff != -1)
550 {
551 if (flag && i + 1 == argc)
552 rxvt_fatal ("option '%s' requires an argument, aborting.\n", argv [i]);
553
554 rs[optList[entry].doff] = flag ? argv[++i] : resval_undef;
555 }
556 }
557 else
558 {
559 /* boolean value */
560 set_option (optList[entry].index, flag);
561
562 if (optList[entry].doff != -1)
563 rs[optList[entry].doff] = flag ? resval_on : resval_off;
564 }
565 }
566 #ifndef NO_RESOURCES
567 else if (!strcmp (opt, "xrm"))
568 {
569 if (i + 1 < argc)
570 XrmPutLineResource (&option_db, argv[++i]);
571 }
572 #endif
573 #ifdef KEYSYM_RESOURCE
574 else if (!strncmp (opt, "keysym.", sizeof ("keysym.") - 1))
575 {
576 if (i + 1 < argc)
577 {
578 char *res = rxvt_temp_buf<char> (strlen (opt) + strlen (argv[++i]) + 6);
579 sprintf (res, "*.%s: %s\n", opt, argv[i]);
580 XrmPutLineResource (&option_db, res);
581 }
582 }
583 #endif
584 else if (!strcmp (opt, "e"))
585 {
586 if (i + 1 < argc)
587 return (const char **)argv + i + 1;
588
589 rxvt_warn ("option '-e' requires an argument, aborting.\n");
590 bad_option = 1;
591 }
592 else
593 {
594 #if ENABLE_PERL
595 rxvt_perl.init (this);
596
597 if (int flags = rxvt_perl.parse_resource (this, opt, true, longopt, flag, argv [i + 1]))
598 {
599 if (flags & rxvt_perl.RESOURCE_ARG)
600 {
601 if (i + 1 == argc)
602 {
603 rxvt_warn ("option '%s' requires an argument.\n", argv [i]);
604 bad_option = 1;
605 }
606 else
607 ++i;
608 }
609 }
610 else
611 #endif
612 {
613 rxvt_warn ("\"%s\": unknown or malformed option.\n", opt);
614 bad_option = 1;
615 }
616 }
617 }
618
619 if (bad_option)
620 rxvt_usage (0);
621
622 return 0;
623 }
624
625 /*}}} */
626
627 /*----------------------------------------------------------------------*/
628
629 #ifdef KEYSYM_RESOURCE
630 static void
631 rxvt_define_key (rxvt_term *term, const char *k, const char *v)
632 {
633 term->bind_action (k, v);
634 }
635
636 /*
637 * look for something like this (XK_Delete)
638 * rxvt*keysym.0xFFFF: "\177"
639 */
640
641 struct keysym_vocabulary_t
642 {
643 const char *name;
644 unsigned short len;
645 unsigned short value;
646 };
647 static const keysym_vocabulary_t keysym_vocabulary[] =
648 {
649 { "ISOLevel3", 9, Level3Mask },
650 { "AppKeypad", 9, AppKeypadMask },
651 { "Control", 7, ControlMask },
652 { "NumLock", 7, NumLockMask },
653 { "Shift", 5, ShiftMask },
654 { "Meta", 4, MetaMask },
655 { "Lock", 4, LockMask },
656 { "Mod1", 4, Mod1Mask },
657 { "Mod2", 4, Mod2Mask },
658 { "Mod3", 4, Mod3Mask },
659 { "Mod4", 4, Mod4Mask },
660 { "Mod5", 4, Mod5Mask },
661 { "I", 1, Level3Mask },
662 { "K", 1, AppKeypadMask },
663 { "C", 1, ControlMask },
664 { "N", 1, NumLockMask },
665 { "S", 1, ShiftMask },
666 { "M", 1, MetaMask },
667 { "A", 1, MetaMask },
668 { "L", 1, LockMask },
669 { "1", 1, Mod1Mask },
670 { "2", 1, Mod2Mask },
671 { "3", 1, Mod3Mask },
672 { "4", 1, Mod4Mask },
673 { "5", 1, Mod5Mask },
674 };
675
676 int
677 rxvt_term::parse_keysym (const char *str, unsigned int &state)
678 {
679 int sym;
680 const char *key = strrchr (str, '-');
681
682 state = 0;
683
684 if (!key)
685 key = str;
686 else
687 key++;
688
689 // string or key is empty
690 if (*key == '\0')
691 return -1;
692
693 // parse modifiers
694 while (str < key)
695 {
696 unsigned int i;
697
698 for (i = 0; i < ecb_array_length (keysym_vocabulary); ++i)
699 {
700 if (strncmp (str, keysym_vocabulary [i].name, keysym_vocabulary [i].len) == 0)
701 {
702 state |= keysym_vocabulary[i].value;
703 str += keysym_vocabulary[i].len;
704 break;
705 }
706 }
707
708 if (i >= ecb_array_length (keysym_vocabulary))
709 return -1;
710
711 if (*str == '-')
712 ++str;
713 }
714
715 // convert keysym name to keysym number
716 if ((sym = XStringToKeysym (str)) == None)
717 {
718 // fallback on hexadecimal parsing
719 char *end;
720 sym = strtol (str, &end, 16);
721 if (*end)
722 return -1;
723 }
724
725 return sym;
726 }
727
728 int
729 rxvt_term::bind_action (const char *str, const char *arg)
730 {
731 int sym;
732 unsigned int state;
733
734 if (*arg == '\0' || (sym = parse_keysym (str, state)) == -1)
735 return -1;
736
737 wchar_t *ws = rxvt_mbstowcs (arg);
738 if (!HOOK_INVOKE ((this, HOOK_REGISTER_COMMAND, DT_INT, sym, DT_INT, state, DT_WCS_LEN, ws, wcslen (ws), DT_END)))
739 keyboard->register_action (sym, state, ws);
740
741 free (ws);
742 return 1;
743 }
744
745 #endif /* KEYSYM_RESOURCE */
746
747 static char *
748 get_res (XrmDatabase database, const char *program, const char *option)
749 {
750 char resource[512];
751 char *type;
752 XrmValue result;
753
754 snprintf (resource, sizeof (resource), "%s.%s", program, option);
755 XrmGetResource (database, resource, resource, &type, &result);
756
757 return result.addr;
758 }
759
760 const char *
761 rxvt_term::x_resource (const char *name)
762 {
763 XrmDatabase database = XrmGetDatabase (dpy);
764
765 const char *p = get_res (database, rs[Rs_name], name);
766 const char *p0 = get_res (database, "!INVALIDPROGRAMMENAMEDONTMATCH!", name);
767
768 if (p == NULL || (p0 && strcmp (p, p0) == 0))
769 {
770 p = get_res (database, RESCLASS, name);
771 #ifdef RESFALLBACK
772 if (p == NULL || (p0 && strcmp (p, p0) == 0))
773 p = get_res (database, RESFALLBACK, name);
774 #endif
775 }
776
777 if (p == NULL && p0)
778 p = p0;
779
780 return p;
781 }
782
783 void
784 rxvt_term::extract_resources ()
785 {
786 #ifndef NO_RESOURCES
787 XrmDatabase database = XrmGetDatabase (dpy);
788 XrmMergeDatabases (option_db, &database);
789 option_db = NULL;
790 /*
791 * Query resources for options that affect us
792 */
793 for (int entry = 0; entry < ecb_array_length (optList); entry++)
794 {
795 int s;
796 const char *kw = optList[entry].kw;
797
798 if (kw == NULL || rs[optList[entry].doff] != NULL)
799 continue; // previously set
800
801 const char *p = x_resource (kw);
802
803 if (p)
804 {
805 p = strdup (p);
806 allocated.push_back ((void *)p);
807 rs[optList[entry].doff] = p;
808
809 if (optList_isBool (entry))
810 {
811 s = strcasecmp (p, "TRUE") == 0
812 || strcasecmp (p, "YES") == 0
813 || strcasecmp (p, "ON") == 0
814 || strcasecmp (p, "1") == 0;
815
816 if (optList_isReverse (entry))
817 s = !s;
818
819 set_option (optList[entry].index, s);
820 }
821 }
822 }
823 #endif /* NO_RESOURCES */
824 }
825
826 struct rxvt_enumerate_closure
827 {
828 rxvt_term *term;
829 void (*cb)(rxvt_term *, const char *, const char *);
830 int specific; // iterate over only a specific subhierarchy
831 };
832
833 /*
834 * Define key from XrmEnumerateDatabase.
835 * quarks will be something like
836 * "rxvt" "keysym" "0xFF01"
837 * value will be a string
838 */
839 static int
840 rxvt_enumerate_helper (
841 XrmDatabase *database ecb_unused,
842 XrmBindingList bindings ecb_unused,
843 XrmQuarkList quarks,
844 XrmRepresentation *type ecb_unused,
845 XrmValue *value,
846 XPointer closure
847 )
848 {
849 const rxvt_enumerate_closure *data = (const rxvt_enumerate_closure *)closure;
850
851 if (*quarks == NULLQUARK) return False;
852
853 // if the quark list starts with a tightly bound quark, we skip it,
854 // as it exactly matched the prefix. Otherwise, it matched because
855 // it started with "*", in which case we assume the prefix is part
856 // of the "*".
857 if (*bindings == XrmBindTightly)
858 {
859 ++quarks, ++bindings; // skip if this is a fixed prefix, rather than a *-match
860 if (*quarks == NULLQUARK) return False;
861 }
862
863 // specific, a bit misleadingly named, is used when a specific "subclass"
864 // is iterated over, e.g. "keysym", and is used to skip one more
865 // component, as well as all generic prefixes
866 // this is a bit of a hack, ideally, keysym (the only user) should use its
867 // own iteration function, but this ought to be less bloated
868 if (data->specific)
869 {
870 ++quarks, ++bindings;
871 if (*quarks == NULLQUARK) return False;
872 }
873
874 char *pattern;
875 if (quarks[1] == NULLQUARK)
876 pattern = XrmQuarkToString (quarks[0]); // single component, fast path
877 else
878 {
879 // multiple components, slow path - should be rare, don't optimize for speed
880 int size = 0;
881
882 for (int i = 0; quarks[i] != NULLQUARK; ++i)
883 size += strlen (XrmQuarkToString (quarks[i])) + 1;
884
885 pattern = rxvt_temp_buf<char> (size + 1);
886
887 // now print all components
888 {
889 char *cur = pattern;
890
891 for (int i = 0; quarks[i] != NULLQUARK; ++i)
892 cur += sprintf (cur, ".%s", XrmQuarkToString (quarks[i]));
893 }
894
895 ++pattern; // skip initial dot
896 }
897
898 data->cb (data->term, pattern, (char *)value->addr);
899
900 return False;
901 }
902
903 void
904 rxvt_term::enumerate_resources (void (*cb)(rxvt_term *, const char *, const char *), const char *name_p, const char *class_p)
905 {
906 /*
907 * [R5 or later]: enumerate the resource database
908 */
909 assert (!name_p == !class_p); // both must be specified, or missing
910
911 #ifdef KEYSYM_RESOURCE
912 rxvt_enumerate_closure closure = { this, cb, name_p ? 1 : 0 };
913
914 XrmDatabase database = XrmGetDatabase (dpy);
915 XrmName name_prefix[3];
916 XrmClass class_prefix[3];
917
918 name_prefix[1] = name_p ? XrmStringToName (name_p) : NULLQUARK;
919 name_prefix[2] = NULLQUARK;
920 class_prefix[1] = class_p ? XrmStringToName (class_p) : NULLQUARK;
921 class_prefix[2] = NULLQUARK;
922
923 # ifdef RESFALLBACK
924 name_prefix[0] = class_prefix[0] = XrmStringToName (RESFALLBACK);
925 XrmEnumerateDatabase (database, name_prefix, class_prefix,
926 XrmEnumAllLevels, rxvt_enumerate_helper, (XPointer)&closure);
927 # endif
928
929 name_prefix[0] = class_prefix[0] = XrmStringToName (RESCLASS);
930 XrmEnumerateDatabase (database, name_prefix, class_prefix,
931 XrmEnumAllLevels, rxvt_enumerate_helper, (XPointer)&closure);
932
933 name_prefix[0] = class_prefix[0] = XrmStringToName (rs[Rs_name]);
934 XrmEnumerateDatabase (database, name_prefix, class_prefix,
935 XrmEnumAllLevels, rxvt_enumerate_helper, (XPointer)&closure);
936 #endif
937 }
938
939 void
940 rxvt_term::extract_keysym_resources ()
941 {
942 #ifdef KEYSYM_RESOURCE
943 enumerate_keysym_resources (rxvt_define_key);
944 #endif
945 }
946
947 /*----------------------- end-of-file (C source) -----------------------*/
948