********************************************************************************
* Dick Chase's Java Editor Readme                                              *
* Version: 2.06 - December 22, 1996                                           *
* Copyright: Copyright  1996, Richard L. Chase - All Rights Reserved.         *
* Java(tm) is a trademark of Sun Microsystems.                                 *
* Delphi(tm) is a trademark of Borland International.                          *
* Netscape(tm) is a trademark of Netscape Communications Corporation.          *
* Other trademarks are the trademarks of those owning the trademark, except    *
*   for those rare cases where the trademark is owned by those who don't       *
*   own the trademark, in which case the trademark is owned by someone else    *
*   entirely, unless they happen to be the same, in which case the trademark   *
*   is owned by both of them.                                                  *
********************************************************************************

NOTE: this is a 32 bit application and will work *only* with Windows 95
      and Windows NT 3.51 or later.

General Description:
====================
A simple MDI text editor for editing Java source code.
Compile your java source and load html files from within the editor.

  Editing Files:
  Works just like notepad, except you can have several files open at once.

  Compiling Java:
  Clicking on the 'Compile Java' button compiles the source in the active
  window. A panel in the text window opens to display the compiler results.
  Double-Clicking on an error line highlights the corresponding line in your
  code.

  Running HTML:
  Clicking on the 'Load Web Browser' button loads the contents of the
  open window into your web browser.

  Projects:
  Files can be grouped into projects. An explorer-like project manager
  (Project|Project Manager) provides iconic or list views of project files and
  compiler settings for the project. You can add files with drag and drop, and
  compile Java files or load html files in you browser directly from the
  project manager. New documents are automatically added to the active project
  when saved.

  Jump to errors:
  Double-Clicking on a compiler error highlights the correspondin line in your
  code.

  Run Java:
  you can now run java applications directly from the editor.
  "Run|Run Java" opens a dialog where you can enter a command line to pass to
  the Java interpreter.

  Running the Java appletviewer:
  Set the browser path (File|Configure, External Applications tab) to
  appletviewer.exe instead of to your browser, and make sure "Use DDE" is
  *not* checked. Javaedit will then load an html file in the Java appletviewer.

  Tab Settings:
  Pressing the tab key now insert spaces instead of the ascii tab character.
  The number of settings is configurable (File|Configure Editor). The default
  is 4 spaces.

  Auto Indent:
  If you press return, the cursor is brought to the same position on the next
  line as the first character on the previous line. (This can be turned on or
  off in the configuration dialog).

  Use Win95 Controls:
  The project manager, by default, uses the Win95 list view control. If you are
  running Javaedit on Windows NT 3.51, this will cause problems. Turning off
  "Use Win95 Controls" in the configurtion dialog will allow you to use
  Javaedit on NT 3.51.

Changes from v2.05:
==================
Bug fixes:
----------
  Bug:      Compiler errors would not be reported with JDK versions 1.1 beta
            and later.
  Analysis: Sun changed the way the compiler returns errors in JDK 1.1. With
            1.0.x, compiler errors are sent to standard output. With 1.1, Errors
            are sent to standard error.
  Fix:      The editor now checks the version of java in your JDK directory. if
            it is 1.0x, errors are read from standard output, otherwise
            compiler errors are read from standard error.

  Bug:      Html would not load in appletviewer.
  Analysis: Appletviewer expects a URL passed with the command line, while
            regular browsers expect a file path.
  Fix:      If Appletviewer.exe is entered as your html browser, the URL for
            the selected document is passed when "Load in Browser" is selected.
            Otherwise, the file path is passed.

Changes from v2.04:
==================
Bug fixes:
----------
  Bug:      If no printers are installed, an error message ("No default printer
            selected") is displayed and javaedit does not start.
  Analysis: There's a bug in Borland's print dialog control. In the control's
            initialization it tries to initialize some printer settings. If
            there's no printer, an exception is raised & the application halts.
  Fix:      I created the print dialog control manually in my code (rather than
            letting the form do it) so the exception is trapped and handled).

  Bug:      Saving a project document under a new name results in a "List
            Index Out of Bounds" error.
  Analysis: There were actually many subtle problems with projects and docs,
            most of which no one has noticed. I've revamped the way projects
            are handled internally and tested it quite a bit.
  Fix:      I've modified the way projects are handled.

  Bug:      Title bar does not change when project name is changed and saved.
  Analysis: One of the subtle problems mentioned above.
  Fix:      See above. I also include the project file path in the title bar.
            Note: the title bar will *not* change until the project is saved.

