PageRenderTime 42ms CodeModel.GetById 33ms app.highlight 7ms RepoModel.GetById 1ms app.codeStats 0ms

/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
 1<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>
 2   jEdit stores settings, macros, and plugins as files
 3   inside the <i class="firstterm">settings directory</i>. In most cases, editing
 4   these files by hand is not necessary, since graphical tools and editor
 5   commands can do the job. However, being familiar with the structure of the
 6   settings directory still comes in handy
 7   in certain situations, for example when you want to copy jEdit settings
 8   between computers.
 9  </p><p>
10   The location of the settings directory is system-specific; it is printed to
11   the activity log
12   (<span><b class="guimenu">Utilities</b></span>&gt;<span><b class="guisubmenu">Troubleshooting</b></span>&gt;<span><b class="guimenuitem">Activity
13   Log</b></span>). For example:
14  </p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen">[message] jEdit: Settings directory is /home/slava/.jedit</pre></td></tr></table><p>
15   Specifying the <b class="userinput"><tt>-settings</tt></b> switch on the command line
16   instructs jEdit to store settings in a directory other than the default.
17   For example, the following command will instruct jEdit to
18   store all settings
19   in the <tt class="filename">jedit</tt> subdirectory of the <tt class="filename">C:</tt>
20   drive:
21  </p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen"><tt class="prompt">C:\jedit&gt;</tt> <b class="userinput"><tt>jedit -settings=C:\jedit</tt></b></pre></td></tr></table><p>
22   The <b class="userinput"><tt>-nosettings</tt></b> switch will force jEdit to not look for
23   or create a settings directory; default settings will be used instead.
24  </p><p>
25   jEdit creates the following files and directories
26   inside the settings directory; plugins may add more:
27  </p><div class="itemizedlist"><ul type="disc"><li><p><tt class="filename">abbrevs</tt> - a plain text file which
28   stores all defined abbreviations. See <a href="abbrevs.html" title="Abbreviations">the section called &#8220;Abbreviations&#8221;</a>.
29   </p></li><li><p><tt class="filename">activity.log</tt> - a plain text file which
30   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>.
31   </p></li><li><p><tt class="filename">history</tt> - a plain text file which
32   stores history lists, used by history text fields and the
33   <span><b class="guimenu">Edit</b></span>&gt;<span><b class="guimenuitem">Paste Previous</b></span> command.
34   See <a href="text-transfer.html" title="Transferring Text">the section called &#8220;Transferring Text&#8221;</a> and <a href="history.html" title="Appendix C. History Text Fields">Appendix C, <i>History Text Fields</i></a>.
35   </p></li><li><p><tt class="filename">jars</tt> - this directory contains
36   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
37   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 &#8220;Transferring Text&#8221;</a>.</p></li><li><p><tt class="filename">macros</tt> - this directory contains
38   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
39   edit modes. See <a href="writing-modes-part.html" title="Part II. Writing Edit Modes">Part II, &#8220;Writing Edit Modes&#8221;</a>.
40   </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
41   is usually empty. It only contains files while the plugin manager is
42   downloading a plugin. For information about the plugin manager,
43   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
44   stores printing settings when running under Java 2 version 1.4.
45   </p></li><li><p><tt class="filename">properties</tt> - a plain text file that
46   stores the majority of jEdit's settings.</p></li><li><p><tt class="filename">recent.xml</tt> - an XML file which stores
47   the list of recently opened files. jEdit remembers the caret position and
48   character encoding of each recent file, and
49   automatically restores those values when one of the files is opened.
50   </p></li><li><p><tt class="filename">registers.xml</tt> - an XML file that stores
51   register contents. See <a href="text-transfer.html#registers" title="General Register Commands">the section called &#8220;General Register Commands&#8221;</a> for more information
52   about registers.
53   </p></li><li><p><tt class="filename">server</tt> - a plain text file that only
54   exists while jEdit is running. The edit server's port number and
55   authorization key is stored here. See <a href="starting.html" title="Chapter 2. Starting jEdit">Chapter 2, <i>Starting jEdit</i></a>.
56   </p></li><li><p><tt class="filename">settings-backup</tt> - this directory
57   contains numbered backups of all automatically-written settings files.
58   </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>