If you are upgrading from a previous release of Hevea, it is safe to
simply get the new files and install them over the old ones.
Create a directory on your disk for the Hevea files. This
directory should not be part of your SWP system directory. In addition,
because Hevea is a port of a Unix program, neither the directory name nor
the path to it should contain spaces, so do not put the files in c:\Program Files. I suggest c:\hevea.
Unzip winport.zip to this directory, preserving
subdirectories. You should see four subdirectories (html, text, info, and test).
Unzip the files in hevea-swp.zip to the same directory, preserving subdirectories. Some files may over-write previous ones: this is
expected. You should verify that both the html and the text
subdirectories contain a file swp.hva. If you're not interested in
the programming to support the \today macro
(see section 17.1) you can delete xdate.c and xxdate.cpp.
Next we set up some batch files.
Open each .bat file and make sure that the line beginning
set heveadir= points to the directory where you installed Hevea.
The pointer should not end with a backslash character. If you
customized previous versions of the batch files, add the customizations to
the new versions.
Move the files to some directory in your path: that way you will be
able to call the translator from any directory on your hard disk. Delete the
batch files from the Hevea directory.
The SWP distribution contains a small test file (heveatest.tex,
plus graphics files heveatest.wmf and heveatest.gif) to
check that the system is working. To run the test:
Start a DOS session, change to the \test
subdirectory of the main Hevea directory.
Issue the command hhtml heveatest. Hevea will run, and, aside
from a notification that the .hvb file was found (see section 10), there should be no warnings or errors. In a few seconds you
will have heveatest.html in your directory. If you'd rather
generate heveatest.htm you can say hhtml heveatest -o
heveatest.htm (the -o switch controls the output name).
The batch files make a copy of your current path before calling Hevea; they
add the Hevea directory to your path, call Hevea, and restore the original
path when done. Under Windows 95/98 (but not under NT4) you may run
out of the space allocated by the operating system to store these path
strings. The symptom is a message “Out of Environment Space”. If this
happens, you will need to increase the size of your environment area: here
are two ways to do this.
Start a windowed DOS session, click the icon at the top-left
of the session window, and select Properties. Under Memory, change the entry under Environment Size from Auto to
(say) 1024. If it is already set to something other than Auto, select the next larger setting. Click Apply. Close the
window. When you next open it, the Environment size will be larger, and your
problems should be gone. Note that this is specific to the icon naming the DOS session. If you start
a DOS session using a different icon, the larger environment size will not
be present. The same applies if you create a shortcut to one of the batch
files: it needs to be specifically tailored. See the next item for a more
general fix.
Use a text editor to open config.sys in your root directory.
Look for a line beginning shell=. If there is an entry on this line
of the form /e:nnnn where nnnn is some number, add
(say) 1024 to nnnn. If there is no /e: entry, add at the end
of the shell line, /e:1024. Save the file. Re-boot. Your
problems should be gone; if not, repeat, increasing the value of the /e: entry. This fix will apply to every DOS session (and batch file) you
start.
