The Global Options Dialog Box

Utilities>Global Options displays the global options dialog box. The dialog box is divided into several panes, each pane containing a set of related options. Use the list on the left of the dialog box to switch between panes. Only panes created by jEdit are described here; some plugins add their own option panes, and information about them can be found in the documentation for the plugins in question.

The Abbreviations Pane

The Abbreviations option pane can be used to enable or disable automatic abbreviation expansion, and to edit currently defined abbreviations.

The combo box labelled “Abbrev set” selects the abbreviation set to edit. The first entry, “global”, contains abbreviations available in all edit modes. The subsequent entries correspond to each mode's local set of abbreviations.

To change an abbreviation or its expansion, either double-click the appropriate table entry, or click a table entry and then click the Edit button. This will display a dialog box for modifying the abbreviation.

The Add button displays a dialog box where you can define a new abbreviation. The Remove button removes the currently selected abbreviation from the list.

See the section called “Positional Parameters” for information about positional parameters in abbreviations.

The Appearance Pane

The Appearance pane can be used to change the appearance of user interface controls such as buttons, labels and menus. The number of items retained in history text fields can also be set here; see Appendix C, History Text Fields.

Note that changes to certain settings such as the Swing look and feel require a restart of jEdit to take effect.

The Autosave and Backup Pane

The Autosave option pane contains settings for the autosave and backup features. See the section called “Autosave and Crash Recovery” and the section called “Backups”.

The Context Menu Pane

The Context Menu option pane edits the text area's right-click context menu. See the section called “Multiple Views”.

The Docking Pane

The Docking option pane specifies docking location for various dockable windows. Another way to specify docking locations is to use the popup menus associated with each dockable window; see the section called “Window Docking”.

The Editing Pane

The Editing option pane contains settings such as the tab size, syntax highlighting and soft tabs on a global or mode-specific basis.

When changing mode-specific settings, the File name glob and First line glob text fields let you specify a glob pattern that names and first lines of buffers will be matched against to determine the edit mode. See Appendix D, Glob Patterns for information about glob patterns.

This option pane does not change XML mode definition files on disk; it merely writes values to the user properties file which override those set in mode files. To find out how to edit mode files directly, see Part II, “Writing Edit Modes”.

The General Pane

The General pane contains various miscellaneous settings, such as the default line separator and file encoding, the number of recent files to remember, if the buffer list should be sorted, and so on.

The Gutter Pane

The Gutter option pane contains settings to customize the appearance of the gutter. See the section called “Interface Overview”.

The Mouse Pane

The Mouse option pane contains settings for toggling drag and drop of text, as well as gutter mouse click behavior.

The Printing Pane

The Printing option pane contains settings to control the appearance of printed output. Workarounds that might be needed for your Java version to print correctly can also be enabled here. See the section called “Printing”.

The Plugin Manager Pane

The Plugin Manager pane contains a chooser for the desired download mirror, as well as various settings such as the directory where plugins are to be installed. See Chapter 9, Installing and Using Plugins.

The Proxy Servers Pane

The Proxy Servers option pane lets you specify HTTP and SOCKS proxy servers to use when jEdit makes network connections, for example when downloading plugins.

The Shortcuts Pane

The Shortcuts option pane associates keyboard shortcuts with commands. Each command can have up to two shortcuts associated with it.

The combo box at the top of the option pane selects the command set to edit. Command sets include the set of all built-in commands, the commands of each plugin, and the set of macros.

To change a shortcut, click the appropriate table entry and press the keys you want associated with that command in the resulting dialog box. The dialog box will warn you if the shortcut is already assigned.

The Status Bar Pane

The Status Bar option pane contains settings to customize the status bar, or disable it completely. See the section called “The Status Bar”.

The Syntax Highlighting Pane

The Syntax Highlighting pane can be used to customize the fonts and colors for syntax highlighting. See the section called “Syntax Highlighting”.

The Text Area Pane

The Text Area pane contains settings to customize the appearance of the text area. See the section called “Interface Overview”.

The Tool Bar Pane

The Tool Bar option pane lets you edit the tool bar, or disable it completely. See the section called “Multiple Views”.

The View Pane

The View option pane lets you change various settings related to the editor window's appearance, including the arrangement of dockable windows, and if the search bar and buffer switcher should be visible. See the section called “Multiple Views”.

The File System Browser Panes

The File System Browser group contains two option panes, General and Colors. The former contains various file system browser settings. The latter configures glob patterns used for coloring the file list. See the section called “The File System Browser” for more information.