Installation

Welcome to SoftQuad HoTMetaL PRO, a professional SGML editor especially for HTML files.

This distribution is for Microsoft Windows 3.1; it will not run without Microsoft Windows. You will need about 8 Megabytes of free disk space on your hard drive, and about 6 Megabytes of available RAM.. If you have less memory than this, you may be able to create a Windows swap file and continue, but your system will run much faster if you have more memory.

Please follow all the steps carefully. HoTMetaL PRO may not operate correctly if you miss a step, so save yourself some time and do it all the first time.

You may have received the software on diskettes or as a self-extracting archive file that you ftp'ed.

Installing from diskettes

Start the installation by inserting the floppy disk labeled SoftQuad HoTMetaL PRO Disk 1 into the appropriate floppy drive. In the procedure that follows, we will assume that you have the floppy in the A: drive, and that you are installing the software on the C: drive. If you are using different drives, then simply substitute the names of those drives for the names in the examples.

The software on this floppy disk has been stored in a compressed format to make it easier to ship. To extract the files (i.e., convert them back into a format that you can use and copy them to your hard disk) you will run a program called an installation script. To do this, follow these steps:

  1. Start up Windows.
  2. You may run the installation script in one of two ways.
    • Use the Run... command in the Windows Program Manager with the command line
      a:setup
      (This assumes you have put the floppy disk in the A: drive; if not, substitute the drive name you're using in this command.)
    • Using the Windows File Manager, click on the file a:setup.exe

    A dialog box appears, letting you choose where to install the software. The default location is the directory c:\hotmetal. You are given the opportunity to install the software in a different location.

  3. If you want use an alternate location, type it in the text box labeled Copy to. Include the full path name, as well as the drive name.

  4. Now click on the [Ok] button to proceed with the installation. If, for some reason, you wish to cancel the installation, click on the [Exit] button.

The installation script will check that you have enough disk space. If there is not enough, it will return you to the dialog box where you may choose an alternate location for the software, or else cancel the installation and free up some disk space.

Another dialog box appears which allows you to monitor the progress of the installation. A horizontal bar in the dialog box will gradually increase in length to indicate the proportion of files that have been extracted. You will be prompted when you need to change the diskette.

If you already have a previous version of HoTMetaL PRO installed on your machine in the same directory in which the new version is being installed, you may wish to keep certain files intact. For certain files in the distribution, a dialog box will appear allowing you to install the new version of a file and create backup copies of the old file, or else leave the old file as it is without installing the new file. If this is the first time HoTMetaL PRO has been installed on this computer, these dialog boxes will not appear.

If you want to cancel the installation during the extraction procedure, you may click on the [Exit] button. If you attempt to do this, a dialog box will appear asking whether you still wish to cancel.

The installation will take approximately 5 minutes to complete.

  1. Once the files have been extracted, a dialog box will appear asking you for the name of the Windows program group that will be created. By default, the installation program will create a program group called SoftQuad HoTMetaL PRO. If you wish to create a different group, enter the name in the text box provided. If a program group of that name already exists, it will be overwritten. You can run HoTMetaL PRO by clicking on an icon in this program group.

Installing from a self-extracting archive

If you ftp'ed the HoTMetaL PRO software, you have received a self-extracting archive file called hotmtpro.sqx. This means that the program that installs the software, and the software itself, are contained in the same file. Executing this file will install the software.

  1. You will need to choose somewhere to install SoftQuad HoTMetaL PRO. A directory called hotmtpro will be created by the installation procedure, but you can put that directory anywhere you like. You will need approximately 8 Megabytes of disk space, in addition to whatever space is required by the hotmtpro.sqx file (which you can delete later). You can check available disk space with the dir command. We'll assume that you chose c:\hotmtpro, but you can put it anywhere.
  2. Exit to DOS or bring up a DOS window.
  3. Rename the distribution file from hotmtpro.sqx to hotmtpro.exe:
    c:> rename hotmtpro.sqx hotmtpro.exe
  4. Now you can extract the software:
    c:> hotmtpro -d
    Don't omit the -d option in this command: the installation will be unsuccessful if you don't use it.
  5. This creates a directory called hotmtpro inside c:\, you you end up with c:\hotmtpro. In this example, we assumed that the self-extracting archive file hotmtpro.exe was also located in the c:\ directory: you could have put it anywhere you had space (just prepend the drive and directory to the archive name when performing the extraction).
  6. You must now set up a Windows program group and program item (or add a HoTMetaL PRO program item to an existing program group). To create a program group:
    1. Invoke the New... command in the Program Manager's File menu.
    2. A dialog box appears. Click on the Program Group radio button.
    3. Click on the [OK] button.
    4. A dialog box appears. Type `SoftQuad HoTMetaL PRO' or a description of your choice in the Description text box.
    5. Click on the [OK] button.
    This creates a window with the title you specified.

    To create a program item for HoTMetaL PRO:

    1. The group window for the program group you just created should be the active window.
    2. As before, invoke the New... command in the Program Manager's File menu.
    3. Now click on the Program Item radio button.
    4. Click on the [OK] button.
    5. Type `SoftQuad HoTMetaL PRO' or a description of your choice in the Description text box.
    6. Type the following command in the Command Line text box:
      c:\hotmtpro\sqhmpro.exe -sqdir c:\hotmtpro
    7. Type `c:\hotmetal' in the Working Directory text box.
    8. Click on the [OK] button.
    The HoTMetaL PRO icon is added to the program group window.

Getting ready to use HoTMetaL PRO

These steps are optional.

  1. If you want to associate HoTMetaL PRO with your HTML files (thereby allowing you to invoke HoTMetaL PRO by clicking on that file in the File Manager) do the following for each such file (which should have the ` .htm' file extension):
    1. In the Program Manager, click once on the file.
    2. Invoke the Associate... command.
    3. In the Associate With text box, enter the command:
      c:\hotmtpro\sqhmpro.exe
      (Or click on [Browse...] and choose the program from a file chooser.)
    4. Click on the [OK] manual.
  2. Print The Manual (optional): If you want to print out the manual, it's in c:\hotmtpro\doc\hotmetal.ps, and you can send it to any PostScript printer (it is not in exactly the same format as the printed manual, and uses basic LaserWriter Plus fonts, such as Times Roman, however). The manual will use about 150 pages. The manual may also have been supplied in other formats.
  3. Read The Manual (optional): You can do this later if you're impatient.
  4. Run The Program: click on the HoTMetaL PRO icon.
  5. Read The Manual (if you didn't do it before).