Read Me file of HTML Generator                        HTML Generator version 1.1.2.95 (32-bit)
==============================
Tankx for purchasing HTML Generator.

This is version 1.1.2.95
This program only works whithin 32-bit Microsoft environments, like Microsoft Windows95,
Microsoft Windows98 and Microsoft Windows NT4+

The purpose that I created this program, was that I have created large collections of (small)
programs over the years via Shareware CD's, BBS' and the Internet. I not only have a lot of
programs, I also do have a lot of graphics.
In the past, I placed all of those onto diskettes, so I became to have over 1000 diskettes.
Now, when some family or friends asks me if I've got some program in particular, I cannot give
them an answer, because I don't know anymore what I have and where to find it.
Because CD-Writers became payeble last months, I planned to copy all those diskettes to a few
CD-Rom's.
But to do so, I was looking for an easy an convinient way to catalogise all those (little)
files, so it will be easy in the future to find an application or some kind graphic file or
some kind of audio file (.MOD, .WAV, .MID).

I allready had looked around the Internet for such kind. I did find some programs, but they
were very complicated to use, or you allways had to have a copy of that program installed on
your system to use it. I didn't want such thing.
What is the most easiest way to catalogise things, something that is very popular these days?
HTML is the answer. Hyper-Text Markup Language, the language that is used at the WWW to display
a lot of information in a convinient and handy way, that is most times pleasant to use while
you're searching for information. And when you're using Microsoft Windows as your operating
system, there allways will be an Internet browser by default available on your system.
So the HTML files, created by this program, will allways been watcheble, without any extra
software. Just double-click the "index.html" file and Windows will do the rest, showing your
generated html-files.

With all my knowledge about computers and the Internet, this became an interesting task for me,
to create a program, which uses most out of a system, that's fast enough (so it had to be 32-bit
and using the "multi-tasking" possibility's of the modern Intel-based cpu's).
For my professional, I give first-line support to customers of the Internet (I work for an ISP),
and the HTML-knowledge - I allready had that because I've experimented a lot in the past with my
two web-sites. Because of my high knowledge and skills with computers, I think a lot more logic
than most people do, so when I started to program in Microsoft Visual C++, it was a bit easier
for me to get 'that' out of the program, that I had in mind...!

I've worked about 2 months, developping this program. I have the program tested on a standard
Pentium system with 32Mb of RAM and on a Pentium-Pro with 64Mb of RAM. All kind of bugs, I found
are allready taken away, so you won't have a program that only works half (because of the pos-
sible bugs that could be in it). But if you do find any bugs, please don't hessitate to anounce
them to me..

