------------------------------------------------------------
ECO 1.1 - EPM extension for Java/C/IPF editing and compiling
------------------------------------------------------------
                                                 Version 1.1
                                                  1999-01-13 
                                              Walter Schmidt 
                               <walter.schmidt@arcormail.de>
        

Read this carefully, even if you're already using a previous
version!

                                            
What is ECO ?
-------------
Using eco.ex you can run a compiler from an EPM menu, view
the transcript of the compilation process within the editor,
and link compiler error messages to the corresponding lines
in the source file.  The latter facility requires the EPM to
`understand' the format of the messages; currently the Java
compiler (javac), Gnu C and ipfc are supported.

ECO v1.1 provides a menu item for controlling the syntax
highlighting of Java, C, HTML and IPF files.  

ECO requires EPM version 6.03b which comes with Warp 4 (not
with Warp 3) or can be downloaded (free) from various sites.

ECO has been tested with gcc 2.8.1, with the Java compiler
`javac' from JDK 1.1.6 and with ipfc 4.00.  It should work
with GNU C++, too, and also with other compilers generating
error messages of the same format.



Installing ECO
--------------
1) Copy the file eco.ex to the directory where your EPM 
resides, usually \OS2\APPS on the boot drive.

2a) Open the settings notebook of the program object `Editor
for Java' (residing in the folder `Java x.x.x for OS/2'),
then enter the following line (including the quotes) into
the `parameter' entry field:

        /m 'link eco'

(/m may already be present.)  The eco module will then be
linked when the EPM is run via this program object only.

or

2b) Add the following line (including the quotes) to your
EPM Rexx profile, i.e.  the file 'PROFILE.ERX':

        'link eco'

Make sure that 'REXX profile' is enabled in the EPM
settings!  In this case the eco module will _always_ be
linked when the EPM starts up.

3) (Re)start the editor.  There should be an additional
submenu named `Compile' then.



Using ECO
---------
1) Edit your program source.

2) Select the menu item `Compile/Compile'.

3) The command which is displayed here will be executed in
the directory of the current file, when you click on `Run'.
The default is to run the current file through the Java
compiler `javac'; edit this according to your needs.  Any
occurrence of %**F will expand to the current filename
including the extension; %**N will expand to the filename
without extension.  Instead of invoking a compiler you may
also run the `make' utility (or execute any other program).
The command is memorized, so you need not enter it again
when repeating compilation; it will be saved when you leave
the editor.

4) Click on `Run'; the EPM will switch to a `shell window',
where the command is executed.  The current file is saved
automagically before this step is performed, as well as all
other files recognized as Java, C, or IPF.  The following
file types are honored:  JAV JAVA C H SQC CPP HPP CXX HXX
SQX IPF.  (Please, note that the current file is _always_
saved, regardless of its type.)

5) Select the menu item `Compile/Locate next error'.  The
EPM will search for the first error message, switch to the
corresponding line of the source code and show the error
message in its message line.  ECO understands the format of
the error messages generated by javac and gcc as well as the
format of the IPF compiler ipfc 4.00.  In case the exact
column of the error is indicated in the transcript, that
column will be marked by a red circle.

6) Select `Locate next error' again (without returning to
the transcript):  The cursor will jump to the location of
the next error in the source code.  When this menu item is
selected with the cursor being in the midst of the
transcript, then the search for the `next' error starts in
the current line of this file.

7) Select the menu item `Compile/View transcript' while
editing the source code or any other file:  The EPM will
switch to the shell window and move the cursor (if possible)
to the latest error found before.



Syntax Highlighting
-------------------
Select the menu item `Compile/Highlighting' to toggle syntax
highlighting of Java, C, HTML and IPF files.  This affects
the current file only.  The setting is not saved when you
quit the editor!

Syntax highlighting is controlled by the keyword files
EPMKWDS.*, which are part of the OS/2 EPM package.  The
colors defined in these files suit the default color scheme
of the editor.



History
-------
1999-01-13: v1.1
  * sensible error message when `Highlighting' is requested
    for a file type other than Java, HTML, C or IPF
  
1998-10-17:  v1.0
  * Support for ipfc and syntax highlighting added.
  * The column of an error is marked by a red circle.
  * Better documentation.
  
1998-04-14:  v0.9
  * The first public version.



Support
-------
In case you encounter any problems with ECO or if you have
any suggestions for improving it, then write an e-mail
message to:

Walter Schmidt  <walter.schmidt@arcormail.de>

Please, obtain my address from the latest version of this
document!

The latest version of this software should usually be found 
at the `Hobbes' site.



Finally ...
-----------
...  I would like to apologize for any mistakes in this
document.  English is not my native language.  Suggestions
for improving this document and the messages displayed by
the program are welcome.

-- finis

