1 |
/*--------------------------------*-C-*---------------------------------* |
2 |
* File: xdefaults.c |
3 |
*----------------------------------------------------------------------* |
4 |
* $Id: xdefaults.C,v 1.4 2003/12/17 09:00:35 pcg Exp $ |
5 |
* |
6 |
* All portions of code are copyright by their respective author/s. |
7 |
* Copyright (c) 1994 Robert Nation <nation@rocket.sanders.lockheed.com> |
8 |
* - original version |
9 |
* Copyright (c) 1997,1998 mj olesen <olesen@me.queensu.ca> |
10 |
* |
11 |
* This program is free software; you can redistribute it and/or modify |
12 |
* it under the terms of the GNU General Public License as published by |
13 |
* the Free Software Foundation; either version 2 of the License, or |
14 |
* (at your option) any later version. |
15 |
* |
16 |
* This program is distributed in the hope that it will be useful, |
17 |
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
18 |
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
19 |
* GNU General Public License for more details. |
20 |
* |
21 |
* You should have received a copy of the GNU General Public License |
22 |
* along with this program; if not, write to the Free Software |
23 |
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
24 |
*----------------------------------------------------------------------*/ |
25 |
/*----------------------------------------------------------------------* |
26 |
* get resources from ~/.Xdefaults or ~/.Xresources with the memory-saving |
27 |
* default or with XGetDefault() (#define USE_XGETDEFAULT) |
28 |
*----------------------------------------------------------------------*/ |
29 |
|
30 |
#include "../config.h" /* NECESSARY */ |
31 |
#include "rxvt.h" /* NECESSARY */ |
32 |
#include "version.h" |
33 |
#include "xdefaults.intpro" /* PROTOS for internal routines */ |
34 |
|
35 |
/* #define DEBUG_RESOURCES */ |
36 |
|
37 |
static const char *const xnames[2] = { ".Xdefaults", ".Xresources" }; |
38 |
|
39 |
/*{{{ monolithic option/resource structure: */ |
40 |
/* |
41 |
* `string' options MUST have a usage argument |
42 |
* `switch' and `boolean' options have no argument |
43 |
* if there's no desc(ription), it won't appear in rxvt_usage() |
44 |
*/ |
45 |
|
46 |
/* INFO() - descriptive information only */ |
47 |
#define INFO(opt, arg, desc) \ |
48 |
{0, -1, NULL, (opt), (arg), (desc)} |
49 |
|
50 |
/* STRG() - command-line option, with/without resource */ |
51 |
#define STRG(rsp, kw, opt, arg, desc) \ |
52 |
{0, (rsp), (kw), (opt), (arg), (desc)} |
53 |
|
54 |
/* RSTRG() - resource/long-option */ |
55 |
#define RSTRG(rsp, kw, arg) \ |
56 |
{0, (rsp), (kw), NULL, (arg), NULL} |
57 |
|
58 |
/* BOOL() - regular boolean `-/+' flag */ |
59 |
#define BOOL(rsp, kw, opt, flag, desc) \ |
60 |
{(Opt_Boolean|(flag)), (rsp), (kw), (opt), NULL, (desc)} |
61 |
|
62 |
/* SWCH() - `-' flag */ |
63 |
#define SWCH(opt, flag, desc) \ |
64 |
{(flag), -1, NULL, (opt), NULL, (desc)} |
65 |
|
66 |
/* convenient macros */ |
67 |
#define optList_strlen(i) \ |
68 |
(optList[i].flag ? 0 : (optList[i].arg ? STRLEN(optList[i].arg) : 1)) |
69 |
#define optList_isBool(i) \ |
70 |
(optList[i].flag & Opt_Boolean) |
71 |
#define optList_isReverse(i) \ |
72 |
(optList[i].flag & Opt_Reverse) |
73 |
#define optList_size() \ |
74 |
(sizeof(optList) / sizeof(optList[0])) |
75 |
|
76 |
static const struct { |
77 |
const unsigned long flag; /* Option flag */ |
78 |
const int doff; /* data offset */ |
79 |
const char *kw; /* keyword */ |
80 |
const char *opt; /* option */ |
81 |
const char *arg; /* argument */ |
82 |
const char *desc; /* description */ |
83 |
} optList[] = { |
84 |
STRG(Rs_display_name, NULL, "d", NULL, NULL), /* short form */ |
85 |
STRG(Rs_display_name, NULL, "display", "string", "X server to contact"), |
86 |
STRG(Rs_term_name, "termName", "tn", "string", |
87 |
"value of the TERM environment variable"), |
88 |
STRG(Rs_geometry, NULL, "g", NULL, NULL), /* short form */ |
89 |
STRG(Rs_geometry, "geometry", "geometry", "geometry", |
90 |
"size (in characters) and position"), |
91 |
SWCH("C", Opt_console, "intercept console messages"), |
92 |
SWCH("iconic", Opt_iconic, "start iconic"), |
93 |
SWCH("ic", Opt_iconic, NULL), /* short form */ |
94 |
BOOL(Rs_reverseVideo, "reverseVideo", "rv", Opt_reverseVideo, |
95 |
"reverse video"), |
96 |
BOOL(Rs_loginShell, "loginShell", "ls", Opt_loginShell, "login shell"), |
97 |
BOOL(Rs_jumpScroll, "jumpScroll", "j", Opt_jumpScroll, "jump scrolling"), |
98 |
#ifdef HAVE_SCROLLBARS |
99 |
BOOL(Rs_scrollBar, "scrollBar", "sb", Opt_scrollBar, "scrollbar"), |
100 |
BOOL(Rs_scrollBar_right, "scrollBar_right", "sr", Opt_scrollBar_right, |
101 |
"scrollbar right"), |
102 |
BOOL(Rs_scrollBar_floating, "scrollBar_floating", "st", |
103 |
Opt_scrollBar_floating, "scrollbar without a trough"), |
104 |
#endif |
105 |
BOOL(Rs_scrollTtyOutput, "scrollTtyOutput", NULL, Opt_scrollTtyOutput, |
106 |
NULL), |
107 |
BOOL(Rs_scrollTtyOutput, NULL, "si", Opt_Reverse | Opt_scrollTtyOutput, |
108 |
"scroll-on-tty-output inhibit"), |
109 |
BOOL(Rs_scrollTtyKeypress, "scrollTtyKeypress", "sk", Opt_scrollTtyKeypress, |
110 |
"scroll-on-keypress"), |
111 |
BOOL(Rs_scrollWithBuffer, "scrollWithBuffer", "sw", Opt_scrollWithBuffer, |
112 |
"scroll-with-buffer"), |
113 |
#ifdef TRANSPARENT |
114 |
BOOL(Rs_transparent, "inheritPixmap", "ip", Opt_transparent, |
115 |
"inherit parent pixmap"), |
116 |
BOOL(Rs_transparent_all, "inheritPixmapforce", "ipf", Opt_transparent_all, |
117 |
"forcefully inherit root pixmap"), |
118 |
SWCH("tr", Opt_transparent, NULL), |
119 |
#endif |
120 |
BOOL(Rs_utmpInhibit, "utmpInhibit", "ut", Opt_utmpInhibit, "utmp inhibit"), |
121 |
#ifndef NO_BELL |
122 |
BOOL(Rs_visualBell, "visualBell", "vb", Opt_visualBell, "visual bell"), |
123 |
# if ! defined(NO_MAPALERT) && defined(MAPALERT_OPTION) |
124 |
BOOL(Rs_mapAlert, "mapAlert", NULL, Opt_mapAlert, NULL), |
125 |
# endif |
126 |
#endif |
127 |
#ifdef META8_OPTION |
128 |
BOOL(Rs_meta8, "meta8", NULL, Opt_meta8, NULL), |
129 |
#endif |
130 |
#ifdef MOUSE_WHEEL |
131 |
BOOL(Rs_mouseWheelScrollPage, "mouseWheelScrollPage", NULL, Opt_mouseWheelScrollPage, |
132 |
NULL), |
133 |
#endif |
134 |
#ifdef MULTICHAR_SET |
135 |
BOOL(Rs_mc_hack, "multibyte_cursor", "mcc", Opt_mc_hack, |
136 |
"Multibyte character cursor movement"), |
137 |
#endif |
138 |
#ifndef NO_FRILLS |
139 |
BOOL(Rs_tripleclickwords, "tripleclickwords", "tcw", Opt_tripleclickwords, |
140 |
"triple click word selection"), |
141 |
#endif |
142 |
#ifdef CURSOR_BLINK |
143 |
BOOL(Rs_cursorBlink, "cursorBlink", "bc", Opt_cursorBlink, "blinking cursor"), |
144 |
#endif |
145 |
#ifdef POINTER_BLANK |
146 |
BOOL(Rs_pointerBlank, "pointerBlank", NULL, Opt_pointerBlank, NULL), |
147 |
#endif |
148 |
STRG(Rs_color + Color_bg, "background", "bg", "color", "background color"), |
149 |
STRG(Rs_color + Color_fg, "foreground", "fg", "color", "foreground color"), |
150 |
RSTRG(Rs_color + minCOLOR + 0, "color0", "color"), |
151 |
RSTRG(Rs_color + minCOLOR + 1, "color1", "color"), |
152 |
RSTRG(Rs_color + minCOLOR + 2, "color2", "color"), |
153 |
RSTRG(Rs_color + minCOLOR + 3, "color3", "color"), |
154 |
RSTRG(Rs_color + minCOLOR + 4, "color4", "color"), |
155 |
RSTRG(Rs_color + minCOLOR + 5, "color5", "color"), |
156 |
RSTRG(Rs_color + minCOLOR + 6, "color6", "color"), |
157 |
RSTRG(Rs_color + minCOLOR + 7, "color7", "color"), |
158 |
#ifndef NO_BRIGHTCOLOR |
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 |
#endif /* NO_BRIGHTCOLOR */ |
168 |
#ifndef NO_BOLD_UNDERLINE_REVERSE |
169 |
RSTRG(Rs_color + Color_BD, "colorBD", "color"), |
170 |
RSTRG(Rs_color + Color_UL, "colorUL", "color"), |
171 |
RSTRG(Rs_color + Color_RV, "colorRV", "color"), |
172 |
#endif /* ! NO_BOLD_UNDERLINE_REVERSE */ |
173 |
#ifdef KEEP_SCROLLCOLOR |
174 |
RSTRG(Rs_color + Color_scroll, "scrollColor", "color"), |
175 |
RSTRG(Rs_color + Color_trough, "troughColor", "color"), |
176 |
#endif /* KEEP_SCROLLCOLOR */ |
177 |
#ifdef OPTION_HC |
178 |
STRG(Rs_color + Color_HC, "highlightColor", "hc", "color", "highlight color"), |
179 |
#endif |
180 |
#if defined (XPM_BACKGROUND) || (MENUBAR_MAX) |
181 |
RSTRG(Rs_path, "path", "search path"), |
182 |
#endif /* defined (XPM_BACKGROUND) || (MENUBAR_MAX) */ |
183 |
#ifdef XPM_BACKGROUND |
184 |
STRG(Rs_backgroundPixmap, "backgroundPixmap", "pixmap", "file[;geom]", |
185 |
"background pixmap"), |
186 |
#endif /* XPM_BACKGROUND */ |
187 |
#if (MENUBAR_MAX) |
188 |
RSTRG(Rs_menu, "menu", "name[;tag]"), |
189 |
#endif |
190 |
#ifndef NO_BOLDFONT |
191 |
STRG(Rs_boldFont, "boldFont", "fb", "fontname", "bold text font"), |
192 |
#endif |
193 |
STRG(Rs_font + 0, "font", "fn", "fontname", "normal text font"), |
194 |
/* fonts: command-line option = resource name */ |
195 |
#ifdef MULTICHAR_SET |
196 |
STRG(Rs_multichar_encoding, "multichar_encoding", "km", "mode", |
197 |
"multichar encoding; mode = eucj|sjis|big5|gb|kr|noenc"), |
198 |
#endif /* MULTICHAR_SET */ |
199 |
#ifdef USE_XIM |
200 |
STRG(Rs_inputMethod, "inputMethod", "im", "name", "name of input method"), |
201 |
STRG(Rs_preeditType, "preeditType", "pt", "style", |
202 |
"input style: style = OverTheSpot|OffTheSpot|Root"), |
203 |
#if defined(HAVE_XSETLOCALE) || defined(HAVE_SETLOCALE) |
204 |
STRG(Rs_imLocale, "imLocale", "imlocale", "string", "locale to use for input method"), |
205 |
#endif |
206 |
#endif /* USE_XIM */ |
207 |
#ifdef GREEK_SUPPORT |
208 |
STRG(Rs_greek_keyboard, "greek_keyboard", "grk", "mode", |
209 |
"greek keyboard mapping; mode = iso | ibm"), |
210 |
RSTRG(Rs_greektoggle_key, "greektoggle_key", "keysym"), |
211 |
#endif |
212 |
STRG(Rs_name, NULL, "name", "string", |
213 |
"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 |
#ifndef NO_CURSORCOLOR |
218 |
STRG(Rs_color + Color_cursor, "cursorColor", "cr", "color", "cursor color"), |
219 |
/* command-line option = resource name */ |
220 |
RSTRG(Rs_color + Color_cursor2, "cursorColor2", "color"), |
221 |
#endif /* NO_CURSORCOLOR */ |
222 |
STRG(Rs_color + Color_pointer, "pointerColor", "pr", "color", |
223 |
"pointer color"), |
224 |
STRG(Rs_color + Color_border, "borderColor", "bd", "color", |
225 |
"border color"), |
226 |
STRG(Rs_saveLines, "saveLines", "sl", "number", |
227 |
"number of scrolled lines to save"), |
228 |
#ifndef NO_FRILLS |
229 |
STRG(Rs_ext_bwidth, "externalBorder", "w", "number", |
230 |
"external border in pixels"), |
231 |
STRG(Rs_ext_bwidth, NULL, "bw", NULL, NULL), |
232 |
STRG(Rs_ext_bwidth, NULL, "borderwidth", NULL, NULL), |
233 |
STRG(Rs_int_bwidth, "internalBorder", "b", "number", |
234 |
"internal border in pixels"), |
235 |
#endif |
236 |
#ifndef NO_LINESPACE |
237 |
STRG(Rs_lineSpace, "lineSpace", "lsp", "number", |
238 |
"number of extra pixels between rows"), |
239 |
#endif |
240 |
STRG(Rs_scrollBar_thickness, "thickness", "sbt", "number", |
241 |
"scrollbar thickness/width in pixels"), |
242 |
#ifdef POINTER_BLANK |
243 |
RSTRG(Rs_pointerBlankDelay, "pointerBlankDelay", "number"), |
244 |
#endif |
245 |
#ifndef NO_BACKSPACE_KEY |
246 |
RSTRG(Rs_backspace_key, "backspacekey", "string"), |
247 |
#endif |
248 |
#ifndef NO_DELETE_KEY |
249 |
RSTRG(Rs_delete_key, "deletekey", "string"), |
250 |
#endif |
251 |
RSTRG(Rs_selectstyle, "selectstyle", "mode"), |
252 |
RSTRG(Rs_scrollstyle, "scrollstyle", "mode"), |
253 |
#ifdef HAVE_SCROLLBARS |
254 |
RSTRG(Rs_scrollBar_align, "scrollBar_align", "mode"), |
255 |
#endif |
256 |
#ifdef PRINTPIPE |
257 |
RSTRG(Rs_print_pipe, "print-pipe", "string"), |
258 |
#endif |
259 |
#if defined (HOTKEY_CTRL) || defined (HOTKEY_META) |
260 |
RSTRG(Rs_bigfont_key, "bigfont_key", "keysym"), |
261 |
RSTRG(Rs_smallfont_key, "smallfont_key", "keysym"), |
262 |
#endif |
263 |
STRG(Rs_modifier, "modifier", "mod", "modifier", |
264 |
"meta modifier = alt|meta|hyper|super|mod1|...|mod5"), |
265 |
INFO("xrm", "string", "X resource"), |
266 |
#ifdef CUTCHAR_RESOURCE |
267 |
RSTRG(Rs_cutchars, "cutchars", "string"), |
268 |
#endif /* CUTCHAR_RESOURCE */ |
269 |
#ifdef ACS_ASCII |
270 |
RSTRG(Rs_acs_chars, "acsChars", "string"), |
271 |
#endif /* ACS_ASCII */ |
272 |
RSTRG(Rs_answerbackstring, "answerbackString", "string"), |
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 |
|
283 |
static const char releasestring[] = "Rxvt v" VERSION " - released: " DATE "\n"; |
284 |
static const char optionsstring[] = "Options: " |
285 |
#if defined(XPM_BACKGROUND) |
286 |
"XPM," |
287 |
#endif |
288 |
#if defined(TRANSPARENT) |
289 |
"transparent," |
290 |
#endif |
291 |
#if defined(UTMP_SUPPORT) |
292 |
"utmp," |
293 |
#endif |
294 |
#if defined(MENUBAR) |
295 |
"menubar," |
296 |
#endif |
297 |
#if !defined(NO_FRILLS) |
298 |
"frills," |
299 |
#endif |
300 |
#if !defined(NO_LINESPACE) |
301 |
"linespace," |
302 |
#endif |
303 |
#if defined(PREFER_24BIT) |
304 |
"24bit," |
305 |
#endif |
306 |
#if defined(USE_XIM) |
307 |
"XIM," |
308 |
#endif |
309 |
#if defined(MULTICHAR_SET) |
310 |
"multichar_languages," |
311 |
#endif |
312 |
"scrollbars=" |
313 |
#if !defined(HAVE_SCROLLBARS) |
314 |
"NONE" |
315 |
#else |
316 |
# if defined(RXVT_SCROLLBAR) |
317 |
"rxvt" |
318 |
# if defined(NEXT_SCROLLBAR) || defined(XTERM_SCROLLBAR) |
319 |
"+" |
320 |
# endif |
321 |
# endif |
322 |
# if defined(NEXT_SCROLLBAR) |
323 |
"NeXT" |
324 |
# if defined(XTERM_SCROLLBAR) |
325 |
"+" |
326 |
# endif |
327 |
# endif |
328 |
# if defined(XTERM_SCROLLBAR) |
329 |
"xterm" |
330 |
# endif |
331 |
#endif |
332 |
"," |
333 |
#if defined(GREEK_SUPPORT) |
334 |
"Greek," |
335 |
#endif |
336 |
#if defined(RXVT_GRAPHICS) |
337 |
"graphics," |
338 |
#endif |
339 |
#if defined(NO_BACKSPACE_KEY) |
340 |
"no_backspace," |
341 |
#endif |
342 |
#if defined(NO_DELETE_KEY) |
343 |
"no_delete," |
344 |
#endif |
345 |
#if !defined(NO_STRINGS) |
346 |
"strings," |
347 |
#endif |
348 |
#if defined(TTY_256COLOR) |
349 |
"256colour," |
350 |
#endif |
351 |
#if defined(NO_RESOURCES) |
352 |
"NoResources" |
353 |
#else |
354 |
# if defined(USE_XGETDEFAULT) |
355 |
"XGetDefaults" |
356 |
# else |
357 |
".Xdefaults" |
358 |
# endif |
359 |
#endif |
360 |
"\nUsage: "; /* Usage */ |
361 |
|
362 |
#define INDENT 18 |
363 |
|
364 |
/*{{{ usage: */ |
365 |
/*----------------------------------------------------------------------*/ |
366 |
/* EXTPROTO */ |
367 |
void |
368 |
rxvt_usage(int type) |
369 |
{ |
370 |
unsigned int i, col; |
371 |
|
372 |
write(STDERR_FILENO, releasestring, sizeof(releasestring) - 1); |
373 |
write(STDERR_FILENO, optionsstring, sizeof(optionsstring) - 1); |
374 |
write(STDERR_FILENO, APL_NAME, sizeof(APL_NAME) - 1); |
375 |
|
376 |
switch (type) { |
377 |
case 0: /* brief listing */ |
378 |
fprintf(stderr, " [-help] [--help]\n"); |
379 |
for (col = 1, i = 0; i < optList_size(); i++) |
380 |
if (optList[i].desc != NULL) { |
381 |
int len = 0; |
382 |
|
383 |
if (!optList_isBool(i)) { |
384 |
len = optList_strlen(i); |
385 |
if (len > 0) |
386 |
len++; /* account for space */ |
387 |
} |
388 |
#ifdef DEBUG_STRICT |
389 |
assert(optList[i].opt != NULL); |
390 |
#endif |
391 |
len += 4 + STRLEN(optList[i].opt) + (optList_isBool(i) ? 2: 0); |
392 |
col += len; |
393 |
if (col > 79) { /* assume regular width */ |
394 |
putc('\n', stderr); |
395 |
col = 1 + len; |
396 |
} |
397 |
fprintf(stderr, " [-%s%s", (optList_isBool(i) ? "/+" : ""), |
398 |
optList[i].opt); |
399 |
if (optList_strlen(i)) |
400 |
fprintf(stderr, " %s]", optList[i].arg); |
401 |
else |
402 |
fprintf(stderr, "]"); |
403 |
} |
404 |
break; |
405 |
|
406 |
case 1: /* full command-line listing */ |
407 |
fprintf(stderr, " [options] [-e command args]\n\n" |
408 |
"where options include:\n"); |
409 |
for (i = 0; i < optList_size(); i++) |
410 |
if (optList[i].desc != NULL) { |
411 |
#ifdef DEBUG_STRICT |
412 |
assert(optList[i].opt != NULL); |
413 |
#endif |
414 |
fprintf(stderr, " %s%s %-*s%s%s\n", |
415 |
(optList_isBool(i) ? "-/+" : "-"), optList[i].opt, |
416 |
(INDENT - STRLEN(optList[i].opt) |
417 |
+ (optList_isBool(i) ? 0 : 2)), |
418 |
(optList[i].arg ? optList[i].arg : ""), |
419 |
(optList_isBool(i) ? "turn on/off " : ""), |
420 |
optList[i].desc); |
421 |
} |
422 |
fprintf(stderr, "\n --help to list long-options"); |
423 |
break; |
424 |
|
425 |
case 2: /* full resource listing */ |
426 |
fprintf(stderr, |
427 |
" [options] [-e command args]\n\n" |
428 |
"where resources (long-options) include:\n"); |
429 |
|
430 |
for (i = 0; i < optList_size(); i++) |
431 |
if (optList[i].kw != NULL) |
432 |
fprintf(stderr, " %s: %*s%s\n", |
433 |
optList[i].kw, |
434 |
(INDENT - STRLEN(optList[i].kw)), "", /* XXX */ |
435 |
(optList_isBool(i) ? "boolean" : optList[i].arg)); |
436 |
#ifdef KEYSYM_RESOURCE |
437 |
fprintf(stderr, " " "keysym.sym" ": %*s%s\n", |
438 |
(INDENT - sizeof("keysym.sym") + 1), "", /* XXX */ |
439 |
"keysym"); |
440 |
#endif |
441 |
fprintf(stderr, "\n -help to list options"); |
442 |
break; |
443 |
} |
444 |
fprintf(stderr, "\n\n"); |
445 |
exit(EXIT_FAILURE); |
446 |
/* NOTREACHED */ |
447 |
} |
448 |
|
449 |
/*}}} */ |
450 |
|
451 |
/*{{{ get command-line options before getting resources */ |
452 |
/* EXTPROTO */ |
453 |
void |
454 |
rxvt_get_options(pR_ int argc, const char *const *argv) |
455 |
{ |
456 |
int i, bad_option = 0; |
457 |
static const char On[3] = "ON", Off[4] = "OFF"; |
458 |
|
459 |
for (i = 1; i < argc; i++) { |
460 |
unsigned int entry, longopt = 0; |
461 |
const char *flag, *opt; |
462 |
|
463 |
opt = argv[i]; |
464 |
#ifdef DEBUG_RESOURCES |
465 |
fprintf(stderr, "argv[%d] = %s: ", i, opt); |
466 |
#endif |
467 |
if (*opt == '-') { |
468 |
flag = On; |
469 |
if (*++opt == '-') |
470 |
longopt = *opt++; /* long option */ |
471 |
} else if (*opt == '+') { |
472 |
flag = Off; |
473 |
if (*++opt == '+') |
474 |
longopt = *opt++; /* long option */ |
475 |
} else { |
476 |
bad_option = 1; |
477 |
rxvt_print_error("bad option \"%s\"", opt); |
478 |
continue; |
479 |
} |
480 |
|
481 |
if (!STRCMP(opt, "help")) |
482 |
rxvt_usage(longopt ? 2 : 1); |
483 |
if (!STRCMP(opt, "h")) |
484 |
rxvt_usage(0); |
485 |
|
486 |
/* feature: always try to match long-options */ |
487 |
for (entry = 0; entry < optList_size(); entry++) |
488 |
if ((optList[entry].kw && !STRCMP(opt, optList[entry].kw)) |
489 |
|| (!longopt |
490 |
&& optList[entry].opt && !STRCMP(opt, optList[entry].opt))) |
491 |
break; |
492 |
|
493 |
if (entry < optList_size()) { |
494 |
if (optList_isReverse(entry)) |
495 |
flag = flag == On ? Off : On; |
496 |
if (optList_strlen(entry)) { /* string value */ |
497 |
const char *str = argv[++i]; |
498 |
|
499 |
#ifdef DEBUG_RESOURCES |
500 |
fprintf(stderr, "string (%s,%s) = ", |
501 |
optList[entry].opt ? optList[entry].opt : "nil", |
502 |
optList[entry].kw ? optList[entry].kw : "nil"); |
503 |
#endif |
504 |
if (flag == On && str && (optList[entry].doff != -1)) { |
505 |
#ifdef DEBUG_RESOURCES |
506 |
fprintf(stderr, "\"%s\"\n", str); |
507 |
#endif |
508 |
R->rs[optList[entry].doff] = str; |
509 |
/* |
510 |
* special cases are handled in main.c:main() to allow |
511 |
* X resources to set these values before we settle for |
512 |
* default values |
513 |
*/ |
514 |
} |
515 |
#ifdef DEBUG_RESOURCES |
516 |
else |
517 |
fprintf(stderr, "???\n"); |
518 |
#endif |
519 |
} else { /* boolean value */ |
520 |
#ifdef DEBUG_RESOURCES |
521 |
fprintf(stderr, "boolean (%s,%s) = %s\n", |
522 |
optList[entry].opt, optList[entry].kw, flag); |
523 |
#endif |
524 |
if (flag == On) |
525 |
R->Options |= (optList[entry].flag); |
526 |
else |
527 |
R->Options &= ~(optList[entry].flag); |
528 |
|
529 |
if (optList[entry].doff != -1) |
530 |
R->rs[optList[entry].doff] = flag; |
531 |
} |
532 |
} else |
533 |
#ifdef KEYSYM_RESOURCE |
534 |
/* if (!STRNCMP(opt, "keysym.", sizeof("keysym.") - 1)) */ |
535 |
if (rxvt_Str_match(opt, "keysym.")) { |
536 |
const char *str = argv[++i]; |
537 |
|
538 |
if (str != NULL) |
539 |
rxvt_parse_keysym(aR_ opt + sizeof("keysym.") - 1, str); |
540 |
} else |
541 |
#endif |
542 |
; |
543 |
} |
544 |
|
545 |
if (bad_option) |
546 |
rxvt_usage(0); |
547 |
} |
548 |
|
549 |
/*}}} */ |
550 |
|
551 |
#ifndef NO_RESOURCES |
552 |
/*----------------------------------------------------------------------*/ |
553 |
|
554 |
# ifdef KEYSYM_RESOURCE |
555 |
/* |
556 |
* Define key from XrmEnumerateDatabase. |
557 |
* quarks will be something like |
558 |
* "rxvt" "keysym" "0xFF01" |
559 |
* value will be a string |
560 |
*/ |
561 |
/* ARGSUSED */ |
562 |
/* INTPROTO */ |
563 |
Bool |
564 |
rxvt_define_key(XrmDatabase *database __attribute__((unused)), XrmBindingList bindings __attribute__((unused)), XrmQuarkList quarks, XrmRepresentation *type __attribute__((unused)), XrmValue *value, XPointer closure __attribute__((unused))) |
565 |
{ |
566 |
dR; |
567 |
int last; |
568 |
|
569 |
for (last = 0; quarks[last] != NULLQUARK; last++) /* look for last quark in list */ |
570 |
; |
571 |
last--; |
572 |
rxvt_parse_keysym(aR_ XrmQuarkToString(quarks[last]), (char *)value->addr); |
573 |
return False; |
574 |
} |
575 |
|
576 |
/* |
577 |
* look for something like this (XK_Delete) |
578 |
* rxvt*keysym.0xFFFF: "\177" |
579 |
* |
580 |
* arg will be |
581 |
* NULL for ~/.Xdefaults and |
582 |
* non-NULL for command-line options (need to allocate) |
583 |
*/ |
584 |
#define NEWARGLIM 500 /* `reasonable' size */ |
585 |
/* INTPROTO */ |
586 |
int |
587 |
rxvt_parse_keysym(pR_ const char *str, const char *arg) |
588 |
{ |
589 |
int n, sym; |
590 |
char *key_string, *newarg = NULL; |
591 |
char newargstr[NEWARGLIM]; |
592 |
|
593 |
if (arg == NULL) { |
594 |
if ((n = rxvt_Str_match(str, "keysym.")) == 0) |
595 |
return 0; |
596 |
str += n; /* skip `keysym.' */ |
597 |
} |
598 |
/* some scanf() have trouble with a 0x prefix */ |
599 |
if (isdigit(str[0])) { |
600 |
if (str[0] == '0' && toupper(str[1]) == 'X') |
601 |
str += 2; |
602 |
if (arg) { |
603 |
if (sscanf(str, (STRCHR(str, ':') ? "%x:" : "%x"), &sym) != 1) |
604 |
return -1; |
605 |
} else { |
606 |
if (sscanf(str, "%x:", &sym) != 1) |
607 |
return -1; |
608 |
|
609 |
/* cue to ':', it's there since sscanf() worked */ |
610 |
STRNCPY(newargstr, STRCHR(str, ':') + 1, NEWARGLIM - 1); |
611 |
newargstr[NEWARGLIM - 1] = '\0'; |
612 |
newarg = newargstr; |
613 |
} |
614 |
} else { |
615 |
/* |
616 |
* convert keysym name to keysym number |
617 |
*/ |
618 |
STRNCPY(newargstr, str, NEWARGLIM - 1); |
619 |
newargstr[NEWARGLIM - 1] = '\0'; |
620 |
if (arg == NULL) { |
621 |
if ((newarg = STRCHR(newargstr, ':')) == NULL) |
622 |
return -1; |
623 |
*newarg++ = '\0'; /* terminate keysym name */ |
624 |
} |
625 |
if ((sym = XStringToKeysym(newargstr)) == None) |
626 |
return -1; |
627 |
} |
628 |
|
629 |
if (sym < 0xFF00 || sym > 0xFFFF) /* we only do extended keys */ |
630 |
return -1; |
631 |
sym &= 0xFF; |
632 |
if (R->Keysym_map[sym] != NULL) /* already set ? */ |
633 |
return -1; |
634 |
|
635 |
if (newarg == NULL) { |
636 |
STRNCPY(newargstr, arg, NEWARGLIM - 1); |
637 |
newargstr[NEWARGLIM - 1] = '\0'; |
638 |
newarg = newargstr; |
639 |
} |
640 |
rxvt_Str_trim(newarg); |
641 |
if (*newarg == '\0' || (n = rxvt_Str_escaped(newarg)) == 0) |
642 |
return -1; |
643 |
MIN_IT(n, 255); |
644 |
key_string = (char *)rxvt_malloc((n + 1) * sizeof(char)); |
645 |
|
646 |
key_string[0] = n; |
647 |
STRNCPY(key_string + 1, newarg, n); |
648 |
R->Keysym_map[sym] = (unsigned char *)key_string; |
649 |
|
650 |
return 1; |
651 |
} |
652 |
|
653 |
# endif /* KEYSYM_RESOURCE */ |
654 |
|
655 |
# ifndef USE_XGETDEFAULT |
656 |
/*{{{ rxvt_get_xdefaults() */ |
657 |
/* |
658 |
* the matching algorithm used for memory-save fake resources |
659 |
*/ |
660 |
/* INTPROTO */ |
661 |
void |
662 |
rxvt_get_xdefaults(pR_ FILE *stream, const char *name) |
663 |
{ |
664 |
unsigned int len; |
665 |
char *str, buffer[256]; |
666 |
|
667 |
if (stream == NULL) |
668 |
return; |
669 |
len = STRLEN(name); |
670 |
while ((str = fgets(buffer, sizeof(buffer), stream)) != NULL) { |
671 |
unsigned int entry, n; |
672 |
|
673 |
while (*str && isspace(*str)) |
674 |
str++; /* leading whitespace */ |
675 |
|
676 |
if ((str[len] != '*' && str[len] != '.') |
677 |
|| (len && STRNCMP(str, name, len))) |
678 |
continue; |
679 |
str += (len + 1); /* skip `name*' or `name.' */ |
680 |
|
681 |
# ifdef KEYSYM_RESOURCE |
682 |
if (!rxvt_parse_keysym(aR_ str, NULL)) |
683 |
# endif /* KEYSYM_RESOURCE */ |
684 |
for (entry = 0; entry < optList_size(); entry++) { |
685 |
const char *kw = optList[entry].kw; |
686 |
|
687 |
if (kw == NULL) |
688 |
continue; |
689 |
n = STRLEN (kw); |
690 |
if (str[n] == ':' && rxvt_Str_match(str, kw)) { |
691 |
/* skip `keyword:' */ |
692 |
str += (n + 1); |
693 |
rxvt_Str_trim(str); |
694 |
n = STRLEN(str); |
695 |
if (n && R->rs[optList[entry].doff] == NULL) { |
696 |
/* not already set */ |
697 |
int s; |
698 |
char *p = (char *)rxvt_malloc((n + 1) * sizeof(char)); |
699 |
|
700 |
STRCPY(p, str); |
701 |
R->rs[optList[entry].doff] = p; |
702 |
if (optList_isBool(entry)) { |
703 |
s = STRCASECMP(str, "TRUE") == 0 |
704 |
|| STRCASECMP(str, "YES") == 0 |
705 |
|| STRCASECMP(str, "ON") == 0 |
706 |
|| STRCASECMP(str, "1") == 0; |
707 |
if (optList_isReverse(entry)) |
708 |
s = !s; |
709 |
if (s) |
710 |
R->Options |= (optList[entry].flag); |
711 |
else |
712 |
R->Options &= ~(optList[entry].flag); |
713 |
} |
714 |
} |
715 |
break; |
716 |
} |
717 |
} |
718 |
} |
719 |
rewind(stream); |
720 |
} |
721 |
|
722 |
/*}}} */ |
723 |
# endif /* ! USE_XGETDEFAULT */ |
724 |
#endif /* NO_RESOURCES */ |
725 |
|
726 |
/*{{{ read the resources files */ |
727 |
/* |
728 |
* using XGetDefault() or the hand-rolled replacement |
729 |
*/ |
730 |
/* ARGSUSED */ |
731 |
/* EXTPROTO */ |
732 |
void |
733 |
rxvt_extract_resources(pR_ Display *display __attribute__((unused)), const char *name) |
734 |
{ |
735 |
#ifndef NO_RESOURCES |
736 |
|
737 |
# if defined XAPPLOADDIR |
738 |
# if defined(HAVE_XSETLOCALE) || defined(HAVE_SETLOCALE) |
739 |
/* Compute the path of the possibly available localized Rxvt file */ |
740 |
char *localepath = NULL; |
741 |
|
742 |
if (R->locale != NULL) { /* XXX: must limit length of string */ |
743 |
localepath = (char *)rxvt_malloc(256); |
744 |
sprintf(localepath, XAPPLOADDIRLOCALE "/" APL_SUBCLASS, |
745 |
(int)(258 - sizeof(XAPPLOADDIRLOCALE) - sizeof(APL_SUBCLASS)), |
746 |
R->locale); /* 258 = 255 + 4 (-.*s) - 1 (/) */ |
747 |
} |
748 |
|
749 |
{ |
750 |
# endif |
751 |
# endif |
752 |
|
753 |
# ifdef USE_XGETDEFAULT |
754 |
/* |
755 |
* get resources using the X library function |
756 |
*/ |
757 |
int entry; |
758 |
|
759 |
# ifdef XrmEnumOneLevel |
760 |
int i; |
761 |
char *displayResource, *xe; |
762 |
XrmName name_prefix[3]; |
763 |
XrmClass class_prefix[3]; |
764 |
XrmDatabase database, rdb1; |
765 |
char fname[1024]; |
766 |
|
767 |
XrmInitialize(); |
768 |
database = NULL; |
769 |
|
770 |
/* Get any Xserver defaults */ |
771 |
|
772 |
displayResource = XResourceManagerString(display); |
773 |
if (displayResource != NULL) |
774 |
database = XrmGetStringDatabase(displayResource); |
775 |
|
776 |
# ifdef HAVE_EXTRA_XRESOURCE_FILES |
777 |
/* Add in ~/.Xdefaults or ~/.Xresources */ |
778 |
{ |
779 |
char *ptr; |
780 |
|
781 |
if ((ptr = (char *)getenv("HOME")) == NULL) |
782 |
ptr = "."; |
783 |
|
784 |
for (i = 0; i < (sizeof(xnames) / sizeof(xnames[0])); i++) { |
785 |
sprintf(fname, "%-.*s/%s", sizeof(fname) - STRLEN(xnames[i]) - 2, |
786 |
ptr, xnames[i]); |
787 |
if ((rdb1 = XrmGetFileDatabase(fname)) != NULL) { |
788 |
XrmMergeDatabases(rdb1, &database); |
789 |
# ifndef HAVE_BOTH_XRESOURCE_FILES |
790 |
break; |
791 |
# endif |
792 |
} |
793 |
} |
794 |
} |
795 |
# endif |
796 |
|
797 |
/* Add in XENVIRONMENT file */ |
798 |
|
799 |
if ((xe = (char *)getenv("XENVIRONMENT")) != NULL |
800 |
&& (rdb1 = XrmGetFileDatabase(xe)) != NULL) |
801 |
XrmMergeDatabases(rdb1, &database); |
802 |
|
803 |
/* Add in Rxvt file */ |
804 |
# if defined(HAVE_XSETLOCALE) || defined(HAVE_SETLOCALE) |
805 |
if (localepath == NULL || (rdb1 = XrmGetFileDatabase(localepath)) == NULL) |
806 |
# endif |
807 |
rdb1 = XrmGetFileDatabase(XAPPLOADDIR "/" APL_SUBCLASS); |
808 |
if (rdb1 != NULL) |
809 |
XrmMergeDatabases(rdb1, &database); |
810 |
|
811 |
/* Add in $XAPPLRESDIR/Rxvt only; not bothering with XUSERFILESEARCHPATH */ |
812 |
if ((xe = (char *)getenv("XAPPLRESDIR")) != NULL) { |
813 |
sprintf(fname, "%-.*s/" APL_SUBCLASS, sizeof(fname) |
814 |
- sizeof(APL_SUBCLASS) - 2, xe); |
815 |
if ((rdb1 = XrmGetFileDatabase(fname)) != NULL) |
816 |
XrmMergeDatabases(rdb1, &database); |
817 |
} |
818 |
|
819 |
XrmSetDatabase(display, database); |
820 |
# endif |
821 |
|
822 |
/* |
823 |
* Query resources for options that affect us |
824 |
*/ |
825 |
for (entry = 0; entry < optList_size(); entry++) { |
826 |
int s; |
827 |
char *p, *p0; |
828 |
const char *kw = optList[entry].kw; |
829 |
|
830 |
if (kw == NULL || R->rs[optList[entry].doff] != NULL) |
831 |
continue; /* previously set */ |
832 |
|
833 |
p = XGetDefault(display, name, kw); |
834 |
p0 = XGetDefault(display, "!INVALIDPROGRAMMENAMEDONTMATCH!", kw); |
835 |
if (p == NULL || (p0 && STRCMP(p, p0) == 0)) { |
836 |
p = XGetDefault(display, APL_SUBCLASS, kw); |
837 |
if (p == NULL || (p0 && STRCMP(p, p0) == 0)) |
838 |
p = XGetDefault(display, APL_CLASS, kw); |
839 |
} |
840 |
if (p == NULL && p0) |
841 |
p = p0; |
842 |
if (p) { |
843 |
R->rs[optList[entry].doff] = p; |
844 |
|
845 |
if (optList_isBool(entry)) { |
846 |
s = STRCASECMP(p, "TRUE") == 0 |
847 |
|| STRCASECMP(p, "YES") == 0 |
848 |
|| STRCASECMP(p, "ON") == 0 |
849 |
|| STRCASECMP(p, "1") == 0; |
850 |
if (optList_isReverse(entry)) |
851 |
s = !s; |
852 |
if (s) |
853 |
R->Options |= (optList[entry].flag); |
854 |
else |
855 |
R->Options &= ~(optList[entry].flag); |
856 |
} |
857 |
} |
858 |
} |
859 |
|
860 |
/* |
861 |
* [R5 or later]: enumerate the resource database |
862 |
*/ |
863 |
# ifdef XrmEnumOneLevel |
864 |
# ifdef KEYSYM_RESOURCE |
865 |
name_prefix[0] = XrmStringToName(name); |
866 |
name_prefix[1] = XrmStringToName("keysym"); |
867 |
name_prefix[2] = NULLQUARK; |
868 |
class_prefix[0] = XrmStringToName(APL_SUBCLASS); |
869 |
class_prefix[1] = XrmStringToName("Keysym"); |
870 |
class_prefix[2] = NULLQUARK; |
871 |
/* XXX: Need to check sizeof(rxvt_t) == sizeof(XPointer) */ |
872 |
XrmEnumerateDatabase(XrmGetDatabase(display), name_prefix, class_prefix, |
873 |
XrmEnumOneLevel, rxvt_define_key, NULL); |
874 |
name_prefix[0] = XrmStringToName(APL_CLASS); |
875 |
name_prefix[1] = XrmStringToName("keysym"); |
876 |
class_prefix[0] = XrmStringToName(APL_CLASS); |
877 |
class_prefix[1] = XrmStringToName("Keysym"); |
878 |
/* XXX: Need to check sizeof(rxvt_t) == sizeof(XPointer) */ |
879 |
XrmEnumerateDatabase(XrmGetDatabase(display), name_prefix, class_prefix, |
880 |
XrmEnumOneLevel, rxvt_define_key, NULL); |
881 |
# endif |
882 |
# endif |
883 |
|
884 |
# else /* USE_XGETDEFAULT */ |
885 |
/* get resources the hard way, but save lots of memory */ |
886 |
FILE *fd = NULL; |
887 |
char *home; |
888 |
|
889 |
if ((home = getenv("HOME")) != NULL) { |
890 |
unsigned int i, len = STRLEN(home) + 2; |
891 |
char *f = NULL; |
892 |
|
893 |
for (i = 0; i < (sizeof(xnames) / sizeof(xnames[0])); i++) { |
894 |
f = (char *)rxvt_realloc(f, (len + STRLEN(xnames[i])) * sizeof(char)); |
895 |
|
896 |
sprintf(f, "%s/%s", home, xnames[i]); |
897 |
|
898 |
if ((fd = fopen(f, "r")) != NULL) |
899 |
break; |
900 |
} |
901 |
free(f); |
902 |
} |
903 |
/* |
904 |
* The normal order to match resources is the following: |
905 |
* @ global resources (partial match, ~/.Xdefaults) |
906 |
* @ application file resources (XAPPLOADDIR/Rxvt) |
907 |
* @ class resources (~/.Xdefaults) |
908 |
* @ private resources (~/.Xdefaults) |
909 |
* |
910 |
* However, for the hand-rolled resources, the matching algorithm |
911 |
* checks if a resource string value has already been allocated |
912 |
* and won't overwrite it with (in this case) a less specific |
913 |
* resource value. |
914 |
* |
915 |
* This avoids multiple allocation. Also, when we've called this |
916 |
* routine command-line string options have already been applied so we |
917 |
* needn't to allocate for those resources. |
918 |
* |
919 |
* So, search in resources from most to least specific. |
920 |
* |
921 |
* Also, use a special sub-class so that we can use either or both of |
922 |
* "XTerm" and "Rxvt" as class names. |
923 |
*/ |
924 |
|
925 |
rxvt_get_xdefaults(aR_ fd, name); |
926 |
rxvt_get_xdefaults(aR_ fd, APL_SUBCLASS); |
927 |
|
928 |
# if defined(XAPPLOADDIR) && defined(USE_XAPPLOADDIR) |
929 |
{ |
930 |
FILE *ad = NULL; |
931 |
|
932 |
# if defined(HAVE_XSETLOCALE) || defined(HAVE_SETLOCALE) |
933 |
if (localepath == NULL || (ad = fopen(localepath, "r")) == NULL) |
934 |
# endif |
935 |
ad = fopen(XAPPLOADDIR "/" APL_SUBCLASS, "r"); |
936 |
if (ad != NULL) { |
937 |
rxvt_get_xdefaults(aR_ ad, APL_SUBCLASS); |
938 |
rxvt_get_xdefaults(aR_ ad, ""); |
939 |
fclose(ad); |
940 |
} |
941 |
} |
942 |
# endif /* XAPPLOADDIR */ |
943 |
|
944 |
rxvt_get_xdefaults(aR_ fd, APL_CLASS); |
945 |
rxvt_get_xdefaults(aR_ fd, ""); /* partial match */ |
946 |
if (fd != NULL) |
947 |
fclose(fd); |
948 |
# endif /* USE_XGETDEFAULT */ |
949 |
|
950 |
# if defined XAPPLOADDIR |
951 |
# if defined(HAVE_XSETLOCALE) || defined(HAVE_SETLOCALE) |
952 |
} |
953 |
|
954 |
/* Free the path of the possibly available localized Rxvt file */ |
955 |
free(localepath); |
956 |
# endif |
957 |
# endif |
958 |
|
959 |
#endif /* NO_RESOURCES */ |
960 |
|
961 |
/* |
962 |
* even without resources, at least do this setup for command-line |
963 |
* options and command-line long options |
964 |
*/ |
965 |
#ifdef MULTICHAR_SET |
966 |
rxvt_set_multichar_encoding(aR_ R->rs[Rs_multichar_encoding]); |
967 |
#endif |
968 |
#ifdef GREEK_SUPPORT |
969 |
/* this could be a function in grkelot.c */ |
970 |
/* void set_greek_keyboard (const char * str); */ |
971 |
if (R->rs[Rs_greek_keyboard]) { |
972 |
if (!STRCMP(R->rs[Rs_greek_keyboard], "iso")) |
973 |
greek_setmode(GREEK_ELOT928); /* former -grk9 */ |
974 |
else if (!STRCMP(R->rs[Rs_greek_keyboard], "ibm")) |
975 |
greek_setmode(GREEK_IBM437); /* former -grk4 */ |
976 |
} |
977 |
{ |
978 |
KeySym sym; |
979 |
|
980 |
if (R->rs[Rs_greektoggle_key] |
981 |
&& ((sym = XStringToKeysym(R->rs[Rs_greektoggle_key])) != 0)) |
982 |
R->ks_greekmodeswith = sym; |
983 |
} |
984 |
#endif /* GREEK_SUPPORT */ |
985 |
|
986 |
#if defined (HOTKEY_CTRL) || defined (HOTKEY_META) |
987 |
{ |
988 |
KeySym sym; |
989 |
|
990 |
if (R->rs[Rs_bigfont_key] |
991 |
&& ((sym = XStringToKeysym(R->rs[Rs_bigfont_key])) != 0)) |
992 |
R->ks_bigfont = sym; |
993 |
if (R->rs[Rs_smallfont_key] |
994 |
&& ((sym = XStringToKeysym(R->rs[Rs_smallfont_key])) != 0)) |
995 |
R->ks_smallfont = sym; |
996 |
} |
997 |
#endif |
998 |
} |
999 |
|
1000 |
/*}}} */ |
1001 |
/*----------------------- end-of-file (C source) -----------------------*/ |