
========================================================================
 IBM* APL2* for OS/2* read.me file:

 APL2 for OS/2 Demonstration Version
 (C) Copyright IBM Corp. 1994. All Rights Reserved.

 This is a time-limited version of APL2 for OS/2 Entry Edition.
 This version can be distributed freely so long as it has not been
 modified.  It is a violation of your limited rights of use to attempt
 to defeat the limitations built into this demonstration version.

 Please review the help text provided through the product logo
 window for further information on facilities and limitations.
========================================================================

========================================================================
 Deleting Previous Levels of APL2 for OS/2
========================================================================

 This demonstration version should not be installed over an
 existing Beta, Entry Edition, or Advanced Edition version of APL2/2.
 If you have one of these versions installed you should delete it
 before installing this product.

    1. Open the installation utility icon (in the APL2/2 folder).
    2. Pull down "View", choose "Installed Products".
    3. Select the APL2 product, pull down "Actions", choose "Delete".
    4. Re-boot your machine before installing the new product.

 After the deletion your APL2OS2 directory will remain intact
 along with any of your saved workspaces.  You can install
 this product into the same directory if you wish.

 If you had the Entry Edition or Advanced Edition installed
 you do not need to un-install and re-install the APL2 fonts.
 These fonts are the same for the Demonstration Version and both
 product levels.  If, however, you are un-installing an early
 beta version, you will need to un-install those APL2 fonts and
 install the new ones from the Demonstration Version.

========================================================================
 APL2 for OS/2 Installation
========================================================================

 You will have a set of diskettes, or a CD-ROM.

 To install:

  1. If you have diskettes, insert diskette 1 in your computer and type
     'a:install' (or 'b:install' if you are installing from drive B).

     If you have a CD-ROM, set your current directory to the directory
     on the CD-ROM containing APL2 for OS/2 and type 'install'.

  2. When you see the Instructions window, click on 'Continue'
     (or press 'Enter').

  3. From the Install window, click on 'OK' (or press 'Enter').
     You should leave the box marked 'Update config.sys' checked
     so the install program can make the necessary modifications.
     'Overwrite files' can be left unchecked.

  4. In the Install - directories window, click on 'Select All'.

  5. Click on 'Disk Space' for a list of possible target drives.
     Selecting a drive displays a message telling you if there
     is enough space for the install. If you select a new drive,
     check the box 'Change directories to selected drive'.

  6. If desired, change the name of the install directory.

  7. Click on 'Install' to begin installation.

     If you are installing from diskettes, you are prompted for the
     other disks during the installation.

  8. When the installation is complete, select 'Exit' from the 'File'
     menu of the Install window.

  9. Reboot your machine so the changes to config.sys can take effect.

 The installation tool does not install the APL2 fonts. You must install
 these yourself.  See the next section for instructions.

========================================================================
 APL2/2 Font Installation
========================================================================

APL2/2 is shipped with the following fonts:

  PostScript**:
     Courier APL2
     Courier APL2 Bold
     APL2 Italic

  Bitmap:
     APL2 Info
     APL2 AP124

Installing Fonts

  1. Open the "Font Palette" that is found in the "System Setup"
     folder inside the "OS/2 System" folder.

  2. Select "Edit font..."

  3. Select "Add".

  4. Enter the path where the APL2 fonts can be found, by default,
     C:\APL2OS2\FONTS.

  5. Select "Add...".

  6. The "Add New Font" dialog appears, with the .FON and .AFM files
     listed.  Select the fonts you wish to install.

     The Courier APL2, Courier APL2 Bold, APL2 Italic, and APL2 Info
     fonts must be installed with the OS/2 font palette in order for
     them to be used by APL2.  The APL2 AP124 font is not required to be
     installed to be used by AP 124, but it may be installed if you wish
     to use it in other APL2 or non-APL2 windows.

     NOTE: the APL2NORM (facename APL2) font is not provided with the
     APL2/2 product. Please ignore any reference to this font in the
     User's Guide.

  7. The directory to copy the font files to should default to the
     correct directory.  Do not change it.

  8. Select "Add".

  9. Exit the font palette "Edit Font" dialog.
     The fonts are not available until you have exited.

 NOTE: Under OS/2 2.0 you may need to install the fonts one at a time.
 Simply repeat the Add New Font portion of the procedure for each file.