Enhancements:
-------------
Go To Line! By very popular request. Choose Search|Go To Line..., enter the
  line number in the dialog, click OK, and there you are. (I very much
  apologize for not getting this in sooner. The code has actually been there
  all the time).

Option to use tab characters instead of spaces with the Tab key. This is for
  our French friends (I've received dozens of requests for this, all from
  French users). To use tab characters, set Tab spaces to -1.

Known Problems:
---------------
  By default, if Netscape is your browser, the editor uses DDE to load html
  files in the browser. This way, only one instance of Netscape is loaded
  in relation to the editor so that each time you "Load in Browser",
  Netscape simply replaces the document in that window. There appears to be
  a bug in either my code, Delphi's DDE control or Netscape, however:
    if you "Load in Browser" when Netscape is not already started, Netscape
    starts, but the document fails to load. With the next "Load in Browser",
    a new Netscape window is created and the document loads in that window.
    Subsequent "Load in Browser" actions replace the document in that window.

  Work-arounds to this problem are:
  1) Start Netscape before any "Load in Browser" actions.
  2) When loading an html document in Netscape during a JavaEdit session when
     Netscape is not already open, do it twice and then close the first
     Netscape window.
  3) An option in the application settings is "Use DDE with Netscape".
     Uncheck this and "Load in Browser" will load your document by command line
     parameter instead of DDE. Of course, this means that each
     "Load in Browser" action will result in a new Netscape window. I can see
     why this could actually be considered a good thing, so we'll just
     call this a feature rather than a work-around <G>.


Guarantee/Warranty:
===================
There are no guarantees or warranties in life, and there are none for this
application either. BY USING DICK CHASE'S JAVA EDITOR YOU AGREE THAT YOU
ARE DOING SO ENTIRELY AT YOUR OWN RISK.

License:
========
This is being distributed as freeware. This means you don't owe the author
anything for rights to use this application. This doesn't mean you own the
application, though. The author retains all rights to the application, you
just have the right to use it. You also have the right to freely distribute
this application, as long as you do not charge anything for it and this
Readme.txt file is included.

If you do like the application, the author would appreciate it if you let
him know with a simple e-mail message. Heck, he'd even like to know if
you don't like the application. Of course, if you really want to send the
author money (or donate to a charity or send a postcard from an exotic
locale), the author will most likely accept it :)


Installation:
-------------
Copy javaedit.exe to some directory and run it.

To compile Java sources, you need to tell the application where the
Java compiler is on your machine:
  Select File|Configure Editor.
  Select the 'Java Compiler' page.
  Enter the path to the Java compiler (javac.exe).

To load html files into your browser, the application needs to know the
location of your browser. If you have Netscape 2.0 installed, the application
should find it automatically via info in your Win95 registry. If it doesn't,
you can manually enter the path to your browser:
  Select Edit|Settings.
  Select the 'Java Compiler' page.
  Enter the path to the Java compiler (javac.exe).

Future Plans:
-------------
Word's too cumbersome for editing simple text and it's a royal pain to
edit several sources with word pad. Then you have to open a Dos Window to
compile. So this editor solves a current need for me. I hope you find it
useful too.

Unless there's a strong demand, I'm probably not going to develop any new
versions of JavaEdit. Work is getting busy and complete visual IDEs are
due out very shortly.

***I WILL fix any bugs that are reported*** (or at least try <G>). So far I
have only tested this version myself, so I'm sure there may be some things
that won't work on some people's machine's/configurations.

I will also consider recommendations for enhancements, but I make no promises
(note: syntax highlighting has been a common request. I started working on it,
but to do it well will take much more time than is available to me (the code's
easy, but mapping out java syntax for parsing, especially in such an extensible
language, is simply beyond the scope of a spare-time project).

JavaEdit was built with Delphi 2.0. If you want to enhance it, at the risk of
great embarassment, I am willing to provide the source code. There are a few
caveats to this offer, however:
1) I retain all rights to and ownership of any code provided by me.
2) The code comes with no warranties of any kind.
3) Any software created with any or all of the JavaEdit source code provided
   by me may NOT be sold for any renumeration of any kind without my express
   written permission. (Hey, I don't want any money for my application, but
   if you make money with help from my work, I'd like a cut).
4) I'm notified and provided the opportunity to get a free copy of whatever
   software is created with the code.

Contacting Me (Dick Chase):

e-mail: 
 Internet - dchase@tiac.net (Read almost daily)
 CIS - 72420,2703 (Read rarely)

Regular Mail:
  24 Rennie Drive
  Blackstone, MA 01504

**END README**