PageRenderTime 302ms CodeModel.GetById 293ms app.highlight 6ms RepoModel.GetById 1ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/42docs/users-guide/launcher-starting.html

#
HTML | 103 lines | 103 code | 0 blank | 0 comment | 0 complexity | b6fe95b28cadd3b7223fcfeecaf099cf MD5 | raw file
  1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Starting jEdit</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="launcher-guide.html" title="Appendix G. jEditLauncher for Windows"><link rel="previous" href="launcher-intro.html" title="Introduction"><link rel="next" href="launcher-menu.html" title="The Context Menu Handler"></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">Starting jEdit</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="launcher-intro.html">Prev</a> </td><th width="60%" align="center">Appendix G. jEditLauncher for Windows</th><td width="20%" align="right"> <a accesskey="n" href="launcher-menu.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="launcher-starting"></a>Starting jEdit</h2></div></div><div></div></div><p>
  2      The main component of the jEditLauncher package is a client
  3      application
  4      entitled <span><b class="command">jedit.exe</b></span>. It may be executed either
  5      from either Windows Explorer, a shortcut icon or the command line.
  6      It uses the jEditLauncher
  7      COM component to open files in jEdit that are listed as command line
  8      parameters. It supports Windows and UNC file
  9      specifications as well as wild cards. If called without parameters, it
 10      will launch jEdit. If jEdit is already running, it will simply open a new, empty buffer.
 11    </p><p>
 12      <span><b class="command">jedit.exe</b></span> supports five command-line
 13      options.
 14      Except for the <b class="userinput"><tt>/1</tt></b> option, if any of these options
 15      are invoked correctly, the application will not load files or
 16      execute jEdit.
 17    </p><div class="itemizedlist"><ul type="disc"><li><p>
 18          The option <b class="userinput"><tt>/h</tt></b> causes a window to be displayed
 19          with a brief description of the application and its various options.
 20        </p></li><li><p>
 21          The option <b class="userinput"><tt>/p</tt></b> will activate a dialog window
 22          displaying the command-line parameters to be used when calling jEdit.
 23          This option can also be triggered by selecting <span><b class="guilabel">Set
 24          jEdit Parameters</b></span> from the <span><b class="guilabel">jEdit</b></span>
 25          section of the Windows Programs menu, or by running the utility program
 26          <span><b class="command">jedinit.exe</b></span>
 27        </p><p>
 28          Using the dialog, you can change parameters specifying the executable for
 29          the Java application loader (either <tt class="filename">java.exe</tt>
 30          or <tt class="filename">javaw.exe</tt>), the location of the jEdit archive file,
 31          <tt class="filename">jedit.jar</tt>, and command line options for both.
 32          </p><div class="itemizedlist"><ul type="circle"><li><p>
 33                The input fields for Java options and jEdit options are separate.
 34                If you insert an option in the wrong place it will not be
 35                properly executed.
 36              </p></li><li><p>
 37                If the <b class="userinput"><tt>-jar</tt></b> option is not used with the
 38                Java application loader the principal jEdit class of
 39                <tt class="classname">org.gjt.sp.jedit.jEdit</tt> is set as
 40                fixed data.
 41              </p></li><li><p>
 42                The working directory for the Java interpreter's process
 43                can also be specified.
 44              </p></li></ul></div><p>
 45          A read-only window at the bottom of the dialog displays
 46          the full command line that jEditLauncher will invoke.
 47        </p><p>
 48          Before committing changes to the command line parameters,
 49          <span><b class="command">jedit.exe</b></span> validates the paths for the Java
 50          and jEdit targets as well as the working directory. It will complain if
 51          the paths are invalid. It will not validate command line options, but it
 52          will warn you if it finds the <b class="userinput"><tt>-noserver</tt></b> option
 53          used for jEdit, since this will deactivate the edit
 54          server and make it
 55          impossible for jEditLauncher to open files.
 56        </p><p>
 57          Note that due to the design of
 58          <span class="application">jEditLauncher</span>,
 59          platform-independent command line options
 60          handled by jEdit itself (such as
 61          <b class="userinput"><tt>-background</tt></b> and
 62          <b class="userinput"><tt>-norestore</tt></b>) must be entered in the
 63          &#8220;<span class="quote">Set jEdit Parameters</span>&#8221; dialog box, and cannot be
 64          specified on the <span><b class="command">jedit.exe</b></span> command line
 65          directly. For information about platform-independent command
 66          line options, see <a href="cli-usage.html" title="Command Line Usage">the section called &#8220;Command Line Usage&#8221;</a>.
 67        </p></li><li><p>
 68          The option <b class="userinput"><tt>/1</tt></b> is intended for use in
 69          circumstances where a single file name is passed to jEdit for opening,
 70          and quotation marks cannot be used to delimit file names containing
 71          whitespace.  The launcher reads the entire command line following
 72          the <b class="userinput"><tt>/1</tt></b> options as a single file path,
 73          regardless of the presence of whitespace, and passes the resulting
 74          string as a single file name parameter to jEdit.
 75        </p><p>
 76          This option allows jEdit
 77          to be used with version 5 or greater of Internet Explorer as an
 78          alternate text editor or as the target of the <span><b class="guimenuitem">View
 79          Source</b></span> command.  Included with the jEditLauncher
 80          distribution is a file named <tt class="filename">jEdit_IE.reg.txt</tt>
 81          containing an example of a Window registry file that you can use
 82          to register jEdit as a HTML editor with Internet Explorer. Instructions
 83          for the file's use are included in the text.
 84        </p><p>
 85          The use of the <b class="userinput"><tt>/1</tt></b>
 86          option with multiple file names or other parameters will lead to
 87          program errors or unpredictable results.
 88        </p></li><li><p>
 89          The option <b class="userinput"><tt>/i</tt></b> is not mentioned in the help window
 90          for <tt class="filename">jedit.exe</tt>. It is intended primarily to be used
 91          in conjunction with jEdit's Java installer, but it can also be used to
 92          install or reinstall jEditLauncher manually. When accompanied by a second
 93          parameter specifying the directory where your preferred Java interpreter
 94          is located, jEditLauncher will install itself and set a reasonable
 95          initial set of command line parameters for executing jEdit. You can
 96          change these parameters later by running <tt class="filename">jedinit.exe</tt>
 97          or <tt class="filename">jedit.exe</tt>
 98          with the<b class="userinput"><tt>/p</tt></b> option.
 99        </p></li><li><p>
100          The option <b class="userinput"><tt>/u</tt></b> will cause jEditLauncher
101          to be uninstalled by removing its registry entries.
102          This option does not delete any jEditLauncher or jEdit files.
103        </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="launcher-intro.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="launcher-guide.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="launcher-menu.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"> The Context Menu Handler</td></tr></table></div></body></html>