source: trunk/j/doc/preferences.html @ 4495

Last change on this file since 4495 was 4495, checked in by piso, 19 years ago

antialias

File size: 48.4 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2
3<html>
4
5<head>
6<title>Preferences</title>
7<LINK REL="stylesheet" HREF="j.css" TYPE="text/css">
8</head>
9
10<body>
11
12<a href="contents.html">Top</a>
13
14<hr>
15
16<h1>Preferences</h1>
17
18<hr>
19
20<p>
21
22Preferences are read from a file named <code>prefs</code> in the
23<code>.j</code> directory. This directory is created automatically by j in the
24home directory of the current user.
25
26<p>
27
28On Windows, from j's point of view, the home directory of the current user
29normally defaults to <code>C:\</code>. The default is actually the root
30directory of the first writable drive, excluding drives A and B.
31
32<p>
33
34So, by default, your preferences file is <code>~/.j/prefs</code> on Unix and
35<code>C:\.j\prefs</code> on Windows.
36
37<p>
38
39You can specify a different home directory by starting j with the
40<code>--home</code> command line option:
41<pre>
42    j --home=C:\ArmedBear
43</pre>
44In this case your home directory, as far as j is concerned, will be
45<code>C:\ArmedBear</code>, the <code>.j</code> directory will be
46<code>C:\ArmedBear\.j</code>, and your preferences file will be
47<code>C:\ArmedBear\.j\prefs</code>.
48
49<p>
50
51The <code>--home</code> command line option is available on Unix as well as
52Windows.
53
54<p>
55
56The preferences file is an ordinary text file which will not exist until you
57specifically create it. You can open this file in j by simply specifying
58"prefs" in the Open File dialog or on the command line.
59
60<p>
61
62Each entry in the preferences file must be on a line by itself and must be
63of the form:
64<pre>
65    key=value
66</pre>
67Comments start with #, and values (but not keys) may contain embedded spaces.
68String values may be enclosed in double quotes. Property names (keys) are not
69case-sensitive, so "lineuparglist" and "lineUpArgList" (and, for that matter,
70"LINEUParglist" and "LiNeUpArGlIsT") are, in effect, the same as
71"lineupArglist", which is actually the official spelling.
72<p>
73Here's an example for Unix:
74
75<pre>
76  #
77  # Unix
78  # Path separator is colon.
79  #
80  sourcePath=/home/peter/j/src/org/armedbear/j:/home/peter/j/src
81  includePath=/usr/include:/usr/src/linux/include/linux
82  docPath=/home/peter/j/doc
83</pre>
84<p>
85Here's a similar example for Windows:
86<pre>
87  #
88  # Windows
89  # Path separator is semicolon.
90  # Note that double backslashes are required!
91  #
92  sourcePath=C:\\j\\src\\org\\armedbear\\j;C:\\j\\src
93  includePath=C:\\Program Files\\DevStudio\\vc\\include
94  docPath=C:\\j\\doc
95</pre>
96<p>
97If you use j to edit your preferences file, the running instance of j
98automatically reloads your preferences when you save the changes to the file,
99so in most cases it is not necessary to restart j in order to pick up the new
100settings.
101<p>
102Many properties (notably colors, styles, and properties such as tab width and
103indent size) may be set globally and overridden on a mode-specific basis.  For
104example:
105<pre>
106    color.text=black
107    color.comment=gray
108    JavaMode.color.text=blue
109    JavaMode.color.comment=0 128 0
110    indentSize=8
111    JavaMode.indentSize=4
112</pre>
113Colors are normally specified by their RGB values:
114<pre>
115    color.selectionBackground=153 204 255</pre>
116Common colors may be specified by name:
117<pre>
118    color.text=black</pre>
119<p>
120The following properties are supported:
121<br><br>
122
123<code><a name="adjustAscent">adjustAscent</a></code>
124<dl>
125<dd>
126Amount to be added to the default ascent for the current display font (a
127negative value can be specified).
128<p>
129<b>See also:</b> <a href="#adjustDescent">adjustDescent</a>,
130<a href="#adjustLeading">adjustLeading</a>
131<p>
132<b>Default value:</b> 0
133</dl>
134
135<code><a name="adjustDescent">adjustDescent</a></code>
136<dl>
137<dd>
138Amount to be added to the default descent for the current display font (a
139negative value can be specified).
140<p>
141<b>See also:</b> <a href="#adjustAscent">adjustAscent</a>,
142<a href="#adjustLeading">adjustLeading</a>
143<p>
144<b>Default value:</b> 0
145</dl>
146
147<code><a name="adjustLeading">adjustLeading</a></code>
148<dl>
149<dd>
150Amount to be added to the default leading for the current display font (a
151negative value can be specified).
152<p>
153<b>See also:</b> <a href="#adjustAscent">adjustAscent</a>,
154<a href="#adjustDescent">adjustDescent</a>
155<p>
156<b>Default value:</b> 0
157</dl>
158
159<code><a name="antialias">antialias</a></code>
160<dl>
161<dd>
162If true, j uses the antialiasing supported by Java2D. This may make things look
163better, or it may make things look worse.
164<p>
165<b>Default value:</b> false
166</dl>
167
168<code><a name="attributesRequireQuotes">attributesRequireQuotes</a></code>
169<dl>
170<dd>
171If true, in HTML mode <a href="commands.html#electricEquals">electricEquals</a>
172automatically inserts a pair of quotation marks after the '=' following an
173attribute name, making it possible to enclose attribute values in quotation
174marks without having to type the quotation marks themselves.
175<p>
176This property is ignored in XML mode; attribute values in XML are always
177enclosed in quotation marks.
178<p>
179<b>Default value:</b> true
180</dl>
181
182<code><a name="attribution">attribution</a></code>
183<dl>
184<dd>
185Template for the string that precedes a message that is quoted in a reply.
186<p>
187A couple of substitutions are supported:
188<pre>
189        %d      date and time of the original message
190        %n      sender's name (or address if name is missing)</pre>
191<p>
192<b>Default value:</b> "On %d, %n wrote:"
193</dl>
194
195<code><a name="autoIndent">autoIndent</a></code>
196<dl>
197<dd>
198If true, the functions
199<a href="commands.html#electricCloseAngleBracket">electricCloseAngleBracket</a>,
200<a href="commands.html#htmlEndTag">htmlEndTag</a>,
201<a href="commands.html#htmlInsertTag">htmlInsertTag</a>,
202<a href="commands.html#htmlBold">htmlBold</a> and
203<a href="commands.html#xmlElectricSlash">xmlElectricSlash</a> automatically
204re-indent the current line according to context. This property only applies to
205HTML and XML modes.
206<p>
207<b>Default value:</b> true
208</dl>
209
210<code><a name="autoNewline">autoNewline</a></code>
211<dl>
212<dd>
213If true, the functions
214<a href="commands.html#electricOpenBrace">electricOpenBrace</a>,
215<a href="commands.html#electricCloseBrace">electricCloseBrace</a>,
216<a href="commands.html#electricColon">electricColon</a> and
217<a href="commands.html#electricSemi">electricSemi</a>
218automatically insert a line separator.
219<p>
220<b>Default value:</b> false
221</dl>
222
223<code><a name="autoPasteLines">autoPasteLines</a></code>
224<dl>
225<dd>
226If true, <a href="commands.html#paste">paste</a> inserts text that ends with a
227line separator above the line containing the caret, as if the caret were in the
228first column of the line, even if that is not the case. The intention behind
229this is to make it easy to cut and paste whole lines of text (or blocks of
230lines), without having to move the caret to the beginning of the line. If
231possible, the indentation of the inserted lines is corrected to match their new
232context.
233<p>
234If false, the inserted text is always placed at the exact location of the caret.
235<p>
236<b>Default value:</b> true
237</dl>
238
239<code><a name="autoReloadKeyMaps">autoReloadKeyMaps</a></code>
240<dl>
241<dd>
242If true, custom key maps are reloaded automatically after you use j to edit
243them (and save the changes). Ad hoc key mappings (including mappings made in
244<a href="init.lisp.html">init.lisp</a>) in the same scope (i.e. global or for a
245particular mode) are discarded.
246<p>
247<b>Default value:</b> false
248<p>
249<b>See also:</b> <a href="keys.html">Key Mappings</a>
250</dl>
251
252<code><a name="autosaveNamedSessions">autosaveNamedSessions</a></code>
253<dl>
254<dd>
255If true, session information is automatically saved to the active named
256session file, as necessary.
257<p>
258If false, the information in the named session file is only updated when you
259explicitly invoke <a href="commands.html#saveSession">saveSession</a>.
260<p>
261<b>Default value:</b> false
262<p>
263<b>See also:</b> <a href="sessions.html">Sessions</a>
264</dl>
265
266<code><a name="autoSelectLine">autoSelectLine</a></code>
267<dl>
268<dd>
269If true, <a href="#selectDown">selectDown</a> and
270<a href="#selectUp">selectUp</a>, when invoked with no selection in effect,
271select the current line in its entirety, rather than beginning a stream
272selection at the exact location of the caret.
273<p>
274<b>Default value:</b> true
275</dl>
276
277<code><a name="backupDirectory">backupDirectory</a></code>
278<dl>
279<dd>
280Pathname of directory where backup files will be stored.
281<p>
282<b>Default value:</b> None
283</dl>
284
285<code><a name="bcc">bcc</a></code>
286<dl>
287<dd>
288Address to which automatic blind copies of outgoing mail messages should be
289sent.
290<p>
291<b>Default value:</b> None
292<p>
293<b>See also:</b> <a href="mail.html">Mail</a>
294</dl>
295
296<code><a name="blinkCaret">blinkCaret</a></code>
297<dl>
298<dd>
299If true, the caret blinks.
300<p>
301<b>Default value:</b> true
302</dl>
303
304<code><a name="browser">browser</a></code>
305<dl>
306<dd>
307Command to invoke your favorite external browser.
308<p>
309<b>Default value:</b> None
310</dl>
311
312<code><a name="browserOpts">browserOpts</a></code>
313<dl>
314<dd>
315Command line options to use when invoking the external browser.
316<p>
317<b>Default value:</b> None
318</dl>
319
320<code><a name="changeMarkWidth">changeMarkWidth</a></code>
321<dl>
322<dd>
323Width (in pixels) of change marks, which appear in the edit window if
324<a href="#showChangeMarks">showChangeMarks</a> is true.
325<p>
326<b>Default value:</b> 4
327<p>
328<b>See also:</b>
329<a href="#color.change">color.change</a>,
330<a href="#color.savedChange">color.savedChange</a>,
331<a href="#showChangeMarks">showChangeMarks</a>,
332<a href="commands.html#nextChange">nextChange</a>,
333<a href="commands.html#previousChange">previousChange</a>
334</dl>
335
336<code><a name="checkEnabled">checkEnabled</a></code>
337<dl>
338<dd>
339<i>Not documented.</i>
340<p>
341<b>Default value:</b> false
342</dl>
343
344<code><a name="checkIdleBackground">checkIdleBackground</a></code>
345<dl>
346<dd>
347<i>Not documented.</i>
348<p>
349<b>Default value:</b> 10
350</dl>
351
352<code><a name="checkIdleForeground">checkIdleForeground</a></code>
353<dl>
354<dd>
355<i>Not documented.</i>
356<p>
357<b>Default value:</b> 60
358</dl>
359
360<code><a name="checkInterval">checkInterval</a></code>
361<dl>
362<dd>
363<i>Not documented.</i>
364<p>
365<b>Default value:</b> 60
366</dl>
367
368<code><a name="clhsRoot">clhsRoot</a></code>
369<dl>
370<dd>
371The location of the local copy of the Common Lisp Hyperspec.
372<p>
373<b>Default value:</b> /usr/share/doc/hyperspec
374<p>
375<b>See also:</b> <a href="commands.html#hyperspec">hyperspec</a>
376</dl>
377
378<code><a name="color.background">color.background</a></code>
379<dl>
380<dd>
381Default background color.
382<p>
383<b>Default value:</b> None
384</dl>
385
386<code><a name="color.brace">color.brace</a></code>
387<dl>
388<dd>
389Color for braces in Java, JavaScript, C and C++ files.
390<p>
391<b>Default value:</b> None
392</dl>
393
394<code><a name="color.caret">color.caret</a></code>
395<dl>
396<dd>
397Color of the caret. If you don't specify a value for this property, the caret
398will be drawn in the default text color.
399<p>
400<b>Default value:</b> None
401</dl>
402
403<code><a name="color.change">color.change</a></code>
404<dl>
405<dd>
406Color for change marks that identify lines containing unsaved changes (i.e.
407lines that have been modified since the buffer was last saved).
408<p>
409<b>Default value:</b> None
410<p>
411<b>See also:</b>
412<a href="#color.savedChange">color.savedChange</a>,
413<a href="#changeMarkWidth">changeMarkWidth</a>,
414<a href="#showChangeMarks">showChangeMarks</a>,
415<a href="commands.html#nextChange">nextChange</a>,
416<a href="commands.html#previousChange">previousChange</a>
417</dl>
418
419<code><a name="color.comment">color.comment</a></code>
420<dl>
421<dd>
422Color for comments.
423<p>
424<b>Default value:</b> None
425</dl>
426
427<code><a name="color.currentLineBackground">color.currentLineBackground</a></code>
428<dl>
429<dd>
430Background color for line containing caret.
431<p>
432<b>Default value:</b> None
433</dl>
434
435<code><a name="color.disabled">color.disabled</a></code>
436<dl>
437<dd>
438Color for areas between #if 0 and the corresponding #endif in C and C++ files.
439<p>
440<b>Default value:</b> None
441</dl>
442
443<code><a name="color.function">color.function</a></code>
444<dl>
445<dd>
446Color for function names.
447<p>
448<b>Default value:</b> None
449</dl>
450
451<code><a name="color.gutterBorder">color.gutterBorder</a></code>
452<dl>
453<dd>
454Color for the vertical border that separates the line number area (the gutter)
455from the text in the buffer, if line numbering is enabled.
456<p>
457<b>Default value:</b> None
458<p>
459<b>See also:</b> <a href="#color.lineNumber">color.lineNumber</a>,
460<a href="#showLineNumbers">showLineNumbers</a>
461</dl>
462
463<code><a name="color.headerName">color.headerName</a></code>
464<dl>
465<dd>
466Color for header names in List Occurrences and Message buffers.
467<p>
468<b>Default value:</b> None
469</dl>
470
471<code><a name="color.headerValue">color.headerValue</a></code>
472<dl>
473<dd>
474Color for header values in List Occurrences and Message buffers.
475<p>
476<b>Default value:</b> None
477</dl>
478
479<code><a name="color.keyword">color.keyword</a></code>
480<dl>
481<dd>
482Color for programming language keywords.
483<p>
484<b>Default value:</b> None
485</dl>
486
487<code><a name="color.lineNumber">color.lineNumber</a></code>
488<dl>
489<dd>
490Color for line numbers.
491<p>
492<b>Default value:</b> None
493<p>
494<b>See also:</b> <a href="#color.gutterBorder">color.gutterBorder</a>,
495<a href="#showLineNumbers">showLineNumbers</a>
496</dl>
497
498<code><a name="color.matchingText">color.matchingText</a></code>
499<dl>
500<dd>
501Color for text matching the search pattern in List Occurrences buffers.
502<p>
503<b>Default value:</b> None
504</dl>
505
506<code><a name="color.number">color.number</a></code>
507<dl>
508<dd>
509Color for numbers.
510<p>
511<b>Default value:</b> None
512</dl>
513
514<code><a name="color.operator">color.operator</a></code>
515<dl>
516<dd>
517Color for operators (e.g. "==").
518<p>
519<b>Default value:</b> None
520</dl>
521
522<code><a name="color.preprocessor">color.preprocessor</a></code>
523<dl>
524<dd>
525Color for preprocessor directives in C and C++ files.
526<p>
527<b>Default value:</b> None.
528</dl>
529
530<code><a name="color.savedChange">color.savedChange</a></code>
531<dl>
532<dd>
533Color for change marks that identify lines containing saved changes (i.e.
534lines that were modified in the current session but which have not been
535modified since the buffer was last saved).
536<p>
537<b>Default value:</b> None
538<p>
539<b>See also:</b>
540<a href="#color.change">color.change</a>,
541<a href="#changeMarkWidth">changeMarkWidth</a>,
542<a href="#showChangeMarks">showChangeMarks</a>,
543<a href="commands.html#nextChange">nextChange</a>,
544<a href="commands.html#previousChange">previousChange</a>
545</dl>
546
547<code><a name="color.selectionBackground">color.selectionBackground</a></code>
548<dl>
549<dd>
550Background color for selected text.
551<p>
552<b>Default value:</b> None
553</dl>
554
555<code><a name="color.string">color.string</a></code>
556<dl>
557<dd>
558Color for quoted strings.
559<p>
560<b>Default value:</b> None
561</dl>
562
563<code><a name="color.text">color.text</a></code>
564<dl>
565<dd>
566Default text color.
567<p>
568<b>Default value:</b> None
569</dl>
570
571<code><a name="color.verticalRule">color.verticalRule</a></code>
572<dl>
573<dd>
574Color for vertical rule.
575<p>
576<b>Default value:</b> None
577<p>
578<b>See also:</b> <a href="#verticalRule">verticalRule</a>
579</dl>
580
581<code><a name="confirmSend">confirmSend</a></code>
582<dl>
583<dd>
584If true, a confirmation dialog is displayed when you send a mail message. The
585dialog allows you to change the "From" and "Bcc" addresses and specify which
586SMTP server to use.
587<p>
588<b>Default value:</b> false
589</dl>
590
591<code><a name="debug">debug</a></code>
592<dl>
593<dd>
594If true, debugging is enabled.
595<p>
596When debugging is enabled, debugging information is logged (in addition to
597errors), and all output sent to the log file is also sent to System.err, so it
598can be seen in the console window from which j was started.
599<p>
600<b>Default value:</b> false
601<p>
602<b>See also:</b> <a href="logging.html">Logging</a>
603</dl>
604
605<code><a name="defaultEncoding">defaultEncoding</a></code>
606<dl>
607<dd>
608Character encoding to use when loading and saving files.
609<p>
610<b>Default value:</b> ISO8859_1
611</dl>
612
613<code><a name="dialogFontName">dialogFontName</a></code>
614<dl>
615<dd>
616Name of dialog font (which is used for menus, toolbars, and sidebar components
617as well as dialogs).
618<p>
619<b>Default value:</b> None
620<p>
621<b>See also:</b> <a href="#dialogFontSize">dialogFontSize</a>,
622<a href="#fontName">fontName</a>, <a href="#gutterFontName">gutterFontName</a>,
623<a href="#textFieldFontName">textFieldFontName</a>
624</dl>
625
626<code><a name="dialogFontSize">dialogFontSize</a></code>
627<dl>
628<dd>
629Size (in points) of dialog font (which is used for menus, toolbars, and
630sidebar components as well as dialogs).
631<p>
632<b>Default value:</b> 11
633<p>
634<b>See also:</b> <a href="#dialogFontName">dialogFontName</a>,
635<a href="#fontSize">fontSize</a>, <a href="#gutterFontSize">gutterFontSize</a>,
636<a href="#textFieldFontSize">textFieldFontSize</a>
637</dl>
638
639<code><a name="DirectoryMode.color.directory">DirectoryMode.color.directory</a></code>
640<dl>
641<dd>
642Color for directories in directory buffers.
643<p>
644<b>Default value:</b> None
645</dl>
646
647<code><a name="DirectoryMode.color.marked">DirectoryMode.color.marked</a></code>
648<dl>
649<dd>
650Color for marked files in directory buffers.
651<p>
652<b>Default value:</b> None
653</dl>
654
655<code><a name="DirectoryMode.color.symlink">DirectoryMode.color.symlink</a></code>
656<dl>
657<dd>
658Color for symbolic links in directory buffers.
659<p>
660<b>Default value:</b> None
661</dl>
662
663<code><a name="DirectoryMode.enableTree">DirectoryMode.enableTree</a></code>
664<dl>
665<dd>
666If true, a directory tree is displayed in the sidebar in Directory mode.
667<p>
668<b>Default value:</b> true
669</dl>
670
671<code><a name="dirSortDirectoriesFirst">dirSortDirectoriesFirst</a></code>
672<dl>
673<dd>
674If true, directories appear grouped together at the top of directory
675buffers, followed by ordinary files.
676<p>
677<b>Default value:</b> <code>!dirUseNativeFormat</code>
678</dl>
679
680<code><a name="dirUseNativeFormat">dirUseNativeFormat</a></code>
681<dl>
682<dd>
683If true, directory buffers use <code>ls</code> to generate the directory
684listing. This only works if you have a copy of <code>ls</code> in your
685path. If false, j's built-in directory format is used (and less
686information is displayed).
687<p>
688<b>Default value:</b> false for Windows, true for Unix
689</dl>
690
691<code><a name="docPath">docPath</a></code>
692<dl>
693<dd>
694Full path of directory containing j's documentation.
695<p>
696<b>Default value:</b> None
697</dl>
698
699<code><a name="emulateBold">emulateBold</a></code>
700<dl>
701<dd>
702If true, j will emulate a bold font by doing a paint trick with the plain
703font. This is only useful if you're actually using a font that needs this
704special treatment (such as Lucida Console on Windows).
705<p>
706<b>Default value:</b> false
707</dl>
708
709<code><a name="enableDragText">enableDragText</a></code>
710<dl>
711<dd>
712If true, drag/drop of text is enabled.
713<p>
714<b>Default value:</b> true
715</dl>
716
717<code><a name="enableExperimentalFeatures">enableExperimentalFeatures</a></code>
718<dl>
719<dd>
720If true, j's undocumented and experimental features are enabled.
721<p>
722<b>Default value:</b> false
723</dl>
724
725<code><a name="enableItalics">enableItalics</a></code>
726<dl>
727<dd>
728If false, j won't use an italic font for syntax highlighting even if one is
729specified by the current theme.
730<p>
731<b>Default value:</b> true
732</dl>
733
734<code><a name="enableTree">enableTree</a></code>
735<dl>
736<dd>
737If true, a tree representing the document you are editing is displayed in
738the sidebar in XML mode.
739<p>
740<b>Default value:</b> true
741</dl>
742
743<code><a name="extendEnd">extendEnd</a></code>
744<dl>
745<dd>
746If true, special behavior is triggered when
747<a href="commands.html#end">end</a> is invoked repeatedly in quick sequence.
748See <a href="commands.html#end">end</a> for details.
749<p>
750<b>Default value:</b> false
751</dl>
752
753<code><a name="extendHome">extendHome</a></code>
754<dl>
755<dd>
756If true, special behavior is triggered when
757<a href="commands.html#home">home</a> is invoked repeatedly in quick sequence.
758See <a href="commands.html#home">home</a> for details.
759<p>
760<b>Default value:</b> false
761</dl>
762
763<code><a name="extension">extension</a></code>
764<dl>
765<dd>
766Name of extension class. If the name ends in <code>.class</code>, it is taken
767to be a filename, rather than a class name, and in that case the file's
768absolute pathname may be specified.  If the absolute pathname is not specified,
769or if the <code>.class</code> extension is omitted, the class file in question
770must be in the directory <code>~/.j</code> (Unix) or <code>C:\.j</code>
771(Windows). When j starts up, the specified extension class is loaded by j's
772extension class loader, a new instance of the extension class is created, and
773its <code>public void run</code> method is invoked.
774<p>
775<b>Default value:</b> None
776</dl>
777
778<code><a name="filenameCompletionsIgnoreCase">filenameCompletionsIgnoreCase</a></code>
779<dl>
780<dd>
781If true, filename completions (in the Open File dialog, for example) ignore
782case on non-Windows platforms. (Filename completions always ignore case on
783Windows.)
784<p>
785<b>Default value:</b> true
786</dl>
787
788<code><a name="fontName">fontName</a></code>
789<dl>
790<dd>
791Name of display font.
792<p>
793<b>Default value:</b> Monospaced
794<p>
795<b>See also:</b> <a href="fontSize">fontSize</a>,
796<a href="#dialogFontName">dialogFontName</a>,
797<a href="#gutterFontName">gutterFontName</a>
798</dl>
799
800<code><a name="fontSize">fontSize</a></code>
801<dl>
802<dd>
803Display font size (in points).
804<p>
805<b>Default value:</b> 12
806<p>
807<b>See also:</b> <a href="fontName">fontName</a>,
808<a href="#dialogFontSize">dialogFontSize</a>,
809<a href="#gutterFontSize">gutterFontSize</a>
810</dl>
811
812<code><a name="ftpUsePassiveMode">ftpUsePassiveMode</a></code>
813<dl>
814<dd>
815If true, passive mode is used for FTP operations.
816<p>
817<b>Default value:</b> true
818</dl>
819
820<code><a name="globalKeyMap">globalKeyMap</a></code>
821<dl>
822<dd>
823Pathname of file containing global key map. J will load the global key map from
824the specified file, rather than using its internal defaults.  The specified
825file must be in the format used by <code>writeGlobalKeyMap</code>.
826<p>
827<b>Default value:</b> None
828</dl>
829
830<code><a name="gutterFontName">gutterFontName</a></code>
831<dl>
832<dd>
833Name of font used for line numbers.
834<p>
835<b>Default value:</b> Same as normal display font
836<p>
837<b>See also:</b> <a href="#gutterFontSize">gutterFontSize</a>,
838<a href="#fontName">fontName</a>,
839<a href="#dialogFontName">dialogFontName</a>,
840<a href="#showLineNumbers">showLineNumbers</a>
841</dl>
842
843<code><a name="gutterFontSize">gutterFontSize</a></code>
844<dl>
845<dd>
846Font size (in points) used for line numbers.
847<p>
848<b>Default value:</b> Same as normal display font
849<p>
850<b>See also:</b> <a href="#gutterFontName">gutterFontName</a>,
851<a href="#fontSize">fontSize</a>,
852<a href="#dialogFontSize">dialogFontSize</a>,
853<a href="#showLineNumbers">showLineNumbers</a>
854</dl>
855
856<code><a name="highlightBrackets">highlightBrackets</a></code>
857<dl>
858<dd>
859If true, when the caret is immediately before an opening parenthesis, bracket
860or brace, or immediately after a closing parenthesis, bracket or brace, the
861pair of matching parentheses, braces, or brackets is highlighted.
862<p>
863<b>Default value:</b> false
864<p>
865<b>See also:</b> <a href="#highlightMatchingBracket">highlightMatchingBracket</a>
866</dl>
867
868<code><a name="highlightMatchingBracket">highlightMatchingBracket</a></code>
869<dl>
870<dd>
871If true, when the caret is immediately before an opening parenthesis, bracket
872or brace, or immediately after a closing parenthesis, bracket or brace, the
873matching parenthesis, brace, or bracket, if any, is highlighted.
874<p>
875<b>Default value:</b> false
876<p>
877<b>See also:</b> <a href="#highlightBrackets">highlightBrackets</a>
878</dl>
879
880<code><a name="HtmlMode.color.anchor">HtmlMode.color.anchor</a></code>
881<dl>
882<dd>
883<p>
884<b>Default value:</b> None
885</dl>
886
887<code><a name="HtmlMode.color.comment">HtmlMode.color.comment</a></code>
888<dl>
889<dd>
890<p>
891<b>Default value:</b> None
892</dl>
893
894<code><a name="HtmlMode.color.image">HtmlMode.color.image</a></code>
895<dl>
896<dd>
897<p>
898<b>Default value:</b> None
899</dl>
900
901<code><a name="HtmlMode.color.script">HtmlMode.color.script</a></code>
902<dl>
903<dd>
904<p>
905<b>Default value:</b> None
906</dl>
907
908<code><a name="HtmlMode.color.table">HtmlMode.color.table</a></code>
909<dl>
910<dd>
911<p>
912<b>Default value:</b> None
913</dl>
914
915<code><a name="HtmlMode.color.tableData">HtmlMode.color.tableData</a></code>
916<dl>
917<dd>
918<p>
919<b>Default value:</b> None
920</dl>
921
922<code><a name="HtmlMode.color.tableRow">HtmlMode.color.tableRow</a></code>
923<dl>
924<dd>
925<p>
926<b>Default value:</b> None
927</dl>
928
929<code><a name="HtmlMode.color.tag">HtmlMode.color.tag</a></code>
930<dl>
931<dd>
932<p>
933<b>Default value:</b> None
934</dl>
935
936<code><a name="HtmlMode.fixCase">HtmlMode.fixCase</a></code>
937<dl> <dd>
938If true, tag and attribute names in HTML buffers are automatically converted to
939the preferred case, as specified by <a href="#HtmlMode.upperCaseTagNames">HtmlMode.upperCaseTagNames</a> and
940<a href="#HtmlMode.upperCaseAttributeNames">HtmlMode.upperCaseAttributeNames</a>.
941<p>
942<b>Default value:</b> false
943</dl>
944
945<code><a name="HtmlMode.tags">HtmlMode.tags</a></code>
946<dl> <dd>
947Pathname of file containing tag customizations for HTML mode.  Lines in this file
948should look like this:
949<pre>
950        p=0
951</pre>
952This line tells j not to insert an end tag for the &lt;P&gt; tag.  If you do want
953the end tag, use:
954<pre>
955        p=1
956</pre>
957It's not necessary to use a tag customization file unless you take issue with
958j's internal defaults. If you do use a tag customization file, it only needs to
959contain entries for the tags you want to customize.
960<p>
961<b>Default value:</b> None
962</dl>
963
964<code><a name="HtmlMode.upperCaseAttributeNames">HtmlMode.upperCaseAttributeNames</a></code>
965<dl> <dd>
966If true, upper case is preferred for attribute names in HTML mode; otherwise,
967lower case is preferred.  If <a href="#HtmlMode.fixCase">HtmlMode.fixCase</a> is true,
968attribute names are automatically converted to the preferred case as you type them in.
969<p>
970<b>Default value:</b> false
971</dl>
972
973<code><a name="HtmlMode.upperCaseTagNames">HtmlMode.upperCaseTagNames</a></code>
974<dl> <dd>
975If true, upper case is preferred for tag names in HTML mode; otherwise,
976lower case is preferred. If <a href="#HtmlMode.fixCase">HtmlMode.fixCase</a> is true,
977tag names are automatically converted to the preferred case as you type them in.
978<p>
979<b>Default value:</b> true
980</dl>
981
982<code><a name="httpProxy">httpProxy</a></code>
983<dl>
984<dd>
985Host name (or IP address) and port of proxy server to use for HTTP operations.
986<p>
987Example:
988<pre>
989    httpProxy=192.168.1.1:3128</pre>
990<p>
991<b>Default value:</b> None
992</dl>
993
994<code><a name="imapUseLocalCache">imapUseLocalCache</a></code>
995<dl>
996<dd>
997If true, j saves a local copy of each IMAP message that you read. If you
998reread the message later, j will get it from the cache instead of pulling the
999same bits over the network again. This is particularly useful if you have a
1000slow network connection.
1001<p>
1002Each message is saved in a file named after its UID, in a directory specific
1003to the mailbox in question, under ~/.j/mail/imap/cache.
1004<p>
1005Deleted messages are automatically removed from the cache by
1006<a href="commands.html#mailboxExpunge">mailboxExpunge</a>. The current
1007implementation has no concept of expiration or aging of undeleted messages and
1008imposes no limit on utilization of disk space.
1009<p>
1010<b>Default value:</b> true
1011<p>
1012<b>See also:</b> <a href="mail.html">Mail</a>
1013</dl>
1014
1015<code><a name="inbox">inbox</a></code>
1016<dl>
1017<dd>
1018Default mailbox for the <a href="commands.html#inbox">inbox</a> command.
1019<p>
1020<b>Default value:</b> None
1021<p>
1022<b>See also:</b> <a href="commands.html#openMailbox">openMailbox</a>,
1023<a href="mail.html">Mail</a>
1024</dl>
1025
1026<code><a name="includePath">includePath</a></code>
1027<dl>
1028<dd>
1029A list of directories to search when opening a .h file whose name is specified without
1030a full path, if the file in question is not found in the current directory. The
1031directories in the list must be separated by the platform-specific path
1032separator character, which is a colon for Unix and a semicolon for Windows.
1033<p>
1034<b>Default value:</b> None
1035<p>
1036<b>See also:</b> <a href="#sourcePath">sourcePath</a>,
1037<a href="commands.html#iList">iList</a>,
1038<a href="commands.html#checkPath">checkPath</a>,
1039<a href="commands.html#listIncludes">listIncludes</a>
1040</dl>
1041
1042<code><a name="indentLineFixWhitespace">indentLineFixWhitespace</a></code>
1043<dl>
1044<dd>
1045
1046If true, the indentation commands
1047<a href="commands.html#indentLine">indentLine</a>,
1048<a href="commands.html#indentRegion">indentRegion</a> and
1049<a href="commands.html#indentLineOrRegion">indentLineOrRegion</a> entab or
1050detab the indentation of the line or lines in question based upon the setting
1051of the <a href="#useTabs">useTabs</a> property even if the existing
1052indentation is otherwise correct.
1053<p>
1054If false, the indentation is changed only if the non-whitespace text of the
1055line or lines in question does not already start in the correct column.
1056<p>
1057<b>Default value:</b> false
1058</dl>
1059
1060<code><a name="indentSize">indentSize</a></code>
1061<dl>
1062<dd>
1063<p>
1064<b>Default value:</b> 4
1065</dl>
1066
1067<code><a name="jdkDocPath">jdkDocPath</a></code>
1068<dl>
1069<dd>
1070The full pathname of the directory containing the JDK HTML documentation.
1071<p>
1072<b>See also:</b> <a href="commands.html#jdkHelp">jdkHelp</a>
1073<p>
1074<b>Default value:</b> None
1075</dl>
1076
1077<code><a name="jdkSourcePath">jdkSourcePath</a></code>
1078<dl>
1079<dd>
1080The full pathname of the directory containing the JDK Java class source tree.
1081<p>
1082<b>See also:</b> <a href="commands.html#source">source</a>
1083<p>
1084<b>Default value:</b> None
1085</dl>
1086
1087<code><a name="JList.fixedCellHeight">JList.fixedCellHeight</a></code>
1088<dl>
1089<dd>
1090If > 0, the height in pixels for listbox (JList) cells. This value can be used
1091to override the default behavior if listboxes don't look quite right on your
1092display. (Try 17.)
1093<p>
1094<b>Default value:</b> 0
1095</dl>
1096
1097<code><a name="keywords">keywords</a></code>
1098<dl>
1099<dd>
1100The filename of the custom keyword list for a specific mode. For example:
1101<pre>
1102        LispMode.keywords = /home/peter/lisp.keywords
1103</pre>
1104The keyword list should be an ordinary text file with one keyword per line.
1105<p>
1106For examples of the format, take a look at the various .keywords files in
1107org/armedbear/j. There is such a file for each mode, containing the default
1108keyword list for that mode.
1109<p>
1110Note that the mode prefix (e.g. "LispMode.") is required; there is no global
1111keywords file.
1112<p>
1113<b>Default value:</b> None
1114</dl>
1115
1116<code><a name="lineupArglist">lineupArglist</a></code>
1117<dl>
1118<dd>
1119If true, function calls that span multiple lines will be indented like this:
1120<pre>
1121        veryLongFunctionName(arg1,
1122                             arg2);
1123</pre>
1124If false, the indentation will look like this:
1125<pre>
1126        veryLongFunctionName(arg1,
1127            arg2);
1128</pre>
1129<p>
1130<b>Default value:</b> true
1131</dl>
1132
1133<code><a name="listThreads">listThreads</a></code>
1134<dl>
1135<dd>
1136If > 0, specifies an interval in minutes for writing thread information to the
1137log, for debugging purposes only. The list threads task is only installed if
1138<a href="#debug">debug</a> is true at startup.
1139<p>
1140<b>Default value:</b> 0
1141<p>
1142<b>See also:</b> <a href="logging.html">Logging</a>
1143</dl>
1144
1145<code><a name="Log.enabled">Log.enabled</a></code>
1146<dl>
1147<dd>
1148If true, logging is enabled.
1149<p>
1150<b>Default value:</b> true
1151<p>
1152<b>See also:</b> <a href="logging.html">Logging</a>,
1153<a href="#debug">debug</a>
1154</dl>
1155
1156<code><a name="Log.maxBackupIndex">Log.maxBackupIndex</a></code>
1157<dl>
1158<dd>
1159The maximum index for backups of j's log file (~/.j/log or C:\.j\log). Since
1160the first backup file is ~/.j/log.0 (or C:\.j\log.0), the number of backups
1161that will be kept is one more than the maximum backup index.
1162<p>
1163<b>Default value:</b> 0
1164<p>
1165<b>See also:</b> <a href="logging.html">Logging</a>,
1166<a href="#Log.maxFileSize">Log.maxFileSize</a>
1167</dl>
1168
1169<code><a name="Log.maxFileSize">Log.maxFileSize</a></code>
1170<dl>
1171<dd>
1172The maximum size, in bytes, of j's log file (~/.j/log or C:\.j\log).
1173<p>
1174When the log file exceeds its maximum size, it is rolled over to the file
1175~/.j/log.0, which in turn is rolled over to ~/.j/log.1, etc.
1176<p>
1177<b>Default value:</b> 100000
1178<p>
1179<b>See also:</b> <a href="logging.html">Logging</a>,
1180<a href="#Log.maxBackupIndex">Log.maxBackupIndex</a>
1181</dl>
1182
1183<code><a name="nntpReadTimeout">nntpReadTimeout</a></code>
1184<dl>
1185<dd>
1186<i>Not documented.</i>
1187<p>
1188<b>Default value:</b> 0
1189</dl>
1190
1191<code><a name="org.xml.sax.driver">org.xml.sax.driver</a></code>
1192<dl>
1193<dd>
1194Class name of XML parser to use. For example:
1195<pre>
1196        org.xml.sax.driver = org.apache.xerces.parsers.SAXParser
1197</pre>
1198If this property is not specified, the XML parser provided as part of the Java
11991.4 runtime library will be used.
1200<p>
1201<b>Default value:</b> None
1202<p>
1203<b>See also:</b> <a href="xmlmode.html">XML Mode</a>
1204</dl>
1205
1206<code><a name="patchMode">patchMode</a></code>
1207<dl>
1208<dd>
1209Suffix to be used for the filename of the first backup of a local file.
1210<p>
1211For example, if the value of this property is ".orig", the first backup of the
1212file foo.bar will be made to the file foo.bar.orig in the same directory.
1213<p>
1214The <a href="commands.html#diff">diff</a> command, when invoked with no
1215arguments, diffs the file associated with the current buffer against its
1216patchMode backup file (if it exists).
1217<p>
1218<b>Default value:</b> None
1219</dl>
1220
1221<code><a name="PHPMode.color.var">PHPMode.color.var</a></code>
1222<dl>
1223<dd>
1224Color for variable names in PHP mode.
1225<p>
1226<b>Default value:</b> None
1227</dl>
1228
1229<code><a name="popExpungeDeletedMessagesOnServer">popExpungeDeletedMessagesOnServer</a></code>
1230<dl>
1231<dd>
1232If true, messages are deleted from the POP server when they have been deleted
1233and expunged locally. Otherwise (and by default) deleted messages are expunged
1234from the local message store but left intact on the server. Applies only to
1235POP mailboxes.
1236<p>
1237<b>Default value:</b> false
1238<p>
1239<b>See also:</b> <a href="mail.html">Mail</a>
1240</dl>
1241
1242<code><a name="popKeepMessagesOnServer">popKeepMessagesOnServer</a></code>
1243<dl>
1244<dd>
1245If false, messages are deleted from the POP server after they have been
1246successfully retrieved. Otherwise (and by default) messages are left on the
1247server when they are retrieved. Applies only to POP mailboxes.
1248<p>
1249<b>Default value:</b> true
1250<p>
1251<b>See also:</b> <a href="mail.html">Mail</a>
1252</dl>
1253
1254<code><a name="printerFontSize">printerFontSize</a></code>
1255<dl>
1256<dd>
1257Printer font size in points.
1258<p>
1259<b>Default value:</b> 10
1260</dl>
1261
1262<code><a name="removeTrailingWhitespace">removeTrailingWhitespace</a></code>
1263<dl>
1264<dd>
1265If true, trailing whitespace (spaces and/or tab characters at the end of a
1266line) is removed before the buffer is saved.
1267<p>
1268<b>Default value:</b> false
1269</dl>
1270
1271<code><a name="reorderBuffers">reorderBuffers</a></code>
1272<dl>
1273<dd>
1274Controls reordering of buffers for the sidebar buffer list and the buffer
1275navigation commands <a href="commands.html#nextBuffer">nextBuffer</a> and
1276<a href="commands.html#prevBuffer">prevBuffer</a>.
1277<p>
1278If reorderBuffers is 0, no reordering is performed; buffers are left in the
1279order in which they were originally opened.
1280<p>
1281If reorderBuffers is 1, buffers opened (or activated) by
1282<a href="commands.html#openFile">openFile</a> (and similar commands) are
1283placed after the current buffer in the list.
1284<p>
1285If reorderBuffers is 2, reordering is also performed when you use the sidebar
1286buffer list to switch to a different buffer.
1287<p>
1288Buffers are never reordered when you use
1289<a href="commands.html#nextBuffer">nextBuffer</a> or
1290<a href="commands.html#prevBuffer">prevBuffer</a> to switch between buffers.
1291<p>
1292If <a href="#sortBufferList">sortBufferList</a> is true, this property is
1293ignored.
1294<p>
1295<b>Default value:</b> 1
1296<p>
1297<b>See also:</b> <a href="#sortBufferList">sortBufferList</a>
1298</dl>
1299
1300<code><a name="restrictCaret">restrictCaret</a></code>
1301<dl>
1302<dd>
1303If true, the caret is restricted to the actual text on the line (including
1304leading and trailing whitespace). <a href="commands.html#right">right</a>, at
1305the end of the line, advances the caret to column 1 of the following line.
1306<p>
1307<b>Default value:</b> true
1308</dl>
1309
1310<code><a name="saveInPlace">saveInPlace</a></code>
1311<dl>
1312<dd>
1313If true, FTP saves are written directly to the destination file.
1314<p>
1315If false, FTP saves are first written to a temporary file, which is then
1316renamed to replace the destination file, and finally the file permissions that
1317were in effect before the save are restored using the SITE CHMOD command. This
1318approach is normally safer since the destination file is less likely to be
1319lost or truncated if a network problem prevents successful completion of the
1320save, but it may not preserve all attributes of the destination file.
1321<p>
1322<b>Default value:</b> false
1323</dl>
1324
1325<code><a name="scrollCaret">scrollCaret</a></code>
1326<dl>
1327<dd>
1328If true, the caret is automatically relocated (if necessary) to stay in the
1329edit window when you scroll the window vertically using the scroll bar, the
1330mouse wheel, or the functions <a href="commands.html#windowUp">windowUp</a> or
1331<a href="commands.html#windowDown">windowDown</a>.
1332<p>
1333If false, the caret is allowed to scroll out of the edit window when you scroll
1334the window vertically.
1335<p>
1336Scrolling never relocates the caret if a selection is active in the edit
1337window, regardless of the value of this property.
1338<p>
1339<b>Default value:</b> true
1340</dl>
1341
1342<code><a name="shellFileName">shellFileName</a></code>
1343<dl>
1344<dd>
1345
1346<p>
1347<b>Default value:</b>
1348</dl>
1349
1350<code><a name="ShellMode.color.input">ShellMode.color.input</a></code>
1351<dl>
1352<dd>
1353Color for user input in shell buffers.
1354<p>
1355<b>Default value:</b> None
1356</dl>
1357
1358<code><a name="ShellMode.color.prompt">ShellMode.color.prompt</a></code>
1359<dl>
1360<dd>
1361Color for prompt in shell buffers.
1362<p>
1363<b>Default value:</b> None
1364</dl>
1365
1366<code><a name="shellOutputLimit">shellOutputLimit</a></code>
1367<dl>
1368<dd>
1369Maximum number of lines retained in a shell buffer. If zero, no limit is
1370enforced.
1371<p>
1372<b>Default value:</b> 1000
1373</dl>
1374
1375<code><a name="shellPromptPattern">shellPromptPattern</a></code>
1376<dl>
1377<dd>
1378Regular expression to match prompts in a shell buffer.
1379<p>
1380<b>Default value:</b> "^[^#$%>]*[#$%>] *|^: *"
1381</dl>
1382
1383<code><a name="sshPromptPattern">sshPromptPattern</a></code>
1384<dl>
1385<dd>
1386Regular expression to match prompts when using ssh.
1387<p>
1388<b>Default value:</b> "^[^#$%>]*[#$%>] *|^: *"
1389</dl>
1390
1391<code><a name="sshTimeout">sshTimeout</a></code>
1392<dl>
1393<dd>
1394<i>Not documented.</i>
1395<p>
1396<b>Default value:</b> 250 milliseconds
1397</dl>
1398
1399<code><a name="showChangeMarks">showChangeMarks</a></code>
1400<dl>
1401<dd>
1402If true, change marks are displayed in the edit window.
1403<p>
1404<b>Default value:</b> true
1405<p>
1406<b>See also:</b> <a href="#color.change">color.change</a>,
1407<a href="#color.savedChange">color.savedChange</a>,
1408<a href="#changeMarkWidth">changeMarkWidth</a>,
1409<a href="commands.html#nextChange">nextChange</a>,
1410<a href="commands.html#previousChange">previousChange</a>
1411</dl>
1412
1413<code><a name="showLineNumbers">showLineNumbers</a></code>
1414<dl>
1415<dd>
1416If true, line numbers are displayed in the edit window.
1417<p>
1418<b>Default value:</b> false
1419<p>
1420<b>See also:</b> <a href="#gutterFontName">gutterFontName</a>,
1421<a href="#gutterFontSize">gutterFontSize</a>,
1422<a href="#color.gutterBorder">color.gutterBorder</a>,
1423<a href="#color.lineNumber">color.lineNumber</a>
1424</dl>
1425
1426<code><a name="sortBufferList">sortBufferList</a></code>
1427<dl>
1428<dd>
1429If true, the sidebar buffer list is kept sorted in alphabetical order.
1430<p>
1431<b>Default value:</b> false
1432<p>
1433<b>See also:</b> <a href="#reorderBuffers">reorderBuffers</a>
1434</dl>
1435
1436<code><a name="sourcePath">sourcePath</a></code>
1437<dl>
1438<dd>
1439A list of directories to search when opening any file whose name is specified
1440without a full path, if the file in question is not found in the current
1441directory. For .h files, the source path is searched after the include path.
1442The directories in the list must be separated by the platform-specific path
1443separator character, which is a colon for Unix and a semicolon for Windows.
1444<p>
1445<b>Default value:</b> None
1446<p>
1447<b>See also:</b> <a href="#includePath">includePath</a>
1448</dl>
1449
1450<code><a name="stampFormat">stampFormat</a></code>
1451<dl>
1452<dd>
1453Controls the format of the date/time string inserted by the
1454<a href="commands.html#stamp">stamp</a> command. The specified pattern is used
1455to construct a
1456<a href="http://java.sun.com/j2se/1.4/docs/api/java/text/SimpleDateFormat.html">
1457SimpleDateFormat</a> object that formats the output string.
1458<p>
1459<b>Default value:</b> "MMM d yyyy h:mm a"
1460</dl>
1461
1462<code><a name="StatusBar.displayContext">StatusBar.displayContext</a></code>
1463<dl>
1464<dd>
1465If >= 1, context information (typically identifying the current function or
1466method in the source) is displayed in the status bar when there is no other
1467information that needs to be displayed there. If > 1, the long form of the
1468context string is used; if = 1, the short form is used. If = 0, no context
1469information is displayed.
1470<p>
1471<b>Default value:</b> 1
1472</dl>
1473
1474<code><a name="StatusBar.displayLineCount">StatusBar.displayLineCount</a></code>
1475<dl>
1476<dd>
1477If true, the total number of lines in the buffer is displayed in the status bar.
1478<p>
1479<b>Default value:</b> false
1480</dl>
1481
1482<code><a name="StatusBar.displayLineSeparator">StatusBar.displayLineSeparator</a></code>
1483<dl>
1484<dd>
1485If true, the line separator for the current buffer (LF, CR, or CR+LF) is
1486displayed in the status bar.
1487<p>
1488<b>Default value:</b> false
1489</dl>
1490
1491<code><a name="style.comment">style.comment</a></code>
1492<dl>
1493<dd>
1494Style for comments (0 is plain, 1 is bold, 2 is italic).
1495<p>
1496<b>Default value:</b> None
1497</dl>
1498
1499<code><a name="style.text">style.text</a></code>
1500<dl>
1501<dd>
1502Default style (0 is plain, 1 is bold, 2 is italic).
1503<p>
1504<b>Default value:</b> None
1505</dl>
1506
1507<code><a name="style.directory">style.directory</a></code>
1508<dl>
1509<dd>
1510Style for directory names in directory buffers (0 is plain, 1 is bold, 2 is italic).
1511<p>
1512<b>Default value:</b> None
1513</dl>
1514
1515<code><a name="style.function">style.function</a></code>
1516<dl>
1517<dd>
1518Style for function names (0 is plain, 1 is bold, 2 is italic).
1519<p>
1520<b>Default value:</b> None
1521</dl>
1522
1523<code><a name="style.keyword">style.keyword</a></code>
1524<dl>
1525<dd>
1526Style for language keywords (0 is plain, 1 is bold, 2 is italic).
1527<p>
1528<b>Default value:</b> None
1529</dl>
1530
1531<code><a name="style.marked">style.marked</a></code>
1532<dl>
1533<dd>
1534Style for marked files in directory buffers (0 is plain, 1 is bold, 2 is italic).
1535<p>
1536<b>Default value:</b> None
1537</dl>
1538
1539<code><a name="style.prompt">style.prompt</a></code>
1540<dl>
1541<dd>
1542Style for prompt in shell buffers (0 is plain, 1 is bold, 2 is italic).
1543<p>
1544<b>Default value:</b> None
1545</dl>
1546
1547<code><a name="tabAlwaysIndent">tabAlwaysIndent</a></code>
1548<dl>
1549<dd>
1550If true, the <a href="commands.html#tab">tab</a> command always re-indents the
1551current line (or multi-line selected region) according to context.
1552<p>
1553If false, the behavior of the <a href="commands.html#tab">tab</a> command
1554depends on the location of the caret.
1555<p>
1556If the caret is at the very beginning of the text on the line, or in the
1557whitespace to the left of the text, <a href="commands.html#tab">tab</a> calls <a href="commands.html#indentLine">indentLine</a>.
1558If the caret is in the midst of the actual text on the line, <a href="commands.html#tab">tab</a>
1559inserts either a single tab character or the equivalent number of spaces,
1560depending on the setting of the <a href="#useTabs">useTabs</a> property.
1561<p>
1562<b>Default value:</b> true
1563</dl>
1564
1565<code><a name="tabWidth">tabWidth</a></code>
1566<dl>
1567<dd>
1568Distance between tab stops, in columns, for display purposes.
1569<p>
1570<b>Default value:</b> 8
1571</dl>
1572
1573<code><a name="telnetPromptPattern">telnetPromptPattern</a></code>
1574<dl>
1575<dd>
1576Regular expression to match prompts in a telnet buffer.
1577<p>
1578<b>Default value:</b> "^[^#$%>]*[#$%>] *|^: *"
1579</dl>
1580
1581<code><a name="ToolBar.isRollover">ToolBar.isRollover</a></code>
1582<dl>
1583<dd>
1584If true, toolbar buttons have dynamic borders which are only painted when the mouse
1585cursor is over the button.  If false, toolbar buttons have normal borders.
1586<p>
1587<b>Default value:</b> true
1588</dl>
1589
1590<code><a name="ToolBar.showIcons">ToolBar.showIcons</a></code>
1591<dl>
1592<dd>
1593If true, toolbar buttons contain icons.
1594<p>
1595<b>Default value:</b> true
1596</dl>
1597
1598<code><a name="ToolBar.showText">ToolBar.showText</a></code>
1599<dl>
1600<dd>
1601If true, toolbar buttons contain text.
1602<p>
1603<b>Default value:</b> true
1604</dl>
1605
1606<code><a name="textFieldFontName">textFieldFontName</a></code>
1607<dl>
1608<dd>
1609Name of font used for textfields in dialogs and the location bar.
1610<p>
1611<b>Default value:</b> Monospaced
1612<p>
1613<b>See also:</b> <a href="#textFieldFontSize">textFieldFontSize</a>,
1614<a href="#dialogFontName">dialogFontName</a>
1615</dl>
1616
1617<code><a name="textFieldFontSize">textFieldFontSize</a></code>
1618<dl>
1619<dd>
1620Size (in points) of font used for textfields in dialogs and the location bar.
1621If this parameter is not specified, the value of
1622<a href="#dialogFontSize">dialogFontSize</a> is used.
1623<p>
1624<b>Default value:</b> None
1625<p>
1626<b>See also:</b> <a href="#textFieldFontName">textFieldFontName</a>,
1627<a href="#dialogFontSize">dialogFontSize</a>
1628</dl>
1629
1630<code><a name="theme">theme</a></code>
1631<dl>
1632<dd>
1633Name of theme file. The specified theme file is loaded as an additional
1634preferences file after ~/.j/prefs is loaded. The idea is to gather all the
1635settings that relate to j's look and feel in one place.
1636<p>
1637<b>Default value:</b> None
1638<p>
1639<b>See also:</b> <code><a href="#themePath">themePath</a></code>
1640</dl>
1641
1642<code><a name="themePath">themePath</a></code>
1643<dl>
1644<dd>
1645A list of directories to search for theme files, if the full path of the theme
1646file isn't specified. The directories in the list must be separated by the
1647platform-specific path separator character, which is a colon for Unix and a
1648semicolon for Windows.
1649<p>
1650<b>Default value:</b> None
1651<p>
1652<b>See also:</b> <code><a href="#theme">theme</a></code>
1653</dl>
1654
1655<code><a name="useIncrementalFind">useIncrementalFind</a></code> <dl> <dd> If
1656true, the primary default global key mapping for <a href="commands.html#find">find</a>,
1657which is Ctrl F, is assigned to <a href="commands.html#incrementalFind">incrementalFind</a>
1658instead. This setting has no effect if you are using a custom global key map.
1659<p>
1660<b>Default value:</b> false
1661</dl>
1662
1663<code><a name="useMenuMnemonics">useMenuMnemonics</a></code>
1664<dl>
1665<dd>
1666If true, mnemonics are used in the top-level menu. Set this to false if you
1667want to make these keystrokes (Alt F, Alt E, etc.) available for mapping
1668commands instead.
1669<p>
1670<b>Default value:</b> true
1671</dl>
1672
1673<code><a name="useTabs">useTabs</a></code>
1674<dl>
1675<dd>
1676If true, actual tab characters are inserted in the buffer. If false, the
1677equivalent number of spaces are inserted instead. Changing the value of this
1678property does not have a retroactive effect on spaces or tab characters that
1679are already in the buffer.
1680<p>
1681<b>Default value:</b> false
1682<p>
1683<b>See also:</b> <a href="commands.html#detabRegion">detabRegion</a>,
1684<a href="commands.html#entabRegion">entabRegion</a>
1685</dl>
1686
1687<code><a name="userFullName">userFullName</a></code>
1688<dl>
1689<dd>
1690The user's full name (e.g. "Enzo Pirelli"), used in constructing the default
1691"From" address for outgoing mail messages.
1692<p>
1693<b>Default value:</b> None
1694<p>
1695<b>See also:</b> <a href="#userMailAddress">userMailAddress</a>,
1696<a href="mail.html">Mail</a>
1697</dl>
1698
1699<code><a name="userMailAddress">userMailAddress</a></code>
1700<dl>
1701<dd>
1702The user's mail address (e.g. "enzo@hotmail.com"), used in constructing the
1703default "From" address for outgoing mail messages.
1704<p>
1705<b>Default value:</b> None
1706<p>
1707<b>See also:</b> <a href="#userFullName">userFullName</a>,
1708<a href="mail.html">Mail</a>
1709</dl>
1710
1711<code><a name="verticalRule">verticalRule</a></code>
1712<dl>
1713<dd>
1714If non-zero, this parameter specifies the column for the vertical rule. The
1715vertical rule is a 1-pixel-wide vertical line that is displayed to the right
1716of the specified column as a reminder of the desired location of the
1717right margin. If this parameter is zero, no vertical rule is displayed.
1718<p>
1719<b>Default value:</b> 0
1720<p>
1721<b>See also:</b> <a href="#color.verticalRule">color.verticalRule</a>
1722</dl>
1723
1724<code><a name="verticalScrollIncrement">verticalScrollIncrement</a></code>
1725<dl>
1726<dd>
1727The number of lines scrolled when you click on the arrow button at the top or
1728bottom of the vertical scroll bar.
1729<p>
1730<b>Default value:</b> 5
1731</dl>
1732
1733<code><a name="wrapCol">wrapCol</a></code>
1734<dl>
1735<dd>
1736The column where text is wrapped by automatic word wrap and by the commands
1737<a href="commands.html#wrapComment">wrapComment</a>,
1738<a href="commands.html#wrapParagraph">wrapParagraph</a> and
1739<a href="commands.html#wrapRegion">wrapRegion</a>.
1740<p>
1741<b>Default value:</b> 80
1742</dl>
1743
1744<code><a name="XmlMode.color.attribute">XmlMode.color.attribute</a></code>
1745<dl>
1746<dd>
1747<p>
1748<b>Default value:</b> None
1749</dl>
1750
1751<code><a name="XmlMode.color.comment">XmlMode.color.comment</a></code>
1752<dl>
1753<dd>
1754<p>
1755<b>Default value:</b> None
1756</dl>
1757
1758<code><a name="XmlMode.color.delimiter">XmlMode.color.delimiter</a></code>
1759<dl>
1760<dd>
1761<p>
1762<b>Default value:</b> None
1763</dl>
1764
1765<code><a name="XmlMode.color.namespace">XmlMode.color.namespace</a></code>
1766<dl>
1767<dd>
1768<p>
1769<b>Default value:</b> None
1770</dl>
1771
1772<code><a name="XmlMode.color.tag">XmlMode.color.tag</a></code>
1773<dl>
1774<dd>
1775<p>
1776<b>Default value:</b> None
1777</dl>
1778
1779<code><a name="XmlMode.fixCase">XmlMode.fixCase</a></code>
1780<dl> <dd>
1781If true, tag and attribute names in XML mode are automatically converted to
1782the preferred case, as specified by <a href="#XmlMode.upperCaseTagNames">XmlMode.upperCaseTagNames</a> and
1783<a href="#XmlMode.upperCaseAttributeNames">XmlMode.upperCaseAttributeNames</a>.
1784<p>
1785<b>Default value:</b> false
1786</dl>
1787
1788<code><a name="XmlMode.upperCaseAttributeNames">XmlMode.upperCaseAttributeNames</a></code>
1789<dl> <dd>
1790If true, upper case is preferred for attribute names in XML mode; otherwise,
1791lower case is preferred.  If <a href="#XmlMode.fixCase">XmlMode.fixCase</a> is true,
1792attribute names are automatically converted to the preferred case as you type them in.
1793<p>
1794<b>Default value:</b> false
1795</dl>
1796
1797<code><a name="XmlMode.upperCaseTagNames">XmlMode.upperCaseTagNames</a></code>
1798<dl> <dd>
1799If true, upper case is preferred for tag names in XML mode; otherwise,
1800lower case is preferred. If <a href="#XmlMode.fixCase">XmlMode.fixCase</a> is true,
1801tag names are automatically converted to the preferred case as you type them in.
1802<p>
1803<b>Default value:</b> true
1804</dl>
1805
1806</body>
1807
1808</html>
Note: See TracBrowser for help on using the repository browser.