PageRenderTime 86ms CodeModel.GetById 79ms app.highlight 4ms RepoModel.GetById 0ms app.codeStats 1ms

/jEdit/tags/jedit-4-2-pre14/doc/FAQ/faq-install.xml

#
XML | 267 lines | 247 code | 15 blank | 5 comment | 0 complexity | 8ad0e3c732f3afa6a9a29a3ecfae214e MD5 | raw file
  1<!-- jEdit buffer-local properties:                      -->
  2<!-- :indentSize=4:noTabs=false:maxLineLen=72:tabSize=4: -->
  3<!-- :xml.root=faq.xml:                                  -->
  4
  5<!-- jEdit FAQ                                           -->
  6<!-- Copyright (C) 2003 John Gellene, Kris Kopicki       -->
  7
  8<sect1 id="installation"><title>Installation Questions</title>
  9<para>
 10  This section deals with installing jEdit using the Java-based
 11  installation program, as well as installation issues that are specific
 12  to particular operating systems.
 13</para>
 14
 15<qandaset defaultlabel="qanda">
 16
 17  <qandadiv id="install-general">
 18    <title>General installation questions</title>
 19    <qandaentry>
 20      <question id="easy-howto-install"><para>
 21        What is the easiest way to install jEdit?
 22      </para></question>
 23      <answer><para>
 24        First, make sure you have a working installation of the Java platform.
 25        To run jEdit, you will a platform package having a version number of at least 1.3.
 26        Versions 1.3, 1.3.1 or 1.4 will all work. If you do not have the Java platform,
 27        we recommend downloading the larger <quote>Software Development Kit</quote> (SDK), instead of
 28        the smaller <quote>Java Runtime Environment</quote> (JRE), because you will need
 29        the tools supplied with the SDK if you will be using Java for development.
 30        You will need to know the path of the Java application launcher, which is
 31        called <filename>java.exe</filename> on Windows systems and simply
 32        <filename>java</filename> on others.
 33      </para>
 34      <para>
 35        Next, decide whether you want the current stable version or the latest
 36        development version. The stable version is a good choice for first-time
 37        users. Download the Java installer for the version you have chosen from
 38        the jEdit web site; it consists of a single file with a name in the
 39        style <filename>jeditXXXinstall.jar</filename>.
 40        This file is a compressed archive containing all of the files you need
 41        for jEdit to run as well as an installer application written in Java.
 42        You can put this file anywhere on your hard disk that is convenient.
 43      </para>
 44      <para>
 45        To run the installer, do whatever you normally do to run a Java jar
 46        archive. If this is your first time, follow these steps:
 47      </para>
 48      <procedure>
 49        <step><para>Open a terminal or command interpreter window.</para></step>
 50        <step><para>Change the current directory to the directory in which you
 51        have stored the jEdit installer file.</para></step>
 52        <step><para>Run this command:
 53          <userinput>[full path to java application launcher] -jar
 54          jeditXXXinstall.jar</userinput></para>
 55        </step>
 56      </procedure>
 57      <para>
 58        The installer will load and display a series of dialogs for selecting a
 59        few simple options, including the directory in which you wish jEdit
 60        installed. It will also tell you how much disk space you need for
 61        the main program and various installation options.
 62      </para>
 63      <para>
 64        If this is your first download of jEdit, you should definitely install
 65        the set of macros that come with the application. Many of them are
 66        useful for all programmers, and even the ones you don't use can
 67        serve as models when you eventually begin writing your own macros.
 68      </para>
 69      <para>
 70        The installation process is very short. If you are installing the
 71        program on Windows and you select the jEditLauncher option, you should
 72        be able to start jEdit by clicking on any of the icons that the
 73        installation program provides. On other systems, you can enter
 74        <userinput>jedit</userinput> in a terminal window or create your own
 75        desktop or menu shortcut.
 76      </para></answer>
 77    </qandaentry>
 78
 79<qandaentry>
 80	<question id="java-web-start">
 81		<para>
 82			Why is there no Java Web Start version of jEdit?
 83		</para>
 84	</question>
 85	<answer>
 86		<para>
 87			In Java Web Start, dynamically-loaded classes (ie, plugins) run in a sandbox
 88			unless they are explicitly signed. Also, the protocol handler API prevents
 89			protocol handlers from being added if they are not loaded via the system
 90			class loader (i.e via the Java Web Start class loader). So the lack of plugin
 91			support and jeditresource protocol makes it useless.
 92		</para>
 93	</answer>
 94</qandaentry>
 95
 96<qandaentry>
 97	<question id="install-upgrade">
 98		<para>
 99			How do I upgrade from one release of jEdit to another?