Choosing a Font for the Session Manager and Editor

  The PostScript fonts provided are intended for use by the Session
  Manager and APL2 object editor, and for printing.  The bitmap fonts
  provided (APL2 Info and APL2 AP 124) may be selected for use by the
  Session Manager and editor windows, but note that printing is not
  supported using these fonts.  An alternate PostScript font will be
  selected by the Session Manager for printing.

Uninstalling Fonts

  If maintenenance is supplied for the APL2 fonts you may need to
  re-install them.  This is a two-step process - first the old
  fonts must be deleted, then the new fonts installed by the process
  outlined above.

  When you use the OS/2 font palette to delete a font, sometimes
  you may get a message indicating that the font cannot be deleted
  because it is in use.  Even though it does not seem to be active,
  a font may be loaded at boot time or left loaded after it is used
  for performance reasons by OS/2.  The rules for when this happens
  vary by release of OS/2 so we will not attempt to elaborate on
  them here.

  If you get the "in-use" message you will need to re-boot your machine
  to complete the deletion of the font.  Once you have re-booted,
  verify that the font is no longer in the list of fonts in the font
  palette.  Then verify whether the font file has been removed from
  C:\PSFONTS.  If it is still there, you will need to erase it.

========================================================================
 The APL2/2 Installation Utility
========================================================================

 The APL2/2 Installation Utility can be invoked by clicking mouse
 button 1 on the Installation Utility icon in the APL2/2 folder.
 This utility can be used to Update, Delete, and Restore the APL2/2
 product. When you invoke the utility after installing APL2/2, the
 Action menu can be used to Delete or Update the product. Update
 is used to install future updates or maintenance to the product.
 Delete can be used to remove the product from your hard disk.

 *** IMPORTANT ***
 In order to successfully use the Delete function, you must
 reboot your machine and invoke Delete before running APL2/2 or
 viewing the online documentation. Failure to do this causes
 Delete to fail and leaves the product in an unrecoverable state.

 After using the Installation Utility to delete the APL2/2
 product, you must reboot your machine to finish the process.

 After deleting the product, do not use the Install action from
 the Installation Utility Action menu, use install from disk #1
 of the APL2/2 product only.

========================================================================
 Version 1.0 notes:
========================================================================

APL2/2 Folder

    After installation is complete, you will have a new folder on your
    OS/2 desktop called APL2 for OS/2 Demo. Open the folder and click
    on the 'APL2/2 Users Guide' icon for information relating to this
    version. The folder also contains a program object that can be
    used to start APL2/2. This object should be considered a template
    to be customized by the user. In particular, you probably want to
    modify the following items in Settings:

      On the Program page, you should change 'Working Directory'
      to a directory where you would like your default workspace
      library and session manager log.

      On the Window page, you might want to change 'Open Object
      Behavior' to 'Create new window'. This allows you to start
      multiple APL2/2 sessions from the same object.


Using OS/2 2.0

    OS/2 2.0 Service Pak 1 or later or OS/2 J 2.1 or later
    are required to use APL2 for OS/2.


Printing AP 207 windows

    Printing of AP 207 windows that contain Bitmap or Images can cause
    the window to not print correctly. This is caused by the spooler
    inadvertently modifying the file. To correct this you can:
       1. Disable the print spooler.
          or
       2. Open your printer SETTINGS and select Queue Options.
          Check the printer specific format box and close the SETTINGS.
          (The picture viewer does not work on these printer specific
           items.)


Printing APL Characters Using Hewlett-Packard LaserJet** Print Drivers

   The LaserJet drivers supplied with the GA levels of OS/2 2.0 and
   OS/2 2.1 have a bug when the APL font is downloaded.  When
   attempting to print APL characters, although the driver causes
   the printer to print the file, the downloaded APL characters are
   not printed.

   To print APL characters, open the Printer driver page of the
   LaserJet settings, then open the printer driver settings and
   select Device Defaults. In the Device Defaults window, check
   the Fast System Fonts option.  This option turns off the Print
   Driver's code to download the APL font.


