PageRenderTime 38ms CodeModel.GetById 12ms RepoModel.GetById 0ms app.codeStats 0ms

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