File: faq-install.xml

package info (click to toggle)
jedit 5.1.0%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 13,632 kB
  • ctags: 10,965
  • sloc: java: 96,611; xml: 92,194; makefile: 55; sh: 30; cpp: 6; python: 6
file content (260 lines) | stat: -rw-r--r-- 12,263 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
<?xml version="1.0" encoding="UTF-8"?>
<section id="installation">
    <title>Installation Questions</title>
    <!-- jEdit buffer-local properties:                      -->
    <!-- :indentSize=4:noTabs=false:maxLineLen=80:tabSize=4: -->
    <!-- :xml.root=faq.xml:                                  -->
    <!-- jEdit FAQ                                           -->

    <para>This section deals with installing jEdit using the Java-based
    installation program, as well as installation issues that are specific to
    particular operating systems.</para>

    <qandaset defaultlabel="qanda">
        <qandadiv id="install-general">
            <title>General installation questions</title>

            <qandaentry>
                <question id="easy-howto-install">
                    <para>What is the easiest way to install jEdit?</para>
                </question>

                <answer>
                    <para>First, make sure you have a working installation of
                    the Java platform. To run jEdit, you will a platform package
                    having a version number of at least 1.6. If you do not
                    have the Java platform, we recommend downloading the larger
                    <quote>Software Development Kit</quote> (SDK), instead of
                    the smaller <quote>Java Runtime Environment</quote> (JRE),
                    because you will need the tools supplied with the SDK if you
                    will be using Java for development. You will need to know
                    the path of the Java application launcher, which is called
                    <filename>java.exe</filename> on Windows systems and simply
                    <filename>java</filename> on others.</para>

                    <para>Next, decide whether you want the current "stable"
                    version or the latest development version. As a general
                    rule, the stable version is a good choice for first-time
                    users. Download the Java installer for the version
                    you have chosen from the jEdit web site; it consists of a
                    single file with a name in the style
                    <filename>jeditXXXinstall.jar</filename>. This file is a
                    compressed archive containing all of the files you need for
                    jEdit to run as well as an installer application written in
                    Java. You can put this file anywhere on your hard disk that
                    is convenient.</para>

                    <para>To run the installer, do whatever you normally do to
                    run a Java jar archive. If this is your first time, follow
                    these steps:</para>

                    <procedure>
                        <step>
                            <para>Open a terminal or command interpreter
                            window.</para>
                        </step>

                        <step>
                            <para>Change the current directory to the directory
                            in which you have stored the jEdit installer
                            file.</para>
                        </step>

                        <step>
                            <para>Run this command: <userinput>[full path to java
                            application launcher] -jar
                            jeditXXXinstall.jar</userinput></para>
                        </step>
                    </procedure>

                    <para>The installer will load and display a series of
                    dialogs for selecting a few simple options, including the
                    directory in which you wish jEdit installed. It will also
                    tell you how much disk space you need for the main program
                    and various installation options.</para>

                    <para>If this is your first download of jEdit, you should
                    definitely install the set of macros that come with the
                    application. Many of them are useful for all programmers,
                    and even the ones you don't use can serve as models when you
                    eventually begin writing your own macros.</para>

                    <para>The installation process is very short. If you are
                    installing the program on Windows and you select the
                    jEditLauncher option, you should be able to start jEdit by
                    clicking on any of the icons that the installation program
                    provides. On other systems, you can enter
                    <userinput>jedit</userinput> in a terminal window or create
                    your own desktop or menu shortcut.</para>
                </answer>
            </qandaentry>

            <qandaentry>
                <question id="java-web-start">
                    <para>Why is there no Java Web Start version of
                    jEdit?</para>
                </question>

                <answer>
                    <para>In Java Web Start, dynamically-loaded classes (ie,
                    plugins) run in a sandbox unless they are explicitly signed.
                    Also, the protocol handler API prevents protocol handlers
                    from being added if they are not loaded via the system class
                    loader (i.e via the Java Web Start class loader). So the
                    lack of plugin support and jeditresource protocol makes it
                    useless.</para>
                </answer>
            </qandaentry>

            <qandaentry>
                <question id="install-upgrade">
                    <para>How do I upgrade from one release of jEdit to
                    another?</para>
                </question>

                <answer>
                    <para>Simply delete the existing jEdit directory and run the
                    installer (if any) to install the new version. Settings are
                    kept in <filename>~/.jedit</filename>, and will not be
                    affected.</para>
                </answer>
            </qandaentry>
        </qandadiv>

        <qandadiv id="install-mac">
            <title>Installing jEdit on MacOS</title>

            <qandaentry>
                <question id="install.mac9-basic">
                    <para>How do I install jEdit on MacOS 8 or MacOS 9? s</para>
                </question>

                <answer>
                    <para>The latest version of jEdit requires
                    MacOS X (preferably 10.5 or later), because the Java
                    platforms of earlier MacOS version are outdated.</para>

                    <para>Once you have completed installing jEdit locate the
                    jedit.jar file and do the following:</para>

                    <procedure>
                        <step>
                            <para>Drag the <filename>jedit.jar</filename> to
                            JBinary and JBinary will launch.</para>
                        </step>

                        <step>
                            <para>In the Command window in the Class path box
                            replace <userinput>jedit</userinput> with
                            <userinput>org.gjt.sp.jedit.jEdit</userinput>.</para>
                        </step>

                        <step>
                            <para>Then click the Save settings button. It will
                            ask for an application name and will create a
                            double-clickable icon on your desktop.</para>
                        </step>

                        <step>
                            <para>Double-click on your icon to launch
                            jEdit.</para>
                        </step>
                    </procedure>
                </answer>
            </qandaentry>

            <qandaentry>
                <question>
                    <para>How do I uninstall jEdit for Mac OS?</para>
                </question>

                <answer>
                    <para>There are no system files, so simply drop the jEdit
                    folder in the trash. If you want to remove the settings
                    directory used by jEdit you will find it at
                    <filename>~/.jedit</filename>. It is hidden, so you will
                    need to remove it from the command line, or use one of the
                    various uilities available that will let you see it.</para>
                </answer>
            </qandaentry>
        </qandadiv>

        <qandadiv id="install-windows">
            <title>Installing jEdit on Windows</title>

            <qandaentry>
                <question id="install-windows-basic">
                    <para>Is there anything different about installing jEdit on
                    Windows?</para>
                </question>

                <answer>
                    <para>For the Microsoft Windows family of operating systems,
                    jEdit provides an additional package of features called
                    jEditLauncher. These features include: <itemizedlist>
                            <listitem>
                                <para>Built-in shortcut icons for launching
                                jEdit;</para>
                            </listitem>

                            <listitem>
                                <para>Support for opening files in jEdit using custom
                                entries in the context (right-click) menu of the
                                Windows shell;</para>
                            </listitem>

                            <listitem>
                                <para>Support for running BeanShell scripts in jEdit
                                from outside the application;</para>
                            </listitem>

                            <listitem>
                                <para>Support for launching jEdit and loading files
                                using scripting languages such as VBScript, Perl and
                                Python;</para>
                            </listitem>

                            <listitem>
                                <para>Automatic uninstallation of jEdit using the
                                <quote>Add/Remove Programs</quote> applet in Control
                                Panel.</para>
                            </listitem>
                        </itemizedlist> The package is a recommended option that
                    is selected by default when you install jEdit. The Java
                    installer application launches a separate Windows installer
                    module for the native Windows executables that comprise the
                    jEditLauncher package. If the installation involves an
                    upgrade, you may be asked to reboot your computer to
                    complete the process.</para>
                </answer>
            </qandaentry>

            <qandaentry>
                <question id="install-windows-components">
                    <para>Do I need any special Windows components to run
                    jEditLauncher?</para>
                </question>

                <answer>
                    <para>Regardless of the version of Windows that you use, if
                    you have kept it reasonably up-to-date with service packs or
                    component upgrades from Microsoft, you should have no
                    trouble running jEditLauncher. </para>

                </answer>
            </qandaentry>

            <qandaentry>
                <question id="install-windows-vm">
                    <para>Can I run jEdit on Microsoft's virtual machine?</para>
                </question>

                <answer>
                    <para>The latest version of jEdit requires at
                    least version 1.6 of the Java 2 platform, and therefore may
                    not be compatible with 3rd party virtual machines.</para>
                </answer>
            </qandaentry>
        </qandadiv>
    </qandaset>
</section>