HTML Rename!(TM) version 2.00
Copyright (c) 1996-2000 Expandable Language
All rights reserved


WHAT DOES HTML RENAME! DO?
--------------------------
HTML Rename!(R) eliminates the problems encountered when moving files 
between DOS/Windows, Macintosh, and UNIX file systems.  By changing file 
names (case, length, and invalid characters) and fixing links in HTML 
code, HTML Rename! ensures that your files and Web pages will work on 
any operating system.  Using HTML Rename! before you transfer files (for 
example, uploading a Web site to a UNIX server) saves you from needing 
to repair mangled filenames, broken links, and extra or missing carriage 
return characters in text files.

HTML Rename! assists Web site development by checking the consistency of 
URL links and generating reports on local and external URLs.  It 
guarantees that your site will work on any operating system by enforcing 
a file naming convention. HTML Rename! can automatically change every 
filename to fit a new naming convention, or you can choose to 
individually alter each invalid filename as HTML Rename! reviews it. Run 
HTML Rename! before each Web site upload and never have another broken 
link! 



HTML RENAME!'S FEATURES
-----------------------
* Targets DOS, Macintosh, UNIX, and other filesystems -- including ISO 
  9660 (the most universal naming structure on the planet)
* Reports and renames files whose names are invalid on a target system
* Automatically or interactively generates valid filenames
* Updates links in your HTML pages for renamed files
* Converts local links to relative or absolute URLs
* Forces URL links to be case consistent with filenames
* Alters file extensions such as HTML, JPEG, MPEG, & PING for the 
  DOS/Windows, Macintosh, or UNIX convention (and fixes the names in the 
  HTML code simultaneously)
* Reports missing and external links
* Removes files not referenced in a Web site (great for finding stray 
  graphics and old files no longer in use)
* Updates ASCII line ends for DOS/Windows, Macintosh, or UNIX format
* Works on a single directory or an entire directory tree
* Uses a clear, easy-to-follow, graphical wizard interface


WHAT PROBLEMS DOES HTML RENAME! SOLVE?
--------------------------------------

1) Moving a Web Site to a Different System Can Break URL Links.

Typically, development of a Web site is done locally on a PC or 
Macintosh and then uploaded to a server as the final "publishing" step.  
If the server runs a different operating system than the local 
development system, transferring the site to the server may break local 
URL links.

One example of this is the strict filename upper and lower case 
sensitivity in UNIX.  If you have an image file named "Janine.gif" and 
reference that file as <a href "janine.gif"> the image will work when 
testing on Macintosh or Windows.  On a UNIX server, however, you will 
get a broken GIF because UNIX enforces stricter case sensitivity than 
the Macintosh or Windows.  HTML Rename! fixes this by changing the URL 
link to <a href "Janine.gif">, matching the filename exactly.

Other examples are characters which can appear in filenames on one 
system but not on another.  For example, the filename "<Nov-96>.gif" is 
valid on Macintosh and UNIX but not on Windows because of the greater-
than and less than "<>" characters.  If you transfer a Web site 
containing this file to an NT server, the links to this file will be 
broken.

Yet another example is differing filename extensions.  For HTML, JPEG, 
MPEG, and PING files; Macintosh and UNIX require the filename extensions 
"html", "jpeg", "mpeg", and "ping"; while Windows requires "htm", "jpg", 
"mpg", and "png".

HTML Rename! fixes all of the above problems, and more!


2) Verifying Your Web Site's URL Links

You can also use HTML Rename! to verify that your site is squeaky-clean 
with no broken links.  HTML Rename! directly checks your local links and 
generates a list of external URLs which you can check by loading the 
list into your Web browser.  At the same time, HTML Rename! can verify 
that no links will get broken in the process of uploading your Web site 
to your server.


3) ISO 9660 Filenames for CD-ROMs

Many CD-ROM burning programs give you the option to automatically 
convert filenames to ISO 9660 format, a specification which guarantees 
all operating systems will understand the filenames.  HTML Rename! gives 
you a finer granularity of control, allowing you to generate a report of 
needed changes without renaming files, or to interactively rename files, 
providing names which make more sense for your documents/data.


4) Removes Orphan Files

Web site development involves adjustments: graphics are modified and 
discarded, a file is saved aside while testing new text or a new layout, 
etc.  After a while, your site is littered with "orphans"--files that 
are no longer used in the web site.  HTML Rename! can identify and 
remove these orphan files, making your local directory clean so that 
you can upload everything without wasting space on your server.


5) Graphical, Directory-based unix2dos, dos2unix, unix2mac, etc.

