Hardy Report Generation
-----------------------

About this program
------------------

Reports2 is a second version of a Hardy program to output Latex, Word
RTF and WinHelp RTF.

Installation
------------

To install the software on Windows 95 (the only supported platform) you
need a recent version of Hardy for Windows 95 (1.84 or above), plus
a Windows 95 version of Tex2RTF (see http://www.aiai.ed.ac.uk/~jacs/tex2rtf.html).

1) If you have installed Hardy 1.87 or above plus the Hardy SDK, you already have
Reports2, in the subdirectory hardysdk/clips/reports2. Go to step (3).

2) If you have a zip file, e.g. reports2.zip, unarchive into a suitable
directory. This will involve something like this in DOS:

 c:\> mkdir reports2
 c:\> cd reports2
 c:\reports2> pkunzip -d reports2.zip

(the -d tells pkunzip to create subdirectories).

Alternatively, you can use a Windows unarchiver such as WinZip to unzip
into an appropriate directory.

You now have a directory containing:

 - CLIPS and sample files.
 
3) You now need to create a shortcut (Program Manager icon in Windows
3.1 parlance) which will invoke Hardy, load the CLIPS code, and
optionally load the required index file.

Here's an example command line that you might put in your shortcut (the
line breaks are for convenience of illustration only). It loads the
demo index file.

  c:\hardy\hardy.exe
    -def c:\reports2\diagrams.def
    -f c:\reports2\demo.ind
    -dir c:\reports2
    -clips c:\reports2\loader.clp
    
This length of command line is required because in general, the Hardy
executable, the Hardy source code and the diagrams to be converted
may all be in different directories, and you have to be explicit about
where they all are. So for example, if your index file is in a
different place from Reports2, you might have another shortcut:

  c:\hardy\hardy.exe
    -def c:\projects\idef\diagrams.def
    -f c:\projects\idef\demo.ind
    -dir c:\reports2
    -clips c:\reports2\loader.clp

You can create as many shortcuts as you need, for different purposes.
If you don't want to open an index file immediately, omit the -f
switch.

5) Once you have Reports2 installed, start Hardy, load an index (such
as demo.ind), and pull down the Translation menu on the top-level Hardy
window.

You should see choices for Translate to Word RTF and Translate to
WinHelp RTF. If you don't have these items or the Translation menu
itself, you need to edit your diagrams.def to reflect the custom menu in
the demo diagrams.def.

Start up MS Word and Tex2RTF. If you don't do this, one or more steps
of the translation will not take place.

Select Translate to Word RTF, and choose an output .tex file. Then a
dialog will appear asking for the object identifier attribute ("name" for the
demo, perhaps Id or id for other applications).

After translation to .tex format, Tex2RTF should be invoked to
translate to RTF. The file will then be loaded into MS Word. To format
all fields, press CTRL-A F9.