Printing APL Characters Using PostScript Print Drivers

   The PostScript driver supplied with the GA levels of OS/2 2.0 and
   OS/2 2.1 has a problem involving downloaded fonts.  When
   attempting to print APL characters, although the driver produces
   a PostScript file, the file is unusable.  When sent to a printer,
   the file is discarded by the printer.

   To print APL characters, check the Printer Specific option on the
   Queue Options page of the settings notebook of the printer object.
   This option turns off the print driver's code to build a PostScript
   file that downloads the APL font.

   Since the font is not downloaded, each APL character is drawn as a
   series of lines.  PostScript files containing APL characters can be
   very large and the time required to generate the file can be very
   long.

   To avoid these problems, select a non-PostScript driver, if
   possible.


Keyboard Layout Modification Window Font Error

   The APL2 Keyboard Handler is used to enable entry of APL characters
   into PM windows.  The APL2 Keyboard handler supports a Keyboard
   Layout Modification window.

   The Keyboard Layout Modification window is supposed to display the
   keyboard layout using the same font that the APL-enabled window is
   using.

   The modification window determines the APL-enabled window's font by
   querying the metrics of the window's default font. This works
   if the window uses the font Local Identifier (LCID) 0. It does not
   work for windows that use an LCID other than 0. Multiple Line
   Entry (MLE) fields do not use LCID 0.

   Applications that need to use the APL2 Keyboard Handler to enable
   entry of APL characters into an MLE can use a second invisible
   window to invoke the Keyboard Layout Modification window.  Subclass
   a second window, that is not an MLE and that can be invisible,
   using the Keyboard Handler and send the APLKEY_MSG_MODIFY message
   to the second window.


========================================================================
DBCS Support Provided by PM and APL2
========================================================================

 The on-line User's Guide includes complete information on use of
 double-byte character sets for Asian languages.  At present this
 information is not available in the printed User's Guide.

 There are currently (as of Version 2.1) two bugs in OS/2 J that
 affect the use of APL characters:

   1) When a PostScript font is first loaded after booting the
      machine, PM associates the current codepage with the font.  The
      font continues to be associated with that codepage until the
      machine is rebooted even if the font is unloaded or the process
      codepage is changed.  If the current codepage is any codepage
      other than 850, then APL characters do not display correctly in
      several PM controls and APL characters can not be entered in
      Entry Field Controls.

      Use the following procedure to effectively use the APL
      PostScript fonts included in APL2/2:

         List codepage 850 in the CODEPAGE statement in config.sys.

         After booting and before running any program that uses the
         APL font, switch to codepage 850 using the CHCP command.

         From the process that is using codepage 850, run any program
         that loads the APL font.

   2) APL characters cannot be written to Entry Field controls that
      have the ES_SBCS attribute flag using WinSetWindowText.  OS/2's
      DBCS recognition scheme is activated during WinSetWindowText;
      the APL characters are interpreted as DBCS characters; the Entry
      Field control beeps, and the control text is not changed.

      This problem does not effect any part of the APL2/2 Programming
      Environment.

      Applications that allow entry of APL characters in entry
      fields should not use ES_SBCS.


========================================================================
 Support
========================================================================

 We'd like to hear from you!

 Please report any comments, suggestions, or problems through one of the
 following channels:

   Internet:    apl2@vnet.ibm.com

   IBMMAIL:     USIB6JN8

   TALKLINK:    OS2bbs1; Qandabbs; TLpgcat

   FAX:         1-408-463-4488

   Phone:       1-408-463-APL2  (1-408-463-2752)

   Mail:        APL Products & Services
                IBM Santa Teresa Laboratory, RENA/F40
                555 Bailey Ave.
                San Jose, CA 95141


========================================================================
 Trademarks
========================================================================

 The following terms are trademarks of the IBM Corporation.  They are
 denoted by an asterisk (*) when they first appear in the text.

     APL2
     IBM
     OS/2
     Presentation Manager

 The following terms are trademarks of other companies. They are
 denoted by a double asterisk (**) when they first appear in the text.

     PostScript          Adobe Systems, Inc.
     LaserJet            Hewlett-Packard, Inc.