DOS/Windows, Macintosh, and UNIX all differ in their conventions for 
line endings of ASCII text files.  As a result, files created on one 
system and read on another may appear as one very long line, or with 
garbage characters at the beginning or end of every line.  Most UNIX 
systems have the dos2unix and unix2dos command line utilities to convert 
files one at a time.  HTML Rename! provides a graphical user interface 
to perform these operations on entire directories of files in one pass.


SYSTEM REQUIREMENTS
-------------------

HTML Rename! for Windows:
486/33MHz or greater processor
8MB RAM
5MB of free disk space
Windows 95/95/NT/2000 (no NT 3.x)

HTML Rename! for Power Macintosh:
Any PowerPC processor
8MB RAM
5MB of free disk space
MacOS System 7 or greater (7.5 or greater recommended)


INSTALLATION
------------
No special installation is required.  Simply extract the files from the 
archive and HTML Rename! will be ready for use.  

HTML Rename! is distributed either as a Windows zipped file 
("renawNNN.zip") or Macintosh Stuffit file ("renamNNN.sit"), where "NNN" 
represents the version number.  If you have a self-extracting archive, 
simply double click on it to extract the files.  Otherwise launch your 
favorite application to unzip or unstuff the archive.  See below for 
the list of files in the archive.


PRICING OF HTML RENAME!
-----------------------
HTML Rename! is shareware.  As such, it is available for a free 30 day 
evaluation period, after that the software will disable itself.  If you 
find HTML Rename! useful you must register and pay a registration fee as 
follows:

HTML Rename! 2.x for Windows 95/NT:  US$29  per user
HTML Rename! 2.x for Macintosh:      US$29  per user

When your registration payment is received you will be sent a 
registration key and be granted a license to have unlimited use of a 
single copy of HTML Rename!.

A Site License costs US$750 (equal to 25 users) and covers all locations 
for your organization within a 160 kilometer radius of your site (100 
miles).  One big advantage of a Site License is that you do not need to 
keep track of how many people at your site are using the software.  A 
World-Wide License costs US$3000 and it covers all locations for your 
organization on the planet earth.  Site and World-Wide Licenses for HTML 
Rename! for Windows or HTML Rename! for Macintosh must be purchased 
separately.


HOW DO I REGISTER HTML RENAME!
------------------------------
Registering HTML Rename! is fairly simple.  Click the "Register..." 
button in the initial Shareware Notice dialog.  Then either click on 
"Register online with a credit card..." to launch your browser and take 
you to HTML Rename!'s online registration site, or click on "Register 
via email, fax, or postal mail..." to launch the Register program.

Kagi handles payment processing for HTML Rename!, you will make your 
payments out to them.  See more information about Kagi below.

NOTE: It is important that you provide YOUR EMAIL ADDRESS during 
registration.  Expandable Language uses your email address to generate 
the registration key which grants you unlimited use of a single copy of 
HTML Rename!.  If you are ordering multiple copies or a Site or World-
wide License, Expandable Language will contact you with information on 
how to complete your registration.


REGISTERING ONLINE
------------------
Currently, only credit and debit card transactions and payment via First 
Virtual can be handled online.  Click on "Register online with a credit 
card..." from HTML Rename!'s registration dialog or point your browser 
at "http://order.kagi.com/?NK&S" for a secure server or 
"http://order.kagi.com/?NK" for a normal server.
Enter your name, your email address, and the number of single user 
licenses you desire for each program you wish to purchase (or Site or 
Word-Wide licenses).  Click the "Submit" button to continue to the next 
page and enter your credit card information for submission to Kagi.


REGISTERING WITH THE REGISTER PROGRAM
-------------------------------------
Registration via the Register program allows payment by credit card, 
check, cash, and some forms of digital payment and may be submitted via 
email, fax, or "snail mail."  Enter your name, your email address, and 
the number of single user licenses you desire for each program you wish 
to purchase (or Site or Word-Wide licenses).  Save or Copy or Print the 
data from the Register program and send the data and payment to Kagi.

If paying with Credit Card, you can email or fax the data to Kagi.  
Their email address is sales@kagi.com and their fax number is 
+1 510 652-6589.  You can either Copy the data from Register 
and paste into the body of an email message or you can Save the data to 
a file and you can attach that file to an email message.  There is no 
need to compress the data file, it is already pretty small.  If you have 
a fax modem, just Print the data to the Kagi fax number.

Payments sent via email are processed within 3 to 4 days.  You will 
receive an email acknowledgment when it is processed.  Payments sent via 
fax take up to 10 days and if you provide a correct Internet email 
address you will receive an email acknowledgment.

