PageRenderTime 46ms CodeModel.GetById 16ms 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
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. <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>