100		</para>
101	</question>
102	<answer>
103		<para>
104			Simply delete the existing jEdit directory and run the installer (if any) to
105			install the new version. Settings are kept in <filename>~/.jedit</filename>, and
106			will not be affected.
107		</para>
108	</answer>
109</qandaentry>
110
111</qandadiv>
112
113<qandadiv id="install-mac">
114  <title>Installing jEdit on MacOS</title>
115  <qandaentry>
116    <question id="install.mac9-basic">
117      <para>
118		How do I install jEdit on MacOS 8 or MacOS 9?
119	  s</para>
120    </question>
121    <answer>
122      <para>
123        The latest version of jEdit, version 4.1, requires MacOS X, because the
124        Java platforms of earlier MacOS version out outdated.
125      </para>
126      <para>
127        The following steps outline how to install jEdit 3.2.2 on Mac OS 9.1
128        and earlier.
129      </para>
130      <procedure>
131        <step><para>Download and install JBinary which
132        is part of the MRJ SDK 2.2 package available from Apple.</para></step>
133        <step><para>Once jBinary is installed, drag the jEdit installer to
134        JBinary and JBinary will launch.</para></step>
135        <step><para>In the Command window in the Class path box replace
136        <userinput>jedit322install,</userinput> with
137        <userinput>installer.Install</userinput>.</para></step>
138        <step><para>Then click the Run button. The installer will
139        install jEdit on your system.</para></step>
140      </procedure>
141      <para>
142        Once you have completed installing jEdit locate the jedit.jar
143        file and do the following:
144      </para>
145      <procedure>
146        <step><para>Drag the <filename>jedit.jar</filename> to JBinary
147        and JBinary will launch.</para></step>
148        <step><para>In the Command window in the Class path box replace
149        <userinput>jedit</userinput> with
150        <userinput>org.gjt.sp.jedit.jEdit</userinput>.</para></step>
151        <step><para>Then click the Save settings button. It will ask
152        for an application name and will create a double-clickable icon
153        on your desktop.</para></step>
154        <step><para>Double-click on your icon to launch jEdit.</para></step>
155       </procedure>
156     </answer>
157   </qandaentry>
158	<qandaentry>
159		<question>
160			<para>
161				How do I uninstall jEdit for Mac OS?
162			</para>
163		</question>
164		<answer>
165			<para>
166				There are no system files, so simply drop the jEdit folder
167				in the trash. If you want to remove the settings directory used by jEdit
168				you will find it at <filename>~/.jedit</filename>. It is hidden, so you
169				will need to remove it from the command line, or use one of the various
170				uilities available that will let you see it.
171			</para>
172		</answer>
173	</qandaentry>
174</qandadiv>
175
176
177  <qandadiv id="install-windows">
178    <title>Installing jEdit on Windows</title>
179    <qandaentry>
180      <question id="install-windows-basic"><para>
181        Is there anything different about installing jEdit on Windows?
182      </para></question>
183      <answer><para>
184        For the Microsoft Windows family of operating systems, jEdit
185        provides an additional package of features called jEditLauncher.
186        These features include:
187        <itemizedlist>
188            <listitem><para>
189              Built-in shortcut icons for launching jEdit;
190            </para></listitem>
191            <listitem><para>
192              Support for opening files in jEdit using custom entries in
193              the context (right-click) menu of the Windows shell;
194            </para></listitem>
195            <listitem><para>
196              Support for running BeanShell scripts in jEdit from
197              outside the application;
198            </para></listitem>
199            <listitem><para>
200              Support for launching jEdit and loading files using
201              scripting languages such as VBScript, Perl and Python;
202            </para></listitem>
203            <listitem><para>
204              Automatic uninstallation of jEdit using the
205              <quote>Add/Remove Programs</quote> applet in Control Panel.
206            </para></listitem>
207        </itemizedlist>
208        The package is a recommended option that is selected by default when you
209        install jEdit. The Java installer application launches a separate
210        Windows installer module for the native Windows executables that
211        comprise the jEditLauncher package. If the installation involves an
212        upgrade, you may be asked to reboot your computer to complete the process.
213      </para></answer>
214    </qandaentry>
215
216    <qandaentry>
217      <question id="install-windows-components"><para>
218        Do I need any special Windows components to run jEditLauncher?
219      </para></question>
220      <answer><para>
221        Regardless of the version of Windows that you use, if you have kept it
222        reasonably up-to-date with service packs or component upgrades from
223        Microsoft, you should have no trouble running jEditLauncher.
224        Users of Windows 98, Windows ME, Windows NT (version 4.0),
225        Windows 2000 and Windows XP have not reported problems involving missing
226        components.
227      </para>
228      <para>
229        Some users of older versions of Windows 95 may need to upgrade their
230        version of the Windows Sockets package. Others may be missing
231        Microsoft's package for supporting DCOM (Distributed Component
232        Object Model) components on Windows 95. Both the <ulink url=
233        "http://www.microsoft.com/windows95/downloads/contents/wuadmintools/s_wunetworkingtools/w95sockets2/">
234        Windows Sockets upgrade</ulink> and the <ulink
235        url="http://www.microsoft.com/com/dcom/dcom95/dcom1_3.asp">
236        DCOM package</ulink> are available for download from Microsoft.
237      </para></answer>
238    </qandaentry>
239
240    <qandaentry>
241        <question id="install-windows-vm"><para>
242            Can I run jEdit on Microsoft's virtual machine?
243        </para></question>
244        <answer>
245           <para>
246                The latest version of jEdit, version 4.1, requires at least
247                version 1.3 of the Java 2 platform, and therefore will not
248                be compatible with Microsoft's virtual machine.
249           </para>
250          <para>
251             You can run jEdit version 3.2.2 if you put Sun's Swing 1.1.1
252             package in the classpath of Microsoft's Java application loaders
253             <command>jview</command> or <command>wjview</command>.
254             An article describing the advantages and disadvantages
255             of doing this, and detailing the necessary procedures, may
256             be found on the <ulink
257             url="http://community.jedit.org/article.php?sid=14&amp;mode=&amp;order=0">jEdit
258             Community</ulink> web site.
259         </para>
260        </answer>
261    </qandaentry>
262
263  </qandadiv>
264
265</qandaset>
266
267</sect1>