If you are paying with Cash or USD Check you should print the data using 
the Register application and send it to the address shown on the form, 
which is:

          Kagi
          1442-A Walnut Street, PMB 392-NK
          Berkeley, California 94709-1405
          USA

You can pay with a wide variety of cash from different countries but at 
present if you pay via check, it must be a check drawn in US Dollars. 
Kagi cannot accept checks in other currencies, the conversion rate for 
non-USD checks is around USD 15 per check and that is just not 
practical.  If you have a purchasing department, you can enter all the 
data into the Register program and then select Invoice as your payment 
method. Print three copies of the form and send it to your accounts 
payable people. You might want to highlight the line that mentions that 
they must include a copy of the form with their payment.

Kagi can not invoice your company, you need to act on our behalf and 
generate the invoice and handle all the paperwork on your end.

Please do not fax or email payment forms that indicate Cash, Check or 
Invoice as the payment method.  As far as we know, there is still no 
technology to transfer physical objects via fax or email and without the 
payment, the form cannot be processed.  Payments send via postal mail 
take time to reach Kagi and then up to 10 days for processing.  Again, 
if you include a correct email address, you will hear from Kagi when the 
form is processed.


WHAT IS THE CURRENT VERSION OF HTML RENAME!
-------------------------------------------
Check "http://www.xlanguage.com" to download the latest version.  
If you are a registered user of HTML Rename!, you will receive email 
notifying you of new releases.  Here is the current revision history:

HTML Rename! for Windows:
  v1.00  27-Nov-96  Initial release
  v1.10  10-Mar-97  Support for new tags, external text editor
  v1.20  08-May-97  Relative or absolute URLs, ISO-8859-1 charset
  v1.21  14-May-97  Fix relative URL substitution bug, base tags
  v1.22  04-Mar-00  Fix CR/LF conversion bug, update address information
  v2.00  31-Aug-00  Many new features: remove orphans, single-dialog interface

HTML Rename! for Macintosh:  
  v1.00  27-Nov-96  Initial release
  v1.10  10-Mar-97  Support for new tags, external text editor
  v1.20  08-May-97  Relative or absolute URLs, ISO-8859-1 charset
  v1.21  14-May-97  Fix relative URL substitution bug, base tags
  v1.22  04-Mar-00  Fix CR/LF conversion bug, update address information
  v2.00  31-Aug-00  Many new features: remove orphans, single-dialog interface

See the "History.txt" file for specific changes in each release.


FILES IN THIS DISTRIBUTION
--------------------------
HTML Rename! for Windows 95/NT:
  Readme-Rename.txt -- This file
  HRename.exe       -- HTML Rename! for Windows executable program
  Register.exe      -- Shareware registration program for HTML Rename!
  Register.hlp      -- Windows Help file for Register.exe
  License.txt       -- Software license agreement for this software
  LocalReg.html     -- Points to online registration page
  File_id.diz       -- Quick identifier with product and version info
  History.txt       -- Version history for what is new in each version

HTML Rename! for Macintosh:
  Readme-Rename.txt -- This file
  HTML Rename!      -- HTML Rename! for Macintosh application
  Register          -- Shareware registration app for HTML Rename!
  License.txt       -- Software license agreement for this software
  LocalReg.html     -- Points to online registration page
  History.txt       -- Version history for what is new in each version


WHO DEVELOPED HTML RENAME!
--------------------------
HTML Rename! was developed by Expandable Language, PMB 191,
2238B South Shore Center, Alameda, CA 94501 (info@xlanguage.com).
Terence M. Parker (Terry) founded Expandable Language (formerly
Parker & Associates) in 1994 after 10 years of experience in Berkeley 
software companies.

Terry's roles in software startups have included Vice President of 
Engineering at Vividata, Inc. and principal designer of Caere's OmniPage 
optical character recognition product for UNIX/Motif.  His work has 
included all aspects of software development and support, from initial 
design through end-user support.  This experience is all brought to bear 
on HTML Rename!.

HTML Rename! was born when Ken Milburn, one of the authors of 
"Converting Content for Web Publishing" called Terry, saying that he had 
not been able to find a much-needed utility to rename files.  Terry, who 
has developed products for DOS, Windows, Macintosh, UNIX, etc., saw the 
usefulness of such a utility and got a little carried away.  The result 
(together with insights from the authors of Converting Content for Web 
Publishing) is HTML Rename! -- a sophisticated, professional program 
carefully designed and tested, and ready for serious work. 


Last updated: 31-Aug-2000
###
