PageRenderTime 72ms CodeModel.GetById 49ms app.highlight 17ms RepoModel.GetById 1ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/users-guide/global-opts.html

#
HTML | 98 lines | 98 code | 0 blank | 0 comment | 0 complexity | a1e80a91afeaeb5b7c9c28402ac35d3b MD5 | raw file
 1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Global Options Dialog Box</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="jEdit 4.3 User's Guide"><link rel="up" href="customizing.html" title="Chapter 7. Customizing jEdit"><link rel="prev" href="buffer-local.html" title="Buffer-Local Properties"><link rel="next" href="settings-directory.html" title="The jEdit Settings Directory"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The Global Options Dialog Box</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="buffer-local.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Customizing jEdit</th><td width="20%" align="right"> <a accesskey="n" href="settings-directory.html">Next</a></td></tr></table><hr></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="global-opts"></a>The Global Options Dialog Box</h2></div></div></div><p><span class="guimenu"><strong>Utilities</strong></span>&gt;<span class="guimenuitem"><strong>Global
 2        Options</strong></span> displays the global options dialog box. The dialog
 3        box is divided into several panes, each pane containing a set of related
 4        options. Use the list on the left of the dialog box to switch between
 5        panes. Only panes created by jEdit are described here; some plugins add
 6        their own option panes, and information about them can be found in the
 7        documentation for the plugins in question.</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="general-pane"></a>The General Pane</h3></div></div></div><p>The <span class="guibutton"><strong>General</strong></span> pane contains various
 8            settings, such as the default line separator, the number of recent
 9            files to remember, if the buffer list should be sorted, and so