Possibilities:
==============
Besides generating HTML files (which is the main task of the program), this program also can
generate plain ASCII files, Directory Listings (allmost the same as when you type "DIR /S" at
the DOS-prompt), CSV files (handy for importing into Microsoft Excel(r) or Borland(r) dBase(r)
or any other database/spreadsheet program) and Description files ("DESCRIPT.ION" which were
common used in the late 80's/early 90's by e.g. 4DOS(r) and Symantec's(r) NDOS(r)).

Important Message, not included in the HELP file:
=================================================
- The program takes full advantage of long filenames (you can't disable this!).
- When generating HTML files there allways will be created an "index.html", even when your
  destination file had some other name. Use this index-file as first file when you start
  browsing. This file contains all nessecary declarations for the 'frames' the program uses in
  its generated html files.
  When you allready have an INDEX.HTML file in the same directory, this file will allways be
  overwritten by the new index.html file, generated by this program.
- When you select INDEX.HTML as your destination file, the program will rename that file (you
  chose) to "index_.html", so it won't be overwritten by te file that will be generated.

Requirements:
=============
You need to have a MS-Windows95 compatible OS (these are : Windows95 Retail/OSR1 with SP1 and
DCOM95 - The "ServicePack1" and "DCOM95" can be found at the site of Microsoft; Windows95 OSR2;
Windows98; WindowsNT4 server/workstation with SP3(or higher)).
Your harddisk (the one where Windows writes its tempory files and its swap-file) need
to have at least 100Mb free space for those tempory's and swap files. When the program isn't
doing anything, it won't use much resources of your system, but when it is working it will. The
larger your source will be (e.g. a complete harddisk with lots of small files) the more
resources the program will take, but they will be freed after the program has done its task.

If you don't know what kind of Windows version you have, check the following:
A Windows95-Retail is the one you can buy in the blue box,
A Windows95-OSR1 is the Windows version which was allready installed on your system when you
bought your PC. It should have a registration-code, containing the word "OEM". If it is so,
check the CD-Rom and look for the a specific month+year code. All versions below 0197 are OSR1.
A Windows95-OSR2 : see the explanation above. The date code is, all equals 0197 or above.
A WindowsNT4 with SP3 : Whatch your screen while starting up. When you get a blue screen, at the
top is written which version of NT it is and which SP is installed on it...

After installing, the program takes about 1.6Mb of space at your harddisk.
I recommend you to install the program into the directory that it suggests, namely the
"Program Files" folder, sub-folder: "LhK-Soft\HTML Generator", but you can install the program
also in any other folder or location (other harddisk, network disk, ...) you wish. Just be sure
that the location, where you install this program, don't have special security's. Whenever the
program is started, it must be allowed for it to write in it's own folder (so don't start it up
directly from a CD-Rom or a Read-Only network connection !!).
The reason for this is : the program not only uses the Registery for some base settings, but
also uses an INI-file, which is located in its own directory. Because you, the user, can
dynamicly alter some settings at run-time, the settings are stored into that INI-file (and
others into the registery).

More requirements:
I advise you to use a VGA-card which is placed into SVGA-mode (your screen-width must be at
least 800x600) and I advise you to have at least 65,535 colours installed (most cards does
support this mode). If your card only supports 256 colours in that screen-mode, you can try to
do so, but I did not tested it yet in that resolution.
The program does use a 256-color palette which is unique (not taken from the standard windows
colours-palette), so it could happen, that when you recall the colour-palette of the program,
that not all colours will be shown correctly, but this does not undermine the functionality of
the program - normally you should even be possible to use the program with only 16-colours !

The program has a lot of (small) graphics of it's own. These graphics are located in the
install-directory where you installed the program. Don't move or remove these graphics !
It are 129 files and about 112Kb (total size). They are used to let most files (which the
program can recognise) be more recognisable when you browse through the generated files.
The program, will copy these files (only those which are needed) to your destination path in a
seperate folder, where you want the program place the html-files while generating.

The program also needs to have following 2 run-time library's of Microsoft. These 2 DLL's are
located in this .ZIP file (where the Setup files are located), and only will be installed into
the System directory of your Windows folder if you don't have these files installed yet, or if
the files you have are older than those this program needs.
These files are:
  - MFC42.DLL   (version : 4.21.7303 or higher)
  - MSVCRT.DLL  (version : 5.00.7303 or higher)
These files are from MS-Visual C++ 5.0


Copyrights: (very important!)
===========
The program takes advantage of the functions whitin the DLL "Imw32d30.dll". Whithout this
DLL the program won't function proberly. This DLL is from PEGASUS. More about Pegasus and their
copyrights, can be viewed in the Help file of the program and in their own help-file
"Imwdll30.hlp", which is also installed. This help-file also contains all information you need
to have, if you want to use those functions for your own programs.

The 2 other DLL's are "LHKSOFT.DLL" and "lkStrings.DLL". These DLL's are written by me and must
allways be in the search-path of the program. This is the same directory where htmlGenerator.exe
is located, or in a directory which is named in the PATH environment string (mostly called
from within the autoexec.bat, or in the System folder of Windows -> where all other DLL's and
*.vbx are located)

This program is Postware.
This means that it actualy is Public-Domain software, but I, the author, would appreciate if
you send me a post-card or an E-mail, if you'd like to use this program for more than 1 time.
I also need to have some motivation to keep developping more applications...

I, the author, give full permission to all vendors and dealers of software, to distribute this
program, as long that there won't be asked NO MONEY for this program. Just the costs you will
have to distribute, like costs for diskettes, CD-Rom's etc. but I don't want to give any permis-
sion to all of those who want to make profits for their own by distributing or selling this
program!!!!
This program has no expiry date and is not some kind of demo version.
You may use this program as long as you like, but then I aspect you to send me some mail, as
described above.

What's new in version 1.1.1.95 ?
================================
Reported bug of Info-files (only came when scanning directory's with MOD files) removed.
The bug was : It didn't order the HTML-files like it should be.
This has been fixed...
Release date : 10/18/1998
What's new in version 1.1.2.95 ?
================================
The function-call in LHKSOFT.dll for "GetFreeDiskSpaceEx in KERNEL32.DLL" are rewritten, so I
could fix a reported bug, when you are using this program in Windows95 Retail or OSR1.
The program (only the main HTMLGenerator.EXE) has been rebuild in a Windows-OSR1 OS, so it will
work in these environments as well...
---
The program has now fully been tested in Windows95 OSR1/2 and
WindowsNT4-Workstation (with SP3), and in those environments it works propperly.
---
Some extra fixes are added to the main program, so it writes its data in a more cleaner way than
before (only when you select for DIR-files to write)...
---
The LHKSOFT.DLL has so been upgraded in version number from 1.0.0.95 to 1.1.0.95
Release date : 11/02/1998


For all comments, or your (registration) post-card, send it to:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Laurens Koehoorn
Av. J. Vuylsteke 4, box 7a
B-2050 Antwerp
Belgium (E.E.C./Europe)

E-Mail : lhksoft@bigfoot.com
WWW-1  : http://www.geocities.com/SiliconValley/Pines/6750/
WWW-2  : (until 12/31/98) http://titan.glo.be/~lhksoft/

This program is written by LhK-Soft, Laurens Koehoorn.
The official release date of HTML Generator 1.0.0.95 is 09/15/1998.
The official author of HTML Generator is Laurens Koehoorn.
---------------------------------------------------------------------------------
Microsoft(r) is a registered trade-mark of Microsoft Corporation
Windows(r) is a registered trade-mark of Microsoft Corporation
NT(tm) is a trademark of Northern Telecom Limited
Microsoft(r) Visual(r) C++(r) is a registered trade-mark of Microsoft Corporation
MS-DOS(r) is a registered trade-mark of Microsoft Corporation
Intel(r) is a registered trade-mark of the Intel Corporation
Pentium(tm) is a registered trade-mark of the Intel Corporation
Pentium-Pro(tm) is a registered trade-mark of the Intel Corporation
Pegasus(r) is a registered trade-mark of Pegasus Software LLC
LhK-Soft is a trade-mark of Laurens Koehoorn