source: tags/0.12.0/j/doc/preferences.html

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

indentStrings

File size: 50.9 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="indentAfterBrace">indentAfterBrace</a></code>
1043<dl>
1044<dd>
1045If true, the next line after a line that ends with '{' is indented, like this:
1046<pre>
1047        if (foo)
1048        {
1049            bar(); // This line is indented because of the preceding '{'.
1050        }
1051</pre>
1052<p>
1053<b>See also:</b> <a href="#indentBeforeBrace">indentBeforeBrace</a>
1054<p>
1055<b>Default value:</b> true
1056</dl>
1057
1058<code><a name="indentBeforeBrace">indentBeforeBrace</a></code>
1059<dl>
1060<dd>
1061If true, lines that start with '{' are indented, like this:
1062<pre>
1063        if (foo)
1064            {      // This line is indented because it starts with '{'.
1065            bar();
1066            }
1067</pre>
1068<p>
1069<b>See also:</b> <a href="#indentAfterBrace">indentAfterBrace</a>
1070<p>
1071<b>Default value:</b> false
1072</dl>
1073
1074<code><a name="indentLineFixWhitespace">indentLineFixWhitespace</a></code>
1075<dl>
1076<dd>
1077If true, the indentation commands
1078<a href="commands.html#indentLine">indentLine</a>,
1079<a href="commands.html#indentRegion">indentRegion</a> and
1080<a href="commands.html#indentLineOrRegion">indentLineOrRegion</a> entab or
1081detab the indentation of the line or lines in question based upon the setting
1082of the <a href="#useTabs">useTabs</a> property even if the existing
1083indentation is otherwise correct.
1084<p>
1085If false, the indentation is changed only if the non-whitespace text of the
1086line or lines in question does not already start in the correct column.
1087<p>
1088<b>Default value:</b> false
1089</dl>
1090
1091<code><a name="indentSize">indentSize</a></code>
1092<dl>
1093<dd>
1094<p>
1095<b>Default value:</b> 4
1096</dl>
1097
1098<code><a name="indentStrings">indentStrings</a></code>
1099<dl>
1100<dd>
1101This property is used to control the indentation of multiline strings in Lisp
1102mode.
1103<p>
1104By default, the second and subsequent lines of multiline strings are not
1105indented at all and begin at the left margin, like this:
1106<pre>
1107        (defun foo ()
1108          (format t "pretend that this is a
1109        very long string"))
1110</pre>
1111There is one exception. If any line of the string ends with '~', the next line
1112is indented to line up with the beginning of the string:
1113<pre>
1114        (defun foo ()
1115          (format t "pretend that this is a ~
1116                     very long string"))
1117</pre>
1118If <a href="#indentStrings">indentStrings</a> is true, the second and
1119subsequent lines of multiline strings are always indented to line up with the
1120beginning of the string:
1121<pre>
1122        (defun foo ()
1123          (format nil "pretend that this is a
1124                       very long string"))
1125</pre>
1126In general, this is probably not what you want, since it inserts an arbitrary
1127amount of whitespace in the middle of the string, but if you can live with that
1128you do end up with better-looking code.
1129<p>
1130<b>Default value:</b> false
1131</dl>
1132
1133<code><a name="jdkDocPath">jdkDocPath</a></code>
1134<dl>
1135<dd>
1136The full pathname of the directory containing the JDK HTML documentation.
1137<p>
1138<b>See also:</b> <a href="commands.html#jdkHelp">jdkHelp</a>
1139<p>
1140<b>Default value:</b> None
1141</dl>
1142
1143<code><a name="jdkSourcePath">jdkSourcePath</a></code>
1144<dl>
1145<dd>
1146The full pathname of the directory containing the JDK Java class source tree.
1147<p>
1148<b>See also:</b> <a href="commands.html#source">source</a>
1149<p>
1150<b>Default value:</b> None
1151</dl>
1152
1153<code><a name="JList.fixedCellHeight">JList.fixedCellHeight</a></code>
1154<dl>
1155<dd>
1156If > 0, the height in pixels for listbox (JList) cells. This value can be used
1157to override the default behavior if listboxes don't look quite right on your
1158display. (Try 17.)
1159<p>
1160<b>Default value:</b> 0
1161</dl>
1162
1163<code><a name="keywords">keywords</a></code>
1164<dl>
1165<dd>
1166The filename of the custom keyword list for a specific mode. For example:
1167<pre>
1168        LispMode.keywords = /home/peter/lisp.keywords
1169</pre>
1170The keyword list should be an ordinary text file with one keyword per line.
1171<p>
1172For examples of the format, take a look at the various .keywords files in
1173org/armedbear/j. There is such a file for each mode, containing the default
1174keyword list for that mode.
1175<p>
1176Note that the mode prefix (e.g. "LispMode.") is required; there is no global
1177keywords file.
1178<p>
1179<b>Default value:</b> None
1180</dl>
1181
1182<code><a name="lineupArglist">lineupArglist</a></code>
1183<dl>
1184<dd>
1185If true, function calls that span multiple lines will be indented like this:
1186<pre>
1187        veryLongFunctionName(arg1,
1188                             arg2);
1189</pre>
1190If false, the indentation will look like this:
1191<pre>
1192        veryLongFunctionName(arg1,
1193            arg2);
1194</pre>
1195<p>
1196<b>Default value:</b> true
1197</dl>
1198
1199<code><a name="listThreads">listThreads</a></code>
1200<dl>
1201<dd>
1202If > 0, specifies an interval in minutes for writing thread information to the
1203log, for debugging purposes only. The list threads task is only installed if
1204<a href="#debug">debug</a> is true at startup.
1205<p>
1206<b>Default value:</b> 0
1207<p>
1208<b>See also:</b> <a href="logging.html">Logging</a>
1209</dl>
1210
1211<code><a name="Log.enabled">Log.enabled</a></code>
1212<dl>
1213<dd>
1214If true, logging is enabled.
1215<p>
1216<b>Default value:</b> true
1217<p>
1218<b>See also:</b> <a href="logging.html">Logging</a>,
1219<a href="#debug">debug</a>
1220</dl>
1221
1222<code><a name="Log.maxBackupIndex">Log.maxBackupIndex</a></code>
1223<dl>
1224<dd>
1225The maximum index for backups of j's log file (~/.j/log or C:\.j\log). Since
1226the first backup file is ~/.j/log.0 (or C:\.j\log.0), the number of backups
1227that will be kept is one more than the maximum backup index.
1228<p>
1229<b>Default value:</b> 0
1230<p>
1231<b>See also:</b> <a href="logging.html">Logging</a>,
1232<a href="#Log.maxFileSize">Log.maxFileSize</a>
1233</dl>
1234
1235<code><a name="Log.maxFileSize">Log.maxFileSize</a></code>
1236<dl>
1237<dd>
1238The maximum size, in bytes, of j's log file (~/.j/log or C:\.j\log).
1239<p>
1240When the log file exceeds its maximum size, it is rolled over to the file
1241~/.j/log.0, which in turn is rolled over to ~/.j/log.1, etc.
1242<p>
1243<b>Default value:</b> 100000
1244<p>
1245<b>See also:</b> <a href="logging.html">Logging</a>,
1246<a href="#Log.maxBackupIndex">Log.maxBackupIndex</a>
1247</dl>
1248
1249<code><a name="nntpReadTimeout">nntpReadTimeout</a></code>
1250<dl>
1251<dd>
1252<i>Not documented.</i>
1253<p>
1254<b>Default value:</b> 0
1255</dl>
1256
1257<code><a name="org.xml.sax.driver">org.xml.sax.driver</a></code>
1258<dl>
1259<dd>
1260Class name of XML parser to use. For example:
1261<pre>
1262        org.xml.sax.driver = org.apache.xerces.parsers.SAXParser
1263</pre>
1264If this property is not specified, the XML parser provided as part of the Java
12651.4 runtime library will be used.
1266<p>
1267<b>Default value:</b> None
1268<p>
1269<b>See also:</b> <a href="xmlmode.html">XML Mode</a>
1270</dl>
1271
1272<code><a name="p4AutoEdit">p4AutoEdit</a></code>
1273<dl>
1274<dd>
1275If you're using Perforce with a quick and reliable connection, setting this
1276preference to true will let you edit files without having to check them out
1277explicitly first; j will automatically do "p4 edit" for you when you make the
1278first change to the file.
1279<p>
1280<b>Default value:</b> false
1281</dl>
1282
1283<code><a name="parensRequireSpaces">parensRequireSpaces</a></code>
1284<dl>
1285<dd>
1286If true, the command
1287<a href="commands.html#insertParentheses">insertParentheses</a> adds single
1288space characters after the opening parenthesis and before the closing
1289parenthesis.
1290<p>
1291<b>Default value:</b> false
1292</dl>
1293
1294<code><a name="patchMode">patchMode</a></code>
1295<dl>
1296<dd>
1297Suffix to be used for the filename of the first backup of a local file.
1298<p>
1299For example, if the value of this property is ".orig", the first backup of the
1300file foo.bar will be made to the file foo.bar.orig in the same directory.
1301<p>
1302The <a href="commands.html#diff">diff</a> command, when invoked with no
1303arguments, diffs the file associated with the current buffer against its
1304patchMode backup file (if it exists).
1305<p>
1306<b>Default value:</b> None
1307</dl>
1308
1309<code><a name="PHPMode.color.var">PHPMode.color.var</a></code>
1310<dl>
1311<dd>
1312Color for variable names in PHP mode.
1313<p>
1314<b>Default value:</b> None
1315</dl>
1316
1317<code><a name="popExpungeDeletedMessagesOnServer">popExpungeDeletedMessagesOnServer</a></code>
1318<dl>
1319<dd>
1320If true, messages are deleted from the POP server when they have been deleted
1321and expunged locally. Otherwise (and by default) deleted messages are expunged
1322from the local message store but left intact on the server. Applies only to
1323POP mailboxes.
1324<p>
1325<b>Default value:</b> false
1326<p>
1327<b>See also:</b> <a href="mail.html">Mail</a>
1328</dl>
1329
1330<code><a name="popKeepMessagesOnServer">popKeepMessagesOnServer</a></code>
1331<dl>
1332<dd>
1333If false, messages are deleted from the POP server after they have been
1334successfully retrieved. Otherwise (and by default) messages are left on the
1335server when they are retrieved. Applies only to POP mailboxes.
1336<p>
1337<b>Default value:</b> true
1338<p>
1339<b>See also:</b> <a href="mail.html">Mail</a>
1340</dl>
1341
1342<code><a name="printerFontSize">printerFontSize</a></code>
1343<dl>
1344<dd>
1345Printer font size in points.
1346<p>
1347<b>Default value:</b> 10
1348</dl>
1349
1350<code><a name="removeTrailingWhitespace">removeTrailingWhitespace</a></code>
1351<dl>
1352<dd>
1353If true, trailing whitespace (spaces and/or tab characters at the end of a
1354line) is removed before the buffer is saved.
1355<p>
1356<b>Default value:</b> false
1357</dl>
1358
1359<code><a name="reorderBuffers">reorderBuffers</a></code>
1360<dl>
1361<dd>
1362Controls reordering of buffers for the sidebar buffer list and the buffer
1363navigation commands <a href="commands.html#nextBuffer">nextBuffer</a> and
1364<a href="commands.html#prevBuffer">prevBuffer</a>.
1365<p>
1366If reorderBuffers is 0, no reordering is performed; buffers are left in the
1367order in which they were originally opened.
1368<p>
1369If reorderBuffers is 1, buffers opened (or activated) by
1370<a href="commands.html#openFile">openFile</a> (and similar commands) are
1371placed after the current buffer in the list.
1372<p>
1373If reorderBuffers is 2, reordering is also performed when you use the sidebar
1374buffer list to switch to a different buffer.
1375<p>
1376Buffers are never reordered when you use
1377<a href="commands.html#nextBuffer">nextBuffer</a> or
1378<a href="commands.html#prevBuffer">prevBuffer</a> to switch between buffers.
1379<p>
1380If <a href="#sortBufferList">sortBufferList</a> is true, this property is
1381ignored.
1382<p>
1383<b>Default value:</b> 1
1384<p>
1385<b>See also:</b> <a href="#sortBufferList">sortBufferList</a>
1386</dl>
1387
1388<code><a name="restrictCaret">restrictCaret</a></code>
1389<dl>
1390<dd>
1391If true, the caret is restricted to the actual text on the line (including
1392leading and trailing whitespace). <a href="commands.html#right">right</a>, at
1393the end of the line, advances the caret to column 1 of the following line.
1394<p>
1395<b>Default value:</b> true
1396</dl>
1397
1398<code><a name="saveInPlace">saveInPlace</a></code>
1399<dl>
1400<dd>
1401If true, FTP saves are written directly to the destination file.
1402<p>
1403If false, FTP saves are first written to a temporary file, which is then
1404renamed to replace the destination file, and finally the file permissions that
1405were in effect before the save are restored using the SITE CHMOD command. This
1406approach is normally safer since the destination file is less likely to be
1407lost or truncated if a network problem prevents successful completion of the
1408save, but it may not preserve all attributes of the destination file.
1409<p>
1410<b>Default value:</b> false
1411</dl>
1412
1413<code><a name="scrollCaret">scrollCaret</a></code>
1414<dl>
1415<dd>
1416If true, the caret is automatically relocated (if necessary) to stay in the
1417edit window when you scroll the window vertically using the scroll bar, the
1418mouse wheel, or the functions <a href="commands.html#windowUp">windowUp</a> or
1419<a href="commands.html#windowDown">windowDown</a>.
1420<p>
1421If false, the caret is allowed to scroll out of the edit window when you scroll
1422the window vertically.
1423<p>
1424Scrolling never relocates the caret if a selection is active in the edit
1425window, regardless of the value of this property.
1426<p>
1427<b>Default value:</b> true
1428</dl>
1429
1430<code><a name="shellFileName">shellFileName</a></code>
1431<dl>
1432<dd>
1433
1434<p>
1435<b>Default value:</b>
1436</dl>
1437
1438<code><a name="ShellMode.color.input">ShellMode.color.input</a></code>
1439<dl>
1440<dd>
1441Color for user input in shell buffers.
1442<p>
1443<b>Default value:</b> None
1444</dl>
1445
1446<code><a name="ShellMode.color.prompt">ShellMode.color.prompt</a></code>
1447<dl>
1448<dd>
1449Color for prompt in shell buffers.
1450<p>
1451<b>Default value:</b> None
1452</dl>
1453
1454<code><a name="shellOutputLimit">shellOutputLimit</a></code>
1455<dl>
1456<dd>
1457Maximum number of lines retained in a shell buffer. If zero, no limit is
1458enforced.
1459<p>
1460<b>Default value:</b> 1000
1461</dl>
1462
1463<code><a name="shellPromptPattern">shellPromptPattern</a></code>
1464<dl>
1465<dd>
1466Regular expression to match prompts in a shell buffer.
1467<p>
1468<b>Default value:</b> "^[^#$%>]*[#$%>] *|^: *"
1469</dl>
1470
1471<code><a name="sshPromptPattern">sshPromptPattern</a></code>
1472<dl>
1473<dd>
1474Regular expression to match prompts when using ssh.
1475<p>
1476<b>Default value:</b> "^[^#$%>]*[#$%>] *|^: *"
1477</dl>
1478
1479<code><a name="sshTimeout">sshTimeout</a></code>
1480<dl>
1481<dd>
1482<i>Not documented.</i>
1483<p>
1484<b>Default value:</b> 250 milliseconds
1485</dl>
1486
1487<code><a name="showChangeMarks">showChangeMarks</a></code>
1488<dl>
1489<dd>
1490If true, change marks are displayed in the edit window.
1491<p>
1492<b>Default value:</b> true
1493<p>
1494<b>See also:</b> <a href="#color.change">color.change</a>,
1495<a href="#color.savedChange">color.savedChange</a>,
1496<a href="#changeMarkWidth">changeMarkWidth</a>,
1497<a href="commands.html#nextChange">nextChange</a>,
1498<a href="commands.html#previousChange">previousChange</a>
1499</dl>
1500
1501<code><a name="showLineNumbers">showLineNumbers</a></code>
1502<dl>
1503<dd>
1504If true, line numbers are displayed in the edit window.
1505<p>
1506<b>Default value:</b> false
1507<p>
1508<b>See also:</b> <a href="#gutterFontName">gutterFontName</a>,
1509<a href="#gutterFontSize">gutterFontSize</a>,
1510<a href="#color.gutterBorder">color.gutterBorder</a>,
1511<a href="#color.lineNumber">color.lineNumber</a>
1512</dl>
1513
1514<code><a name="sortBufferList">sortBufferList</a></code>
1515<dl>
1516<dd>
1517If true, the sidebar buffer list is kept sorted in alphabetical order.
1518<p>
1519<b>Default value:</b> false
1520<p>
1521<b>See also:</b> <a href="#reorderBuffers">reorderBuffers</a>
1522</dl>
1523
1524<code><a name="sourcePath">sourcePath</a></code>
1525<dl>
1526<dd>
1527A list of directories to search when opening any file whose name is specified
1528without a full path, if the file in question is not found in the current
1529directory. For .h files, the source path is searched after the include path.
1530The directories in the list must be separated by the platform-specific path
1531separator character, which is a colon for Unix and a semicolon for Windows.
1532<p>
1533<b>Default value:</b> None
1534<p>
1535<b>See also:</b> <a href="#includePath">includePath</a>
1536</dl>
1537
1538<code><a name="stampFormat">stampFormat</a></code>
1539<dl>
1540<dd>
1541Controls the format of the date/time string inserted by the
1542<a href="commands.html#stamp">stamp</a> command. The specified pattern is used
1543to construct a
1544<a href="http://java.sun.com/j2se/1.4/docs/api/java/text/SimpleDateFormat.html">
1545SimpleDateFormat</a> object that formats the output string.
1546<p>
1547<b>Default value:</b> "MMM d yyyy h:mm a"
1548</dl>
1549
1550<code><a name="StatusBar.displayContext">StatusBar.displayContext</a></code>
1551<dl>
1552<dd>
1553If >= 1, context information (typically identifying the current function or
1554method in the source) is displayed in the status bar when there is no other
1555information that needs to be displayed there. If > 1, the long form of the
1556context string is used; if = 1, the short form is used. If = 0, no context
1557information is displayed.
1558<p>
1559<b>Default value:</b> 1
1560</dl>
1561
1562<code><a name="StatusBar.displayLineCount">StatusBar.displayLineCount</a></code>
1563<dl>
1564<dd>
1565If true, the total number of lines in the buffer is displayed in the status bar.
1566<p>
1567<b>Default value:</b> false
1568</dl>
1569
1570<code><a name="StatusBar.displayLineSeparator">StatusBar.displayLineSeparator</a></code>
1571<dl>
1572<dd>
1573If true, the line separator for the current buffer (LF, CR, or CR+LF) is
1574displayed in the status bar.
1575<p>
1576<b>Default value:</b> false
1577</dl>
1578
1579<code><a name="style.comment">style.comment</a></code>
1580<dl>
1581<dd>
1582Style for comments (0 is plain, 1 is bold, 2 is italic).
1583<p>
1584<b>Default value:</b> None
1585</dl>
1586
1587<code><a name="style.text">style.text</a></code>
1588<dl>
1589<dd>
1590Default style (0 is plain, 1 is bold, 2 is italic).
1591<p>
1592<b>Default value:</b> None
1593</dl>
1594
1595<code><a name="style.directory">style.directory</a></code>
1596<dl>
1597<dd>
1598Style for directory names in directory buffers (0 is plain, 1 is bold, 2 is italic).
1599<p>
1600<b>Default value:</b> None
1601</dl>
1602
1603<code><a name="style.function">style.function</a></code>
1604<dl>
1605<dd>
1606Style for function names (0 is plain, 1 is bold, 2 is italic).
1607<p>
1608<b>Default value:</b> None
1609</dl>
1610
1611<code><a name="style.keyword">style.keyword</a></code>
1612<dl>
1613<dd>
1614Style for language keywords (0 is plain, 1 is bold, 2 is italic).
1615<p>
1616<b>Default value:</b> None
1617</dl>
1618
1619<code><a name="style.marked">style.marked</a></code>
1620<dl>
1621<dd>
1622Style for marked files in directory buffers (0 is plain, 1 is bold, 2 is italic).
1623<p>
1624<b>Default value:</b> None
1625</dl>
1626
1627<code><a name="style.prompt">style.prompt</a></code>
1628<dl>
1629<dd>
1630Style for prompt in shell buffers (0 is plain, 1 is bold, 2 is italic).
1631<p>
1632<b>Default value:</b> None
1633</dl>
1634
1635<code><a name="tabAlwaysIndent">tabAlwaysIndent</a></code>
1636<dl>
1637<dd>
1638If true, the <a href="commands.html#tab">tab</a> command always re-indents the
1639current line (or multi-line selected region) according to context.
1640<p>
1641If false, the behavior of the <a href="commands.html#tab">tab</a> command
1642depends on the location of the caret.
1643<p>
1644If the caret is at the very beginning of the text on the line, or in the
1645whitespace to the left of the text, <a href="commands.html#tab">tab</a> calls <a href="commands.html#indentLine">indentLine</a>.
1646If the caret is in the midst of the actual text on the line, <a href="commands.html#tab">tab</a>
1647inserts either a single tab character or the equivalent number of spaces,
1648depending on the setting of the <a href="#useTabs">useTabs</a> property.
1649<p>
1650<b>Default value:</b> true
1651</dl>
1652
1653<code><a name="tabWidth">tabWidth</a></code>
1654<dl>
1655<dd>
1656Distance between tab stops, in columns, for display purposes.
1657<p>
1658<b>Default value:</b> 8
1659</dl>
1660
1661<code><a name="telnetPromptPattern">telnetPromptPattern</a></code>
1662<dl>
1663<dd>
1664Regular expression to match prompts in a telnet buffer.
1665<p>
1666<b>Default value:</b> "^[^#$%>]*[#$%>] *|^: *"
1667</dl>
1668
1669<code><a name="ToolBar.isRollover">ToolBar.isRollover</a></code>
1670<dl>
1671<dd>
1672If true, toolbar buttons have dynamic borders which are only painted when the mouse
1673cursor is over the button.  If false, toolbar buttons have normal borders.
1674<p>
1675<b>Default value:</b> true
1676</dl>
1677
1678<code><a name="ToolBar.showIcons">ToolBar.showIcons</a></code>
1679<dl>
1680<dd>
1681If true, toolbar buttons contain icons.
1682<p>
1683<b>Default value:</b> true
1684</dl>
1685
1686<code><a name="ToolBar.showText">ToolBar.showText</a></code>
1687<dl>
1688<dd>
1689If true, toolbar buttons contain text.
1690<p>
1691<b>Default value:</b> true
1692</dl>
1693
1694<code><a name="textFieldFontName">textFieldFontName</a></code>
1695<dl>
1696<dd>
1697Name of font used for textfields in dialogs and the location bar.
1698<p>
1699<b>Default value:</b> Monospaced
1700<p>
1701<b>See also:</b> <a href="#textFieldFontSize">textFieldFontSize</a>,
1702<a href="#dialogFontName">dialogFontName</a>
1703</dl>
1704
1705<code><a name="textFieldFontSize">textFieldFontSize</a></code>
1706<dl>
1707<dd>
1708Size (in points) of font used for textfields in dialogs and the location bar.
1709If this parameter is not specified, the value of
1710<a href="#dialogFontSize">dialogFontSize</a> is used.
1711<p>
1712<b>Default value:</b> None
1713<p>
1714<b>See also:</b> <a href="#textFieldFontName">textFieldFontName</a>,
1715<a href="#dialogFontSize">dialogFontSize</a>
1716</dl>
1717
1718<code><a name="theme">theme</a></code>
1719<dl>
1720<dd>
1721Name of theme file. The specified theme file is loaded as an additional
1722preferences file after ~/.j/prefs is loaded. The idea is to gather all the
1723settings that relate to j's look and feel in one place.
1724<p>
1725<b>Default value:</b> None
1726<p>
1727<b>See also:</b> <code><a href="#themePath">themePath</a></code>
1728</dl>
1729
1730<code><a name="themePath">themePath</a></code>
1731<dl>
1732<dd>
1733A list of directories to search for theme files, if the full path of the theme
1734file isn't specified. The directories in the list must be separated by the
1735platform-specific path separator character, which is a colon for Unix and a
1736semicolon for Windows.
1737<p>
1738<b>Default value:</b> None
1739<p>
1740<b>See also:</b> <code><a href="#theme">theme</a></code>
1741</dl>
1742
1743<code><a name="useIncrementalFind">useIncrementalFind</a></code> <dl> <dd> If
1744true, the primary default global key mapping for <a href="commands.html#find">find</a>,
1745which is Ctrl F, is assigned to <a href="commands.html#incrementalFind">incrementalFind</a>
1746instead. This setting has no effect if you are using a custom global key map.
1747<p>
1748<b>Default value:</b> false
1749</dl>
1750
1751<code><a name="useMenuMnemonics">useMenuMnemonics</a></code>
1752<dl>
1753<dd>
1754If true, mnemonics are used in the top-level menu. Set this to false if you
1755want to make these keystrokes (Alt F, Alt E, etc.) available for mapping
1756commands instead.
1757<p>
1758<b>Default value:</b> true
1759</dl>
1760
1761<code><a name="useTabs">useTabs</a></code>
1762<dl>
1763<dd>
1764If true, actual tab characters are inserted in the buffer. If false, the
1765equivalent number of spaces are inserted instead. Changing the value of this
1766property does not have a retroactive effect on spaces or tab characters that
1767are already in the buffer.
1768<p>
1769<b>Default value:</b> false
1770<p>
1771<b>See also:</b> <a href="commands.html#detabRegion">detabRegion</a>,
1772<a href="commands.html#entabRegion">entabRegion</a>
1773</dl>
1774
1775<code><a name="userFullName">userFullName</a></code>
1776<dl>
1777<dd>
1778The user's full name (e.g. "Enzo Pirelli"), used in constructing the default
1779"From" address for outgoing mail messages.
1780<p>
1781<b>Default value:</b> None
1782<p>
1783<b>See also:</b> <a href="#userMailAddress">userMailAddress</a>,
1784<a href="mail.html">Mail</a>
1785</dl>
1786
1787<code><a name="userMailAddress">userMailAddress</a></code>
1788<dl>
1789<dd>
1790The user's mail address (e.g. "enzo@hotmail.com"), used in constructing the
1791default "From" address for outgoing mail messages.
1792<p>
1793<b>Default value:</b> None
1794<p>
1795<b>See also:</b> <a href="#userFullName">userFullName</a>,
1796<a href="mail.html">Mail</a>
1797</dl>
1798
1799<code><a name="verticalRule">verticalRule</a></code>
1800<dl>
1801<dd>
1802If non-zero, this parameter specifies the column for the vertical rule. The
1803vertical rule is a 1-pixel-wide vertical line that is displayed to the right
1804of the specified column as a reminder of the desired location of the
1805right margin. If this parameter is zero, no vertical rule is displayed.
1806<p>
1807<b>Default value:</b> 0
1808<p>
1809<b>See also:</b> <a href="#color.verticalRule">color.verticalRule</a>
1810</dl>
1811
1812<code><a name="verticalScrollIncrement">verticalScrollIncrement</a></code>
1813<dl>
1814<dd>
1815The number of lines scrolled when you click on the arrow button at the top or
1816bottom of the vertical scroll bar.
1817<p>
1818<b>Default value:</b> 5
1819</dl>
1820
1821<code><a name="wrapCol">wrapCol</a></code>
1822<dl>
1823<dd>
1824The column where text is wrapped by automatic word wrap and by the commands
1825<a href="commands.html#wrapComment">wrapComment</a>,
1826<a href="commands.html#wrapParagraph">wrapParagraph</a> and
1827<a href="commands.html#wrapRegion">wrapRegion</a>.
1828<p>
1829<b>Default value:</b> 80
1830</dl>
1831
1832<code><a name="XmlMode.color.attribute">XmlMode.color.attribute</a></code>
1833<dl>
1834<dd>
1835<p>
1836<b>Default value:</b> None
1837</dl>
1838
1839<code><a name="XmlMode.color.comment">XmlMode.color.comment</a></code>
1840<dl>
1841<dd>
1842<p>
1843<b>Default value:</b> None
1844</dl>
1845
1846<code><a name="XmlMode.color.delimiter">XmlMode.color.delimiter</a></code>
1847<dl>
1848<dd>
1849<p>
1850<b>Default value:</b> None
1851</dl>
1852
1853<code><a name="XmlMode.color.namespace">XmlMode.color.namespace</a></code>
1854<dl>
1855<dd>
1856<p>
1857<b>Default value:</b> None
1858</dl>
1859
1860<code><a name="XmlMode.color.tag">XmlMode.color.tag</a></code>
1861<dl>
1862<dd>
1863<p>
1864<b>Default value:</b> None
1865</dl>
1866
1867<code><a name="XmlMode.fixCase">XmlMode.fixCase</a></code>
1868<dl> <dd>
1869If true, tag and attribute names in XML mode are automatically converted to
1870the preferred case, as specified by <a href="#XmlMode.upperCaseTagNames">XmlMode.upperCaseTagNames</a> and
1871<a href="#XmlMode.upperCaseAttributeNames">XmlMode.upperCaseAttributeNames</a>.
1872<p>
1873<b>Default value:</b> false
1874</dl>
1875
1876<code><a name="XmlMode.upperCaseAttributeNames">XmlMode.upperCaseAttributeNames</a></code>
1877<dl> <dd>
1878If true, upper case is preferred for attribute names in XML mode; otherwise,
1879lower case is preferred.  If <a href="#XmlMode.fixCase">XmlMode.fixCase</a> is true,
1880attribute names are automatically converted to the preferred case as you type them in.
1881<p>
1882<b>Default value:</b> false
1883</dl>
1884
1885<code><a name="XmlMode.upperCaseTagNames">XmlMode.upperCaseTagNames</a></code>
1886<dl> <dd>
1887If true, upper case is preferred for tag names in XML mode; otherwise,
1888lower case is preferred. If <a href="#XmlMode.fixCase">XmlMode.fixCase</a> is true,
1889tag names are automatically converted to the preferred case as you type them in.
1890<p>
1891<b>Default value:</b> true
1892</dl>
1893
1894</body>
1895
1896</html>
Note: See TracBrowser for help on using the repository browser.