DIR2HTML 1.1.0: Freeware utility for Win32
Copyright (C) 1999-2001 Jem E. Berkes

THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY WARRANTIES AS TO
PERFORMANCE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  THE ENTIRE RISK
AS TO THE RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU.
THE AUTHOR SHALL NOT HAVE ANY LIABILITY TO YOU OR ANY OTHER PERSON
OR ENTITY FOR ANY DAMAGES WHATSOEVER, INCLUDING, BUT NOT LIMITED TO,
LOSS OF REVENUE OR PROFIT, LOST OR DAMAGED DATA OR OTHER.  THE AUTHOR
IS ALSO NOT RESPONSIBLE FOR CLAIMS BY A THIRD PARTY.

This software is freeware. That means that you may use it as long as
you want without owing the author any money. However, this software
is not in the public domain. You may not modify, translate, reverse
engineer, decompile, or disassemble this software.

Check out our web site for more great Linux, Win32 and DOS tools:

			http://www.pc-tools.net/

The executable is compressed using UPX
http://wildsau.idv.uni-linz.ac.at/mfx/upx.html

This software package is distributed with NSIS
http://www.nullsoft.com/free/nsis/

Author's e-mail:
jberkes@pc-tools.net

Questions, comments, suggestions, bug reports welcome.

======================================================
I N S T R U C T I O N S !
======================================================

DIR2HTML creates an HTML index from a file system directory. This
is useful for building file lists, cataloging contents of CD-ROMS,
etc.

The program can index either a single directory or multiple
directories at once recursively. When operating in recursive mode,
a separate index is generated for each subdirectory.

Most of the options are self-explanatory. Start by browsing for the
folder you wish to index (top of the dialog box). If you wish to
make hyperlinks to files, check the appropriate box. If making links
you can also include a URL prefix which is inserted before the actual
hyperlink, useful for accessing remote files.

Once you're ready to create the index (or multiple indexes, with
recursive option) choose the Create HTML button. Then enter the an
output filename. In the case of recursive indexing, this file will
also be created in each subdirectory. Note: local subdirectories will
be created if they don't currently exist.

Description of each option:

[Browse]
	Locate the directory you wish to make an index of

File mask
	Control which files are included. Default is *.* (all files)

Depth: single
	Index a single directory

Depth: recursive
	Index a directory and every directory underneath it. This results
	in many output files being generated -- see [Create HTML]

Make links
	Instead of just listing file names, make each one a hyperlink

Prefix
	Optional text to include at the start of each hyperlink. Useful
	for accessing remote files -- eg http://server/path/

Link only directories
	Hyperlinks just the directories instead of making every file entry
	a hyperlink. Results in a nice, browsable series of indexes.

Read <title> tag from HTML documents
	Tries reading from every file that is indexed to see whether it
	contains an HTML title tag. If it does, this title is shown in
	place of the file name.

Extract links from .URL files
	If making links, this option pulls out the URL that's stored
	inside .URL files. The indexed files then have the corresponding
	hyperlinks. Can be used to (for example) build a list of links
	from your Internet Explorer favorites -- these are .URL files.

Reverse sort order
	Simply reverse the order in which the files appear. Note that
	directories, if there are any, are always listed ahead of files.

Include columns
	Specify which descriptive columns to include in indexes. Blank
	has been included in case you wish to leave some extra room for
	custom contents (comments, annotations, etc.)

Sort by
	A number of way to sort the files

Sizes in
	How to list file sizes. By default, Auto selects an appropriate
	suffix -- none (bytes), kilobytes, or megabytes.

[Create HTML]
	Creates the index, or indexes (in case of recursive). Name the
	file which will hold the index. If you are creating recursive
	indexes, this file (e.g. index.html) will be created once in
	every subdirectory. If you are making a recursive index of, say,
	a CD-ROM or other readonly media you will have to locate the
	output indexes on another drive. In that case, DIR2HTML will
	automatically create the required subdirectories to retain the
	full browsable structure.


======================================================
R E V I S I O N   H I S T O R Y
======================================================

Version 1.1.0
- Distributed with Nullsoft installer
- Added support for .URL files (can now extract links from them)
- Added progress window during recursive indexing
- Added option to include a blank column for custom use
- Added option to create links only to directories
- Added sorting capabilities
- Made changes to user interface, new options
- You can now create recursive indexes in alternate paths
- Bugfix: cleaned up directory recursion code
- Bugfix: rare filename parsing bug
- No longer resets options and directory; easier batch processing
- Many other improvements under the hood

Version 1.0.7
- Doesn't add meaningless "." entries to recursive indexes
- Distributed with UPX compression

Version 1.0.6
- Option to read <title> tags from html documents
- Warning added against using recursion with link prefix texts

Version 1.0.5
- Links to directories (in recursive) include index filenames
  This fixes local browsing issues

Version 1.0.4
- Now converts unsafe characters, e.g. space, to %nn (for hyperlinks)

Version 1.0.3
- Updated contact information

Version 1.0.2
- Added recursive index creation (all subdirectories included)
- Changed library that was used to write output; corrected occasional
  incorrectly-rounding file sizes
- The various file size types (bytes, kb, mb) can now be selected
  using the keyboard (previously a mouse was required to select)

Version 1.0.1
- Added various size styles and an Auto switch to select between
  bytes, kilobytes and megabytes in the listing
- Changed all HTML tags to lowercase to be compatible with the
  upcoming XHTML format
