/www/tags/NOV_07_2009/htdocs/42docs/users-guide/settings-directory.html
HTML | 58 lines | 58 code | 0 blank | 0 comment | 0 complexity | 4a61eb137c39787158af7ea2305d0aa1 MD5 | raw file
Possible License(s): BSD-3-Clause, AGPL-1.0, Apache-2.0, LGPL-2.0, LGPL-3.0, GPL-2.0, CC-BY-SA-3.0, LGPL-2.1, GPL-3.0, MPL-2.0-no-copyleft-exception, IPL-1.0
- <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The jEdit Settings Directory</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="jEdit 4.2 User's Guide"><link rel="up" href="customizing.html" title="Chapter 7. Customizing jEdit"><link rel="previous" href="global-opts.html" title="The Global Options Dialog Box"><link rel="next" href="using-macros.html" title="Chapter 8. Using Macros"></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 jEdit Settings Directory</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="global-opts.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Customizing jEdit</th><td width="20%" align="right"> <a accesskey="n" href="using-macros.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="settings-directory"></a>The jEdit Settings Directory</h2></div></div><div></div></div><p>
- jEdit stores settings, macros, and plugins as files
- inside the <i class="firstterm">settings directory</i>. In most cases, editing
- these files by hand is not necessary, since graphical tools and editor
- commands can do the job. However, being familiar with the structure of the
- settings directory still comes in handy
- in certain situations, for example when you want to copy jEdit settings
- between computers.
- </p><p>
- The location of the settings directory is system-specific; it is printed to
- the activity log
- (<span><b class="guimenu">Utilities</b></span>><span><b class="guisubmenu">Troubleshooting</b></span>><span><b class="guimenuitem">Activity
- Log</b></span>). For example:
- </p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen">[message] jEdit: Settings directory is /home/slava/.jedit</pre></td></tr></table><p>
- Specifying the <b class="userinput"><tt>-settings</tt></b> switch on the command line
- instructs jEdit to store settings in a directory other than the default.
- For example, the following command will instruct jEdit to
- store all settings
- in the <tt class="filename">jedit</tt> subdirectory of the <tt class="filename">C:</tt>
- drive:
- </p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen"><tt class="prompt">C:\jedit></tt> <b class="userinput"><tt>jedit -settings=C:\jedit</tt></b></pre></td></tr></table><p>
- The <b class="userinput"><tt>-nosettings</tt></b> switch will force jEdit to not look for
- or create a settings directory; default settings will be used instead.
- </p><p>
- jEdit creates the following files and directories
- inside the settings directory; plugins may add more:
- </p><div class="itemizedlist"><ul type="disc"><li><p><tt class="filename">abbrevs</tt> - a plain text file which
- stores all defined abbreviations. See <a href="abbrevs.html" title="Abbreviations">the section called “Abbreviations”</a>.
- </p></li><li><p><tt class="filename">activity.log</tt> - a plain text file which
- contains the full activity log. See <a href="activity-log.html" title="Appendix B. The Activity Log">Appendix B, <i>The Activity Log</i></a>.
- </p></li><li><p><tt class="filename">history</tt> - a plain text file which
- stores history lists, used by history text fields and the
- <span><b class="guimenu">Edit</b></span>><span><b class="guimenuitem">Paste Previous</b></span> command.
- See <a href="text-transfer.html" title="Transferring Text">the section called “Transferring Text”</a> and <a href="history.html" title="Appendix C. History Text Fields">Appendix C, <i>History Text Fields</i></a>.
- </p></li><li><p><tt class="filename">jars</tt> - this directory contains
- plugins. See <a href="using-plugins.html" title="Chapter 9. Installing and Using Plugins">Chapter 9, <i>Installing and Using Plugins</i></a>.</p></li><li><p><tt class="filename">jars-cache</tt> - this directory contains
- plugin cache files which decrease the time to start jEdit. They are automatically updated when plugins are installed or updated.</p></li><li><p><tt class="filename">killring.xml</tt> - stores recently deleted text. See <a href="text-transfer.html" title="Transferring Text">the section called “Transferring Text”</a>.</p></li><li><p><tt class="filename">macros</tt> - this directory contains
- macros. See <a href="using-macros.html" title="Chapter 8. Using Macros">Chapter 8, <i>Using Macros</i></a>.</p></li><li><p><tt class="filename">modes</tt> - this directory contains custom
- edit modes. See <a href="writing-modes-part.html" title="Part II. Writing Edit Modes">Part II, “Writing Edit Modes”</a>.
- </p></li><li><p><tt class="filename">perspective.xml</tt> - an XML file that stores the list of open buffers and views used to maintain editor state between sessions.</p></li><li><p><tt class="filename">PluginManager.download</tt> - this directory
- is usually empty. It only contains files while the plugin manager is
- downloading a plugin. For information about the plugin manager,
- see <a href="using-plugins.html" title="Chapter 9. Installing and Using Plugins">Chapter 9, <i>Installing and Using Plugins</i></a>.</p></li><li><p><tt class="filename">printspec</tt> - a binary file that
- stores printing settings when running under Java 2 version 1.4.
- </p></li><li><p><tt class="filename">properties</tt> - a plain text file that
- stores the majority of jEdit's settings.</p></li><li><p><tt class="filename">recent.xml</tt> - an XML file which stores
- the list of recently opened files. jEdit remembers the caret position and
- character encoding of each recent file, and
- automatically restores those values when one of the files is opened.
- </p></li><li><p><tt class="filename">registers.xml</tt> - an XML file that stores
- register contents. See <a href="text-transfer.html#registers" title="General Register Commands">the section called “General Register Commands”</a> for more information
- about registers.
- </p></li><li><p><tt class="filename">server</tt> - a plain text file that only
- exists while jEdit is running. The edit server's port number and
- authorization key is stored here. See <a href="starting.html" title="Chapter 2. Starting jEdit">Chapter 2, <i>Starting jEdit</i></a>.
- </p></li><li><p><tt class="filename">settings-backup</tt> - this directory
- contains numbered backups of all automatically-written settings files.
- </p></li></ul></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="global-opts.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="using-macros.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Global Options Dialog Box </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 8. Using Macros</td></tr></table></div></body></html>