10            on.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="abbrevs-pane"></a>The Abbreviations Pane</h3></div></div></div><a class="indexterm" name="id2568078"></a><p>The <span class="guibutton"><strong>Abbreviations</strong></span> option pane can be
11            used to enable or disable automatic abbreviation expansion, and to
12            edit currently defined abbreviations.</p><p>The combo box labelled &#8220;<span class="quote">Abbrev set</span>&#8221; selects the
13            abbreviation set to edit. The first entry, &#8220;<span class="quote">global</span>&#8221;,
14            contains abbreviations available in all edit modes. The subsequent
15            entries correspond to each mode's local set of abbreviations.</p><p>To change an abbreviation or its expansion, either
16            double-click the appropriate table entry, or click a table entry and
17            then click the <span class="guibutton"><strong>Edit</strong></span> button. This will display
18            a dialog box for modifying the abbreviation.</p><p>The <span class="guibutton"><strong>Add</strong></span> button displays a dialog box
19            where you can define a new abbreviation. The
20            <span class="guibutton"><strong>Remove</strong></span> button removes the currently selected
21            abbreviation from the list.</p><p>See <a class="xref" href="abbrevs.html#positional-params" title="Positional Parameters">the section called &#8220;Positional Parameters&#8221;</a> for information about
22            positional parameters in abbreviations.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="appearance-pane"></a>The Appearance Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Appearance</strong></span> pane can be used to
23            change the appearance of user interface controls such as buttons,
24            labels and menus. The number of items retained in history text
25            fields can also be set here; see <a class="xref" href="history.html" title="Appendix C. History Text Fields">Appendix C, <i>History Text Fields</i></a>.</p><p>Note that changes to certain settings such as the Swing look
26            and feel require a restart of jEdit to take effect.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="autosave-backups-pane"></a>The Autosave and Backup Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Autosave</strong></span> option pane contains
27            settings for the autosave and backup features. See <a class="xref" href="saving.html#autosave" title="Autosave and Crash Recovery">the section called &#8220;Autosave and Crash Recovery&#8221;</a> and <a class="xref" href="saving.html#backups" title="Backups">the section called &#8220;Backups&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="context-pane"></a>The Context Menu Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Context Menu</strong></span> option pane edits the
28            text area's right-click context menu. See <a class="xref" href="views.html" title="Multiple Views">the section called &#8220;Multiple Views&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="docking-pane"></a>The Docking Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Docking</strong></span> option pane specifies
29            docking location for various dockable windows. Another way to
30            specify docking locations is to use the popup menus associated with
31            each dockable window; see <a class="xref" href="docking.html" title="Window Docking">the section called &#8220;Window Docking&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="editing-pane"></a>The Editing Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Editing</strong></span> option pane contains
32            settings such as the tab size, syntax highlighting and soft tabs on
33            a global or mode-specific basis. </p><p>Changing options from this optionpane does not change XML mode definition files on disk; it merely writes values to the user properties file which
34            override those set in mode files. To find out how to edit mode files directly, see <a class="xref" href="writing-modes-part.html" title="Part II. Writing Edit Modes">Part II, &#8220;Writing Edit Modes&#8221;</a>. Some of these options can be further overridden on an individual file basis through the use of buffer-local properties. </p><p>The <code class="literal">File name
35            glob</code> and <code class="literal">First line glob</code> text
36            fields let you specify a glob pattern that names and first lines of
37            buffers will be matched against to determine the edit mode. See
38            <a class="xref" href="globs.html" title="Appendix D. Glob Patterns">Appendix D, <i>Glob Patterns</i></a> for information about glob patterns.</p><p> The <code class="literal">Extra Word Characters</code> allows you to set the <code class="literal">noLineSep</code> buffer property on a mode-wide basis, allowing you to define what is considered part of a word when double-clicking on it in the text area.
39            </p><p> The <code class="literal">Deep Indent</code> option instructs jEdit to indent subsequent lines so that they line up with the open bracket on the previous line. </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="encodings-pane"></a>The Encodings Pane</h3></div></div></div><p>This option pane is new to jEdit 4.3, and offers international
40            users of jEdit many flexible options for defining how Encodings are
41            handled in jEdit. See <a class="xref" href="encodings.html" title="Character Encodings">the section called &#8220;Character Encodings&#8221;</a> for the
42            basics.</p><p> In previous versions of jEdit, there was very little encoding autodetection, so <span class="guilabel"><strong>use autodetection when possible</strong></span> is an option you can switch on or off.
43            </p><p>The <code class="literal">List of Encoding Autodetector Names</code> is
44            an experimental feature that allows for jEdit and plugins to offer
45            additional encoding autodetector routines. At the moment, there are
46            two techniques known by jEdit: the <code class="literal">BOM</code> (Byte
47            Order Mark), and the <code class="literal">XML-PI</code> (XML processing
48            instruction) techniques. Others can be defined as services and added
49            to this space-separated list. See <a class="ulink" href="../api/org/gjt/sp/jedit/io/EncodingDetector.html" target="_top">EncodingDetector</a>
50            for details on how to offer this service. The order they appear in this
51            list determines the order of detectors that are tried on each file. </p><p>The <code class="literal">List of Fallback Encodings</code> is used when
52            a file fails to open in the default encoding, and the Encoding
53            Autodetectors also fail. The list order here determines the order of
54            encodings that are tried. Each is separated by a space. This is
55            especially handy when doing directory searches through files of
56            different encodings. We suggest using <code class="literal">UTF-8</code> as
57            either your default or one of the fallback encodings.</p><p>While jEdit allows you to edit files in a variety of different
58            encodings, the average user switches between only 2 or 3. In other
59            parts of jEdit, where the list of encodings is displayed in a
60            combobox (such as the buffer options) or a menu (such as
61            <span class="guimenuitem"><strong>File - Reload with Encoding</strong></span> submenu) it
62            may be desirable to display only a subset of available encodings,
63            those that are in common local use. The Encodings checkbox list
64            allows the user to select the subset of supported encodings to
65            display in other GUI components that list all of the
66            encodings.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="gutter-pane"></a>The Gutter Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Gutter</strong></span> option pane contains
67            settings to customize the appearance of the gutter. See <a class="xref" href="overview.html" title="Interface Overview">the section called &#8220;Interface Overview&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="mouse-pane"></a>The Mouse Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Mouse</strong></span> option pane contains settings
68            for toggling drag and drop of text, as well as gutter mouse click
69            behavior.</p><p> The only option that may not be self-explanatory is the  <span class="bold"><strong>Double-Click drag joins non-alphanumeric characters</strong></span>. This option means that double-click will select a region that includes the non-alphabetical characters, as defined for the current mode. The actual set of characters can be defined for an indiviual file via buffer-local properties (<code class="literal">noWordSep</code>) or on a mode-wide basis from the Editing option pane (<code class="literal">Extra Word Characters</code>).
70            </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="printing-pane"></a>The Printing Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Printing</strong></span> option pane contains
71            settings to control the appearance of printed output. Workarounds
72            that might be needed for your Java version to print correctly can
73            also be enabled here. See <a class="xref" href="printing.html" title="Printing">the section called &#8220;Printing&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="pluginmgr-pane"></a>The Plugin Manager Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Plugin Manager</strong></span> pane contains a
74            chooser for the desired download mirror, as well as various settings
75            such as the directory where plugins are to be installed. In addition, you can set the time in minutes that the pluginlist can be cached from jedit.org, helping to reduce the server load. See <a class="xref" href="using-plugins.html" title="Chapter 9. Installing and Using Plugins">Chapter 9, <i>Installing and Using Plugins</i></a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="firewall-pane"></a>The Proxy Servers Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Proxy Servers</strong></span> option pane lets you
76            specify HTTP and SOCKS proxy servers to use when jEdit makes network
77            connections, for example when downloading plugins.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="shortcuts-pane"></a>The Shortcuts Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Shortcuts</strong></span> option pane associates
78            keyboard shortcuts with commands. Each command can have up to two
79            shortcuts associated with it.</p><p>The combo box at the top of the option pane selects the
80            command set to edit. Command sets include the set of all built-in
81            commands, the commands of each plugin, and the set of macros.</p><p>To change a shortcut, click the appropriate table entry and
82            press the keys you want associated with that command in the
83            resulting dialog box. The dialog box will warn you if the shortcut
84            is already assigned.</p><h4><a name="id2568820"></a> 2-key shortcut prefixes </h4><p> Some shortcuts, such as C+e, C+m, and C+r, are prefixes for two-keystroke shortcuts. Another  keystroke may be used as a prefix in a 2-key shortcut, so for example, C+x can be redefined as a prefix to make it more emacs-like, by mapping any other action to a C+x prefixed shortcut.</p><p> Conversely, emacs users will notice at first that C+e can not be mapped as a single key shortcut to go to the end of the line, unless all of the other actions that contain C+e prefixed shortcuts are remapped to other shortcuts first. After that, C+e can be bound to end-of-line. </p><p> The default shortcuts can be found in  <code class="literal">jedit_keys.props</code>. </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="status-bar-pane"></a>The Status Bar Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Status Bar</strong></span> option pane contains
85            settings to customize the status bar, or disable it completely. See
86            <a class="xref" href="status-bar.html" title="The Status Bar">the section called &#8220;The Status Bar&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="syntax-hilite-pane"></a>The Syntax Highlighting Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Syntax Highlighting</strong></span> pane can be
87            used to customize the fonts and colors for syntax highlighting. See
88            <a class="xref" href="modes.html#syntax-hilite" title="Syntax Highlighting">the section called &#8220;Syntax Highlighting&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="text-area-pane"></a>The Text Area Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Text Area</strong></span> pane contains settings to
89            customize the appearance of the text area. See <a class="xref" href="overview.html" title="Interface Overview">the section called &#8220;Interface Overview&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="toolbar-pane"></a>The Tool Bar Pane</h3></div></div></div><p>The <span class="guibutton"><strong>Tool Bar</strong></span> option pane lets you edit
90            the tool bar, or disable it completely. See <a class="xref" href="views.html" title="Multiple Views">the section called &#8220;Multiple Views&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="view-pane"></a>The View Pane</h3></div></div></div><p>The <span class="guibutton"><strong>View</strong></span> option pane lets you change
91            various settings related to the editor window's appearance,
92            including the arrangement of dockable windows, and if the search bar
93            and buffer switcher should be visible. See <a class="xref" href="views.html" title="Multiple Views">the section called &#8220;Multiple Views&#8221;</a>.</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="vfs-browser-pane"></a>The File System Browser Panes</h3></div></div></div><p>The <span class="guibutton"><strong>File System Browser</strong></span> group contains
94            two option panes, <span class="guibutton"><strong>General</strong></span> and
95            <span class="guibutton"><strong>Colors</strong></span>. The former contains various file
96            system browser settings. The latter configures glob patterns used
97            for coloring the file list. See <a class="xref" href="vfs-browser.html" title="The File System Browser (FSB)">the section called &#8220;The File System Browser (FSB)&#8221;</a> for
98            more information.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="buffer-local.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="customizing.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="settings-directory.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Buffer-Local Properties </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> The jEdit Settings Directory</td></tr></table></div></body></html>