home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / apl2116.zip / apl2d1ga.zip / READ.ME < prev    next >
Text File  |  1999-11-05  |  16KB  |  384 lines
  1.  
  2. ========================================================================
  3.  IBM* APL2* for OS/2* read.me file:
  4.  
  5.  APL2 for OS/2 Demonstration Version
  6.  (C) Copyright IBM Corp. 1994. All Rights Reserved.
  7.  
  8.  This is a time-limited version of APL2 for OS/2 Entry Edition.
  9.  This version can be distributed freely so long as it has not been
  10.  modified.  It is a violation of your limited rights of use to attempt
  11.  to defeat the limitations built into this demonstration version.
  12.  
  13.  Please review the help text provided through the product logo
  14.  window for further information on facilities and limitations.
  15. ========================================================================
  16.  
  17. ========================================================================
  18.  Deleting Previous Levels of APL2 for OS/2
  19. ========================================================================
  20.  
  21.  This demonstration version should not be installed over an
  22.  existing Beta, Entry Edition, or Advanced Edition version of APL2/2.
  23.  If you have one of these versions installed you should delete it
  24.  before installing this product.
  25.  
  26.     1. Open the installation utility icon (in the APL2/2 folder).
  27.     2. Pull down "View", choose "Installed Products".
  28.     3. Select the APL2 product, pull down "Actions", choose "Delete".
  29.     4. Re-boot your machine before installing the new product.
  30.  
  31.  After the deletion your APL2OS2 directory will remain intact
  32.  along with any of your saved workspaces.  You can install
  33.  this product into the same directory if you wish.
  34.  
  35.  If you had the Entry Edition or Advanced Edition installed
  36.  you do not need to un-install and re-install the APL2 fonts.
  37.  These fonts are the same for the Demonstration Version and both
  38.  product levels.  If, however, you are un-installing an early
  39.  beta version, you will need to un-install those APL2 fonts and
  40.  install the new ones from the Demonstration Version.
  41.  
  42. ========================================================================
  43.  APL2 for OS/2 Installation
  44. ========================================================================
  45.  
  46.  You will have a set of diskettes, or a CD-ROM.
  47.  
  48.  To install:
  49.  
  50.   1. If you have diskettes, insert diskette 1 in your computer and type
  51.      'a:install' (or 'b:install' if you are installing from drive B).
  52.  
  53.      If you have a CD-ROM, set your current directory to the directory
  54.      on the CD-ROM containing APL2 for OS/2 and type 'install'.
  55.  
  56.   2. When you see the Instructions window, click on 'Continue'
  57.      (or press 'Enter').
  58.  
  59.   3. From the Install window, click on 'OK' (or press 'Enter').
  60.      You should leave the box marked 'Update config.sys' checked
  61.      so the install program can make the necessary modifications.
  62.      'Overwrite files' can be left unchecked.
  63.  
  64.   4. In the Install - directories window, click on 'Select All'.
  65.  
  66.   5. Click on 'Disk Space' for a list of possible target drives.
  67.      Selecting a drive displays a message telling you if there
  68.      is enough space for the install. If you select a new drive,
  69.      check the box 'Change directories to selected drive'.
  70.  
  71.   6. If desired, change the name of the install directory.
  72.  
  73.   7. Click on 'Install' to begin installation.
  74.  
  75.      If you are installing from diskettes, you are prompted for the
  76.      other disks during the installation.
  77.  
  78.   8. When the installation is complete, select 'Exit' from the 'File'
  79.      menu of the Install window.
  80.  
  81.   9. Reboot your machine so the changes to config.sys can take effect.
  82.  
  83.  The installation tool does not install the APL2 fonts. You must install
  84.  these yourself.  See the next section for instructions.
  85.  
  86. ========================================================================
  87.  APL2/2 Font Installation
  88. ========================================================================
  89.  
  90. APL2/2 is shipped with the following fonts:
  91.  
  92.   PostScript**:
  93.      Courier APL2
  94.      Courier APL2 Bold
  95.      APL2 Italic
  96.  
  97.   Bitmap:
  98.      APL2 Info
  99.      APL2 AP124
  100.  
  101. Installing Fonts
  102.  
  103.   1. Open the "Font Palette" that is found in the "System Setup"
  104.      folder inside the "OS/2 System" folder.
  105.  
  106.   2. Select "Edit font..."
  107.  
  108.   3. Select "Add".
  109.  
  110.   4. Enter the path where the APL2 fonts can be found, by default,
  111.      C:\APL2OS2\FONTS.
  112.  
  113.   5. Select "Add...".
  114.  
  115.   6. The "Add New Font" dialog appears, with the .FON and .AFM files
  116.      listed.  Select the fonts you wish to install.
  117.  
  118.      The Courier APL2, Courier APL2 Bold, APL2 Italic, and APL2 Info
  119.      fonts must be installed with the OS/2 font palette in order for
  120.      them to be used by APL2.  The APL2 AP124 font is not required to be
  121.      installed to be used by AP 124, but it may be installed if you wish
  122.      to use it in other APL2 or non-APL2 windows.
  123.  
  124.      NOTE: the APL2NORM (facename APL2) font is not provided with the
  125.      APL2/2 product. Please ignore any reference to this font in the
  126.      User's Guide.
  127.  
  128.   7. The directory to copy the font files to should default to the
  129.      correct directory.  Do not change it.
  130.  
  131.   8. Select "Add".
  132.  
  133.   9. Exit the font palette "Edit Font" dialog.
  134.      The fonts are not available until you have exited.
  135.  
  136.  NOTE: Under OS/2 2.0 you may need to install the fonts one at a time.
  137.  Simply repeat the Add New Font portion of the procedure for each file.
  138.  
  139. Choosing a Font for the Session Manager and Editor
  140.  
  141.   The PostScript fonts provided are intended for use by the Session
  142.   Manager and APL2 object editor, and for printing.  The bitmap fonts
  143.   provided (APL2 Info and APL2 AP 124) may be selected for use by the
  144.   Session Manager and editor windows, but note that printing is not
  145.   supported using these fonts.  An alternate PostScript font will be
  146.   selected by the Session Manager for printing.
  147.  
  148. Uninstalling Fonts
  149.  
  150.   If maintenenance is supplied for the APL2 fonts you may need to
  151.   re-install them.  This is a two-step process - first the old
  152.   fonts must be deleted, then the new fonts installed by the process
  153.   outlined above.
  154.  
  155.   When you use the OS/2 font palette to delete a font, sometimes
  156.   you may get a message indicating that the font cannot be deleted
  157.   because it is in use.  Even though it does not seem to be active,
  158.   a font may be loaded at boot time or left loaded after it is used
  159.   for performance reasons by OS/2.  The rules for when this happens
  160.   vary by release of OS/2 so we will not attempt to elaborate on
  161.   them here.
  162.  
  163.   If you get the "in-use" message you will need to re-boot your machine
  164.   to complete the deletion of the font.  Once you have re-booted,
  165.   verify that the font is no longer in the list of fonts in the font
  166.   palette.  Then verify whether the font file has been removed from
  167.   C:\PSFONTS.  If it is still there, you will need to erase it.
  168.  
  169. ========================================================================
  170.  The APL2/2 Installation Utility
  171. ========================================================================
  172.  
  173.  The APL2/2 Installation Utility can be invoked by clicking mouse
  174.  button 1 on the Installation Utility icon in the APL2/2 folder.
  175.  This utility can be used to Update, Delete, and Restore the APL2/2
  176.  product. When you invoke the utility after installing APL2/2, the
  177.  Action menu can be used to Delete or Update the product. Update
  178.  is used to install future updates or maintenance to the product.
  179.  Delete can be used to remove the product from your hard disk.
  180.  
  181.  *** IMPORTANT ***
  182.  In order to successfully use the Delete function, you must
  183.  reboot your machine and invoke Delete before running APL2/2 or
  184.  viewing the online documentation. Failure to do this causes
  185.  Delete to fail and leaves the product in an unrecoverable state.
  186.  
  187.  After using the Installation Utility to delete the APL2/2
  188.  product, you must reboot your machine to finish the process.
  189.  
  190.  After deleting the product, do not use the Install action from
  191.  the Installation Utility Action menu, use install from disk #1
  192.  of the APL2/2 product only.
  193.  
  194. ========================================================================
  195.  Version 1.0 notes:
  196. ========================================================================
  197.  
  198. APL2/2 Folder
  199.  
  200.     After installation is complete, you will have a new folder on your
  201.     OS/2 desktop called APL2 for OS/2 Demo. Open the folder and click
  202.     on the 'APL2/2 Users Guide' icon for information relating to this
  203.     version. The folder also contains a program object that can be
  204.     used to start APL2/2. This object should be considered a template
  205.     to be customized by the user. In particular, you probably want to
  206.     modify the following items in Settings:
  207.  
  208.       On the Program page, you should change 'Working Directory'
  209.       to a directory where you would like your default workspace
  210.       library and session manager log.
  211.  
  212.       On the Window page, you might want to change 'Open Object
  213.       Behavior' to 'Create new window'. This allows you to start
  214.       multiple APL2/2 sessions from the same object.
  215.  
  216.  
  217. Using OS/2 2.0
  218.  
  219.     OS/2 2.0 Service Pak 1 or later or OS/2 J 2.1 or later
  220.     are required to use APL2 for OS/2.
  221.  
  222.  
  223. Printing AP 207 windows
  224.  
  225.     Printing of AP 207 windows that contain Bitmap or Images can cause
  226.     the window to not print correctly. This is caused by the spooler
  227.     inadvertently modifying the file. To correct this you can:
  228.        1. Disable the print spooler.
  229.           or
  230.        2. Open your printer SETTINGS and select Queue Options.
  231.           Check the printer specific format box and close the SETTINGS.
  232.           (The picture viewer does not work on these printer specific
  233.            items.)
  234.  
  235.  
  236. Printing APL Characters Using Hewlett-Packard LaserJet** Print Drivers
  237.  
  238.    The LaserJet drivers supplied with the GA levels of OS/2 2.0 and
  239.    OS/2 2.1 have a bug when the APL font is downloaded.  When
  240.    attempting to print APL characters, although the driver causes
  241.    the printer to print the file, the downloaded APL characters are
  242.    not printed.
  243.  
  244.    To print APL characters, open the Printer driver page of the
  245.    LaserJet settings, then open the printer driver settings and
  246.    select Device Defaults. In the Device Defaults window, check
  247.    the Fast System Fonts option.  This option turns off the Print
  248.    Driver's code to download the APL font.
  249.  
  250.  
  251. Printing APL Characters Using PostScript Print Drivers
  252.  
  253.    The PostScript driver supplied with the GA levels of OS/2 2.0 and
  254.    OS/2 2.1 has a problem involving downloaded fonts.  When
  255.    attempting to print APL characters, although the driver produces
  256.    a PostScript file, the file is unusable.  When sent to a printer,
  257.    the file is discarded by the printer.
  258.  
  259.    To print APL characters, check the Printer Specific option on the
  260.    Queue Options page of the settings notebook of the printer object.
  261.    This option turns off the print driver's code to build a PostScript
  262.    file that downloads the APL font.
  263.  
  264.    Since the font is not downloaded, each APL character is drawn as a
  265.    series of lines.  PostScript files containing APL characters can be
  266.    very large and the time required to generate the file can be very
  267.    long.
  268.  
  269.    To avoid these problems, select a non-PostScript driver, if
  270.    possible.
  271.  
  272.  
  273. Keyboard Layout Modification Window Font Error
  274.  
  275.    The APL2 Keyboard Handler is used to enable entry of APL characters
  276.    into PM windows.  The APL2 Keyboard handler supports a Keyboard
  277.    Layout Modification window.
  278.  
  279.    The Keyboard Layout Modification window is supposed to display the
  280.    keyboard layout using the same font that the APL-enabled window is
  281.    using.
  282.  
  283.    The modification window determines the APL-enabled window's font by
  284.    querying the metrics of the window's default font. This works
  285.    if the window uses the font Local Identifier (LCID) 0. It does not
  286.    work for windows that use an LCID other than 0. Multiple Line
  287.    Entry (MLE) fields do not use LCID 0.
  288.  
  289.    Applications that need to use the APL2 Keyboard Handler to enable
  290.    entry of APL characters into an MLE can use a second invisible
  291.    window to invoke the Keyboard Layout Modification window.  Subclass
  292.    a second window, that is not an MLE and that can be invisible,
  293.    using the Keyboard Handler and send the APLKEY_MSG_MODIFY message
  294.    to the second window.
  295.  
  296.  
  297. ========================================================================
  298. DBCS Support Provided by PM and APL2
  299. ========================================================================
  300.  
  301.  The on-line User's Guide includes complete information on use of
  302.  double-byte character sets for Asian languages.  At present this
  303.  information is not available in the printed User's Guide.
  304.  
  305.  There are currently (as of Version 2.1) two bugs in OS/2 J that
  306.  affect the use of APL characters:
  307.  
  308.    1) When a PostScript font is first loaded after booting the
  309.       machine, PM associates the current codepage with the font.  The
  310.       font continues to be associated with that codepage until the
  311.       machine is rebooted even if the font is unloaded or the process
  312.       codepage is changed.  If the current codepage is any codepage
  313.       other than 850, then APL characters do not display correctly in
  314.       several PM controls and APL characters can not be entered in
  315.       Entry Field Controls.
  316.  
  317.       Use the following procedure to effectively use the APL
  318.       PostScript fonts included in APL2/2:
  319.  
  320.          List codepage 850 in the CODEPAGE statement in config.sys.
  321.  
  322.          After booting and before running any program that uses the
  323.          APL font, switch to codepage 850 using the CHCP command.
  324.  
  325.          From the process that is using codepage 850, run any program
  326.          that loads the APL font.
  327.  
  328.    2) APL characters cannot be written to Entry Field controls that
  329.       have the ES_SBCS attribute flag using WinSetWindowText.  OS/2's
  330.       DBCS recognition scheme is activated during WinSetWindowText;
  331.       the APL characters are interpreted as DBCS characters; the Entry
  332.       Field control beeps, and the control text is not changed.
  333.  
  334.       This problem does not effect any part of the APL2/2 Programming
  335.       Environment.
  336.  
  337.       Applications that allow entry of APL characters in entry
  338.       fields should not use ES_SBCS.
  339.  
  340.  
  341. ========================================================================
  342.  Support
  343. ========================================================================
  344.  
  345.  We'd like to hear from you!
  346.  
  347.  Please report any comments, suggestions, or problems through one of the
  348.  following channels:
  349.  
  350.    Internet:    apl2@vnet.ibm.com
  351.  
  352.    IBMMAIL:     USIB6JN8
  353.  
  354.    TALKLINK:    OS2bbs1; Qandabbs; TLpgcat
  355.  
  356.    FAX:         1-408-463-4488
  357.  
  358.    Phone:       1-408-463-APL2  (1-408-463-2752)
  359.  
  360.    Mail:        APL Products & Services
  361.                 IBM Santa Teresa Laboratory, RENA/F40
  362.                 555 Bailey Ave.
  363.                 San Jose, CA 95141
  364.  
  365.  
  366. ========================================================================
  367.  Trademarks
  368. ========================================================================
  369.  
  370.  The following terms are trademarks of the IBM Corporation.  They are
  371.  denoted by an asterisk (*) when they first appear in the text.
  372.  
  373.      APL2
  374.      IBM
  375.      OS/2
  376.      Presentation Manager
  377.  
  378.  The following terms are trademarks of other companies. They are
  379.  denoted by a double asterisk (**) when they first appear in the text.
  380.  
  381.      PostScript          Adobe Systems, Inc.
  382.      LaserJet            Hewlett-Packard, Inc.
  383.  
  384.