home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
apl2116.zip
/
apl2d1ga.zip
/
READ.ME
< prev
next >
Wrap
Text File
|
1999-11-05
|
16KB
|
384 lines
========================================================================
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.