PageRenderTime 64ms CodeModel.GetById 12ms app.highlight 38ms RepoModel.GetById 1ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/FAQ/general.html

#
HTML | 324 lines | 324 code | 0 blank | 0 comment | 0 complexity | 13e1c9b8060b3636d0b89d06b8009bdb MD5 | raw file
  1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>General Questions</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="jEdit Frequently Asked Questions"><link rel="up" href="index.html" title="jEdit Frequently Asked Questions"><link rel="prev" href="intro.html" title="Introduction"><link rel="next" href="installation.html" title="Installation Questions"></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">General Questions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="intro.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="installation.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="general"></a>General Questions</h2></div></div></div><p>This section deals with some background information, how to obtain the
  2    latest version of jEdit and how to obtain further information/help.</p><div class="qandaset"><dl><dt>1.  <a href="general.html#about">About jEdit</a></dt><dd><dl><dt>Q: <a href="general.html#id2497958">What is jEdit?</a></dt><dt>Q: <a href="general.html#id2498357">What is the difference between a text editor and a
  3                    word processor?</a></dt><dt>Q: <a href="general.html#id2497755">What features does jEdit have?</a></dt><dt>Q: <a href="general.html#id2495870">What is a jEdit &#8220;plugin&#8221;?</a></dt><dt>Q: <a href="general.html#id2495930">How do I get documentation on jEdit?</a></dt><dt>Q: <a href="general.html#id2495968">Is there a newsgroup or mailing list devoted to
  4                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496091">Is there a web site devoted to jEdit?</a></dt><dt>Q: <a href="general.html#id2496162">Are there copyright restrictions on the use of
  5                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496234">Is jEdit only useful for programming in Java?</a></dt><dt>Q: <a href="general.html#id2496273">Do I need to know Java to use jEdit?</a></dt><dt>Q: <a href="general.html#id2496316">What software do I need to install and run
  6                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496358">I've just started to learn programming. Is jEdit a
  7                    good choice for my first text editor?</a></dt></dl></dd><dt>2.  <a href="general.html#get-answers-div">Getting answers</a></dt><dd><dl><dt>Q: <a href="general.html#id2496412">How do I get answers to my questions about
  8                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496507">Where can I get interactive help for jEdit?</a></dt></dl></dd><dt>3.  <a href="general.html#bugs">Reporting bugs</a></dt><dd><dl><dt>Q: <a href="general.html#id2496554">How do I report a bug I have found in jEdit?</a></dt><dt>Q: <a href="general.html#id2496604">What information should I include in a bug
  9                    report?</a></dt><dt>Q: <a href="general.html#id2496688">How do I track the status of a jEdit bug
 10                    report?</a></dt></dl></dd><dt>4.  <a href="general.html#contact">Contacting jEdit developers</a></dt><dd><dl><dt>Q: <a href="general.html#id2496744">How do I contact members of the jEdit developer
 11                    team?</a></dt></dl></dd><dt>5.  <a href="general.html#latest-version">Getting the latest version</a></dt><dd><dl><dt>Q: <a href="general.html#id2496803">How do I obtain the latest version of jEdit?</a></dt><dt>Q: <a href="general.html#id2547149">How do I obtain a copy of the jEdit source
 12                    code?</a></dt><dt>Q: <a href="general.html#id2547203">Where can I get the latest version of this
 13                    document?</a></dt><dt>Q: <a href="general.html#id2547230">How do you set the classpath and compile the Java
 14                    files in jEdit?</a></dt></dl></dd></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 class="title"><a name="about"></a>1. About jEdit</h4></td></tr><tr class="toc"><td align="left" valign="top" colspan="2"><dl><dt>Q: <a href="general.html#id2497958">What is jEdit?</a></dt><dt>Q: <a href="general.html#id2498357">What is the difference between a text editor and a
 15                    word processor?</a></dt><dt>Q: <a href="general.html#id2497755">What features does jEdit have?</a></dt><dt>Q: <a href="general.html#id2495870">What is a jEdit &#8220;plugin&#8221;?</a></dt><dt>Q: <a href="general.html#id2495930">How do I get documentation on jEdit?</a></dt><dt>Q: <a href="general.html#id2495968">Is there a newsgroup or mailing list devoted to
 16                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496091">Is there a web site devoted to jEdit?</a></dt><dt>Q: <a href="general.html#id2496162">Are there copyright restrictions on the use of
 17                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496234">Is jEdit only useful for programming in Java?</a></dt><dt>Q: <a href="general.html#id2496273">Do I need to know Java to use jEdit?</a></dt><dt>Q: <a href="general.html#id2496316">What software do I need to install and run
 18                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496358">I've just started to learn programming. Is jEdit a
 19                    good choice for my first text editor?</a></dt></dl></td></tr><tr class="question"><td align="left" valign="top"><a name="id2497958"></a><a name="whatis"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>What is jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>jEdit is a programmer's text editor written in Java,
 20                    originally developed by Slava Pestov, now maintained by
 21                    others. It has an easy to use interface that resembles that
 22                    of many other Windows and MacOS text editors. It is also
 23                    highly customizable, and contains a &#8220;<span class="quote">plugin</span>&#8221;
 24                    architecture that allows its features to be extended by
 25                    additional programs.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2498357"></a><a name="difftext"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>What is the difference between a text editor and a
 26                    word processor?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>These categories are not absolute but refer to the
 27                    primary purpose of an editing program and the focus of its
 28                    features.</p><p>A text editor is an application that edits files
 29                    containing plain text without automatically formatting the
 30                    text for printing or other publication. Typically the
 31                    contents of such a file consists of data used by another
 32                    application - for example, source code that a compiler will
 33                    process or markup text that a web browser will display. A
 34                    word processor deals with the preparation of documents for
 35                    printing or similar publication. Besides editing text, a
 36                    modern word processor allows the user to choose multiple
 37                    fonts, margin sizes, line spacing, indentation, and a
 38                    variety of other details that affect the appearance of the
 39                    document being edited. In a text editor, these features are
 40                    present, if at all, only in a basic form, and for the
 41                    limited purpose of helping the user compose and organize the
 42                    text. In place of word processing features, a text editor
 43                    contains many features that allow the user to prepare and
 44                    work with text quickly and efficiently.</p><p>The jEdit application is a text editor, not a word
 45                    processor. It contains a large assortment of features for
 46                    manipulating source code, markup text, and other text files.
 47                    As a programmer's text editor, it also has many features to
 48                    help programmers manage their projects and work with other
 49                    programming tools.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2497755"></a><a name="features"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>What features does jEdit have?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>The short answer is, too many to list here. There is a
 50                    detailed list available on the <a class="ulink" href="http://www.jedit.org/index.php?page=features" target="_top">jEdit web
 51                    site</a>, but here are some of the major
 52                    features:</p><div class="itemizedlist"><ul type="disc"><li><p>Comprehensive online help</p></li><li><p>Multiple editor windows and split editing panes
 53                            within a single editing window</p></li><li><p>Unlimited undo/redo</p></li><li><p>Copy and paste with an unlimited number of
 54                            clipboards (known as &#8220;<span class="quote">registers</span>&#8221;)</p></li><li><p>&#8220;<span class="quote">Markers</span>&#8221; for remembering
 55                            positions in files to return to later</p></li><li><p>Rectangular selection</p></li><li><p>Multiple selection for manipulating several
 56                            chunks of text at once</p></li><li><p>Syntax highlighting for more than 80 file
 57                            types</p></li><li><p>Intelligent bracket matching that skips quoted
 58                            literals and comments</p></li><li><p>Auto indent and word wrap</p></li><li><p>Abbreviations</p></li><li><p>&#8220;<span class="quote">Folding</span>&#8221; display mode that hides
 59                            levels of indented text specified by the user</p></li><li><p>Search and replace using both literal text and
 60                            regular expressions</p></li><li><p>&#8220;<span class="quote">HyperSearch</span>&#8221; option to show all
 61                            found matches in a list</p></li><li><p>File management functions available from within
 62                            jEdit, including deleting and renaming files and
 63                            creating new directories</p></li><li><p>Choice of character encoding for loading and
 64                            saving files</p></li><li><p>Automatic compression and decompression of
 65                            GZipped (.gz) files</p></li><li><p>Plugin support for loading files from ZIP and
 66                            TAR archives</p></li><li><p>Plugin support for loading and saving files on
 67                            FTP servers</p></li><li><p>Fully customizable keyboard shortcuts, tool bar
 68                            and right-click context menu</p></li><li><p>Macro system permitting recording and writing
 69                            of macros in the BeanShell scripting language</p></li><li><p>An internal &#8220;<span class="quote">plugin manager</span>&#8221; that
 70                            downloads and installs new and updated plugins from
 71                            within jEdit</p></li></ul></div></td></tr><tr class="question"><td align="left" valign="top"><a name="id2495870"></a><a name="what-plugin"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>What is a jEdit &#8220;<span class="quote">plugin</span>&#8221;?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>A plugin is an application that is designed to work
 72                    with jEdit by providing additional features that can be used
 73                    from within the main program. Often the plugin will provide
 74                    a visible user interface in a window that can be docked to
 75                    jEdit's main view window.</p><p>There are currently over 120 publicly available
 76                    plugins that provide such services as a Java source code
 77                    browser, a command-line shell, templated text insertion, and
 78                    source code project management. They can be downloaded,
 79                    installed, and kept current from within jEdit's
 80                    &#8220;<span class="quote">Plugin Manager</span>&#8221;. There is also a section of
 81                    the jEdit web site called <a class="ulink" href="http://plugins.jedit.org/" target="_top">Plugin Central</a> that
 82                    maintains a descriptive index and download links for all
 83                    publicly available plugins.</p><p>Additional questions and answers regarding plugins may
 84                    be found in the section of this document entitled
 85                    &#8220;<span class="quote">Working with Plugins</span>&#8221;.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2495930"></a><a name="get-doc"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I get documentation on jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>There is a comprehensive User's Guide available from
 86                    within the program using the <span class="guimenu"><strong>Help</strong></span> menu.
 87                    The User's Guide can also be downloaded from the <a class="ulink" href="http://www.jedit.org/index.php?page=download&amp;platform=source" target="_top">
 88                    jEdit web site</a> in Portable Document Format (PDF),
 89                    suitable for online display or printing.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2495968"></a><a name="is-newsgroup"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Is there a newsgroup or mailing list devoted to
 90                    jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Currently there is no newsgroup devoted to jEdit.
 91                    There are three active mailing lists that are freely
 92                    available by subscription:</p><div class="itemizedlist"><ul type="disc"><li><p>The <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-users" target="_top">
 93                            jedit-users list</a>, for comments and questions
 94                            about using jEdit and its features</p></li><li><p>The <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-devel" target="_top">
 95                            jedit-devel list</a>, for discussion of
 96                            development issues by members of the developer team
 97                            and other interested persons</p></li><li><p>The <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-announce" target="_top">
 98                            jedit-announce list</a>, a low-volume list used
 99                            for announcing new releases of jEdit and
100                            plugins</p></li></ul></div><p>Each of these lists can be obtained on a full-text
101                    message or a daily digest basis. The daily digest bundles
102                    groups of postings in a single email message.</p><p>If you are only interested in version announcements
103                    and plugin updates, <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-announce" target="_top">
104                    subscribe to the jedit-announce list</a>. If you would
105                    like to participate in discussion or ask questions regarding
106                    jEdit, <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-users" target="_top">subscribe
107                    to the jedit-users list</a>. If you are interested in
108                    jEdit's development or want to write plugins, <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-devel" target="_top">
109                    subscribe to jedit-devel</a>.</p><p>Do not cross-post to both lists. All jEdit developers
110                    are subscribed to both the jedit-users and jedit-devel
111                    lists, so a post to jedit-users will be seen by most members
112                    of both lists. Also, keep in mind that both jEdit-users and
113                    jEdit-devel are high-traffic lists, and can fill up your
114                    mailbox unless you check your email regularly.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496091"></a><a name="is-website"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Is there a web site devoted to jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>There are several. The official <a class="ulink" href="http://www.jedit.org" target="_top">jEdit web site</a> contains
115                    extensive information on all things having to do with jEdit.
116                    There are also resources available for those interested in
117                    jEdit development on the <a class="ulink" href="http://sourceforge.net/projects/jedit" target="_top">jEdit project
118                    page</a> of the <a class="ulink" href="http://sourceforge.net" target="_top">SourceForge web
119                    site</a>.</p><p>The <a class="ulink" href="http://community.jedit.org" target="_top">jEdit
120                    Community</a> web site has articles on jEdit and related
121                    topics, user-submitted macros and other download resources,
122                    and listings of web links of interest to jEdit users. It has
123                    a message board system to allow users to ask questions and
124                    provide feedback on the project without having to subscribe
125                    to jEdit's mailing lists. Because the message boards have
126                    relatively low volume, using the mailing lists will often be
127                    a more effective approach.</p><p>The jEdit Community site also has an
128                    &#8220;<span class="quote">Interactive FAQ</span>&#8221; facility that allows you to
129                    post questions to be answered by other users, and a
130                    screenshot gallery containing images submitted by
131                    users.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496162"></a><a name="copyright"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Are there copyright restrictions on the use of
132                    jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>The jEdit application is free, &#8220;<span class="quote">Open
133                    Source</span>&#8221; software released under the <a class="ulink" href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html" target="_top">
134                    GNU General Public License 2.0</a>. This ensures that
135                    jEdit and its source code remains freely available for use
136                    and distribution by the public. For specific copyright
137                    questions, you should review the GPL 2.0 and seek
138                    appropriate advice. Broadly speaking, there are no
139                    restrictions on the use of the program as a text editor, and
140                    its source code can be copied or modified for use in another
141                    program that is governed by the General Public
142                    License.</p><p>Plugin application that are available using jEdit's
143                    Plugin Manager facility, as well as plugins available
144                    through the <a class="ulink" href="http://plugins.jedit.org" target="_top">Plugin
145                    Central</a> web site or <a class="ulink" href="http://community.jedit.org" target="_top">jEdit Community</a>,
146                    are governed either by the General Public License or another
147                    commonly recognized &#8220;<span class="quote">Open Source</span>&#8221; software
148                    license. This means that use of the application, including
149                    use for commercial purposes, is unrestricted without any
150                    requirement of royalty or license fee payments. To
151                    incorporate source code or an application or plugin as a
152                    whole in another application, you must consult the specific
153                    license terms to determine whether and on what basis you are
154                    permitted to do so.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496234"></a><a name="java-only"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Is jEdit only useful for programming in Java?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Absolutely not. Many of the jEdit's plugin
155                    applications, and a few of the macros distributed with the
156                    program, target the Java language or integrate tools used in
157                    Java development. However, the core application is designed
158                    to work with any programming or markup language. Included
159                    with jEdit are packages providing syntax highlighting,
160                    abbreviations and other programming support for over 60
161                    programming languages and file types, including C, C++, C#,
162                    Cobol, HTML, Java, Javascript, Lisp, Pascal, Perl, PHP,
163                    Python, Ruby, TCL, Visual Basic and XML. The full list can
164                    be found on the <a class="ulink" href="http://www.jedit.org/index.php?page=features" target="_top">jEdit web
165                    site</a>.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496273"></a><a name="knowing-java"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Do I need to know Java to use jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>No. In fact, you do not need to know any specific
166                    programming language other than the ones with which you
167                    work.</p><p>At some point in your use of jEdit, you will no doubt
168                    want to write your own macros to execute long or complex
169                    routines with a single command or keyboard shortcut. Macros
170                    in jEdit are written in a simplified dialect of Java called
171                    <a class="ulink" href="http://www.beanshell.org" target="_top"> BeanShell</a>.
172                    Its syntax will be familiar to users of Java, C++ and other
173                    object-oriented languages, and it is not hard to learn even
174                    if you have no experience with those languages. The User's
175                    Guide provided with jEdit contains an extensive tutorial on
176                    writing macros.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496316"></a><a name="needed-software"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>What software do I need to install and run
177                    jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Since jEdit runs on a Java platform, at a minimum you
178                    will need a Java Runtime Environment (JRE) package. If you
179                    are planning to use jEdit to program in Java, you will need
180                    a full Java Development Kit (JDK) package. We recommend
181                    obtaining a JDK package.</p><p>The current version of jEdit, version 4.3, requires a
182                    Java runtime environment having a release version of 1.5 or
183                    greater. It will not run on versions 1.4 or 1.3. The <a class="ulink" href="http://www.jedit.org/index.php?page=compatibility" target="_top">jEdit
184                    web site</a> contains a detailed discussion on the
185                    compatibility of various publicly available JDK's for the
186                    major operating systems.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496358"></a><a name="just-learning"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I've just started to learn programming. Is jEdit a
187                    good choice for my first text editor?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>It is an excellent choice. Its basic features are
188                    extremely easy to use, and you will find things like
189                    abbreviations, keyboard shortcuts and macros to be great
190                    time-savers. It has built-in packages called &#8220;<span class="quote">edit
191                    modes</span>&#8221; that automatically display keywords, tags, and
192                    other program elements in different colors, making it easier
193                    to view and organize your code. It works well with many Open
194                    Source and proprietary programming tools. Because of its
195                    extensive customization features, it can adapt to your
196                    preferences and work patterns as you become more
197                    experienced. Finally, it's free, so you can buy a lot of
198                    programming texts with the money you will save.</p></td></tr><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 class="title"><a name="get-answers-div"></a>2. Getting answers</h4></td></tr><tr class="toc"><td align="left" valign="top" colspan="2"><dl><dt>Q: <a href="general.html#id2496412">How do I get answers to my questions about
199                    jEdit?</a></dt><dt>Q: <a href="general.html#id2496507">Where can I get interactive help for jEdit?</a></dt></dl></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496412"></a><a name="get-answers"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I get answers to my questions about
200                    jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>You should look for answers in the following
201                    places:</p><div class="itemizedlist"><ul type="disc"><li><p>The User's Guide available from the
202                            application's <span class="guimenu"><strong>Help</strong></span> menu.</p></li><li><p>This FAQ document.</p></li><li><p>The archives of jEdit's mailing lists. Archives
203                            for both the <a class="ulink" href="http://www.geocrawler.com/redir-sf.php3?list=jedit-users" target="_top">
204                            jedit-users list</a> and the <a class="ulink" href="http://www.geocrawler.com/redir-sf.php3?list=jedit-devel" target="_top">
205                            jedit-devel list</a> are available.</p></li></ul></div><p>If you cannot find help using those resources, post
206                    your question to the <a class="ulink" href="mailto:jedit-users@lists.sourceforge.net" target="_top"> jedit-users
207                    list</a>. You will have to <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-users" target="_top">
208                    subscribe to the mailing list</a> in order to post, but
209                    it is well worth it, and you can elect to have daily bundles
210                    of messages sent to you to keep email traffic down. Many
211                    questions are answered on the mailing list within 24 hours.
212                    The developers who respond to user questions generally do
213                    not send direct replies, so you will need to monitor
214                    messages from the mailing list is order to obtain an
215                    answer.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496507"></a><a name="interactive-help"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Where can I get interactive help for jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>There is an IRC channel, <code class="filename">#jedit</code>,
216                    available on the irc.freenode.net server that is dedicated
217                    to jEdit support and discussion among developers. You can
218                    reach it using any IRC client (including Chatzilla), as well
219                    as the IRC plugin for jEdit.</p><p>There is almost always someone from the developer team
220                    signed on the channel. Just say hello and describe your
221                    problem.</p></td></tr><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 class="title"><a name="bugs"></a>3. Reporting bugs</h4></td></tr><tr class="toc"><td align="left" valign="top" colspan="2"><dl><dt>Q: <a href="general.html#id2496554">How do I report a bug I have found in jEdit?</a></dt><dt>Q: <a href="general.html#id2496604">What information should I include in a bug
222                    report?</a></dt><dt>Q: <a href="general.html#id2496688">How do I track the status of a jEdit bug
223                    report?</a></dt></dl></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496554"></a><a name="report-bugs"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I report a bug I have found in jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>To be as helpful as possible to the jEdit developer
224                    team and other users, you should use the <a class="ulink" href="http://sourceforge.net/tracker/index.php?group_id=588&amp;atid=100588" target="_top">
225                    bug tracker database</a> that the jEdit project
226                    maintains on the <a class="ulink" href="http://sourceforge.net/" target="_top">SourceForge web site</a>.
227                    You need to be a SourceForge member to post a bug
228                    report.</p><p>Before posting a bug report, spend a few moments
229                    searching the bug database to see if a similar report has
230                    already been made. The bug tracker has a search facility
231                    that will let search for bug reports using a variety of
232                    criteria. If you find a similar bug report, and you have
233                    additional information to contribute, post a comment to the
234                    report. If you do not find a similar bug report, submit a
235                    new report.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496604"></a><a name="bug-report"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>What information should I include in a bug
236                    report?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>The form in the bug tracker report provides several
237                    fields for submitting information. If you are unsure about a
238                    particular item, leave it at the default setting provided in
239                    the form.</p><p>The more important fields are &#8220;<span class="quote">Category</span>&#8221;,
240                    &#8220;<span class="quote">Summary</span>&#8221; and the &#8220;<span class="quote">Initial
241                    comment</span>&#8221;. When you write your initial comment
242                    describing the bug, you should specify the versions of
243                    jEdit, the Java platform and operating system you are using,
244                    because bugs often arise that are specific to particular
245                    versions. Sometimes the bug arises from the Java runtime
246                    environment or even the operating system, and knowing these
247                    details helps the developer team design testing and other
248                    debugging strategies.</p><p>One of the macros installed with jEdit is called
249                    <span class="guimenuitem"><strong>Make Bug Report</strong></span>. You will it find
250                    under the <span class="guimenuitem"><strong>Misc</strong></span> category of the
251                    <span class="guimenu"><strong>Macros </strong></span> menu. This macro extracts
252                    information regarding your jEdit installation and a stack
253                    trace from the last error recorded by jEdit's Activity Log
254                    and places it in a new text buffer. In many cases, the
255                    information furnished by the macro is all that is necessary
256                    to provide a helpful description of a bug. You can simply
257                    cut and paste the output of the macro into the
258                    &#8220;<span class="quote">Initial comment</span>&#8221; field of the bug report
259                    form.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496688"></a><a name="bug-track"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I track the status of a jEdit bug
260                    report?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>If you know the bug report number, go to this web
261                    address:
262                    <strong class="userinput"><code>http://sourceforge.net/tracker/index.php?func=detail&amp;aid=######&amp;group_id=588&amp;atid=100588</code></strong>,
263                    where <strong class="userinput"><code>######</code></strong> is the bug report
264                    number. If you don't know the bug report number, you can
265                    browse and search the <a class="ulink" href="http://sourceforge.net/tracker/index.php?group_id=588&amp;atid=100588" target="_top">
266                    bug database</a> to find the problem in which you are
267                    interested.</p></td></tr><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 class="title"><a name="contact"></a>4. Contacting jEdit developers</h4></td></tr><tr class="toc"><td align="left" valign="top" colspan="2"><dl><dt>Q: <a href="general.html#id2496744">How do I contact members of the jEdit developer
268                    team?</a></dt></dl></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496744"></a><a name="contact-team"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I contact members of the jEdit developer
269                    team?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>If you want to ask a question, make a feature request
270                    or offer other general comments, the easiest way is to join
271                    and post a message to the <a class="ulink" href="mailto:jedit-users@lists.sourceforge.net" target="_top"> jedit-users
272                    mailing list</a>. All developers are members. If you are
273                    interested in working on jEdit or writing a plugin for it,
274                    use the <a class="ulink" href="mailto:jedit-users@lists.sourceforge.net" target="_top"> jedit-devel
275                    list</a>. Email addresses for individual developers can
276                    be found on the <a class="ulink" href="http://sourceforge.net/project/memberlist.php?group_id=588" target="_top">
277                    SourceForge web site</a>.</p></td></tr><tr class="qandadiv"><td align="left" valign="top" colspan="2"><h4 class="title"><a name="latest-version"></a>5. Getting the latest version</h4></td></tr><tr class="toc"><td align="left" valign="top" colspan="2"><dl><dt>Q: <a href="general.html#id2496803">How do I obtain the latest version of jEdit?</a></dt><dt>Q: <a href="general.html#id2547149">How do I obtain a copy of the jEdit source
278                    code?</a></dt><dt>Q: <a href="general.html#id2547203">Where can I get the latest version of this
279                    document?</a></dt><dt>Q: <a href="general.html#id2547230">How do you set the classpath and compile the Java
280                    files in jEdit?</a></dt></dl></td></tr><tr class="question"><td align="left" valign="top"><a name="id2496803"></a><a name="get-latest-version"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I obtain the latest version of jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>The program is in a continuing state of evolution. It
281                    is usually available in two versions, a
282                    &#8220;<span class="quote">stable</span>&#8221; version and a
283                    &#8220;<span class="quote">development</span>&#8221; version. A stable version
284                    represents a release of jEdit that is considered to be free
285                    of serious bugs or performance problems and suitable for
286                    general use. A &#8220;<span class="quote">development</span>&#8221; version includes
287                    new features or new elements of program design that require
288                    testing and possible further refinement. A development
289                    version contains the token &#8220;<span class="quote">pre</span>&#8221; in its version
290                    number, as in <code class="literal">4.3pre5</code>.</p><p>The latest stable and development versions of jEdit
291                    are always available from the <a class="ulink" href="http://www.jedit.org" target="_top">jEdit web site</a> and from
292                    the <a class="ulink" href="http://sourceforge.net/%20%20%20%20%20%20%20%20%20projects/jedit" target="_top">jEdit
293                    project page</a> of the <a class="ulink" href="http://sourceforge.net" target="_top">SourceForge web site</a>,
294                    which hosts jEdit's development resources.</p><p>In addition, a plugin named <span class="application">Check jEdit
295                    Version</span> can be run from within jEdit by
296                    selecting <span class="guimenuitem"><strong>Check jEdit Version</strong></span>
297                    from the application's <span class="guimenu"><strong>Plugins</strong></span> menu. It
298                    queries the jEdit web site, compares version information
299                    with the version of the currently running instance of jEdit,
300                    and reports the result to the user in a message box. It will
301                    tell you if you do not have the latest version of jEdit,
302                    regardless of whether that version is in
303                    &#8220;<span class="quote">stable</span>&#8221; or &#8220;<span class="quote">development</span>&#8221;
304                    form.</p><p>Finally, if you subscribe to the <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-announce" target="_top">
305                    jedit-announce</a> or <a class="ulink" href="http://lists.sourceforge.net/lists/listinfo/jedit-users" target="_top">
306                    jedit-users</a> mailing lists, you will receive an email
307                    whenever a new release of jEdit becomes available.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2547149"></a><a name="get-source"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I obtain a copy of the jEdit source
308                    code?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>The latest version of jEdit's source code is available
309                    from the <a class="ulink" href="http://www.jedit.org/index.php?page=download&amp;platform=source" target="_top">
310                    jEdit web site</a> or the <a class="ulink" href="http://sourceforge.net/project/showfiles.php?group_id=588" target="_top">
311                    SourceForge web site</a>. The web site provides the
312                    source code for the latest stable and development version,
313                    while the SourceForge site has a more extensive archive
314                    covering earlier versions.</p><p>If you are interested in testing the absolutely latest
315                    changes to jEdit, and you are familiar with compiling your
316                    own Java programs and working with Subversion, you can
317                    download the current code maintained in the <a class="ulink" href="http://jedit.svn.sourceforge.net/viewvc/jedit/" target="_top">SourceForge
318                    SVN repository</a>.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2547203"></a><a name="get-latest-faq"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Where can I get the latest version of this
319                    document?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>The latest release of this document is available on
320                    the <a class="ulink" href="http://www.jedit.org/FAQ/index.html" target="_top">jEdit
321                    web site</a>.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2547230"></a><a name="jedit-compile"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do you set the classpath and compile the Java
322                    files in jEdit?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Consult an article on the <a class="ulink" href="http://community.jedit.org" target="_top">jEdit Community</a> web
323                    site entitled &#8220;<span class="quote">Build jEdit yourself: the 'Open' in
324                    Open Source</span>&#8221;.</p></td></tr></tbody></table></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="intro.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="installation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Introduction </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Installation Questions</td></tr></table></div></body></html>