home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IBM Presents OS/2 Software Hits 1995
/
OS-2_SW_HITS_2ND_EDITION_1995.ISO
/
i17
/
pmx20c3.exe
/
PMXC3.ZIP
/
DOC
/
PMXCSD.DOC
< prev
next >
Wrap
Text File
|
1995-01-05
|
27KB
|
666 lines
*************************************
*UN68122 CORRECTIVE SERVICE DISKETTE*
*************************************
This file contains instructions for installing this Corrective Service
Diskette (CSD), information on obtaining other CSDs, a summary of new
and changed functions for TCP/IP 2.0 for OS/2, and a list of APARs
that apply to this CSD.
This CSD is for the TCP/IP 2.0 for OS/2 X Window System Server Kit only.
---------------------------------------------------------------------------
1. Installing this Corrective Service Diskette (CSD)
a. Be sure you have installed the Base Kit CSD (UN56401) before
installing this CSD.
b. Installation of this Corrective Service Diskette replaces certain
files, which you may have modified. Before beginning installation,
you should back up the following files to save your modifications:
\tcpip\bin\xinit.cmd
\tcpip\x11\misc\fonts.ali
\tcpip\x11\75dpi\fonts.ali
c. To install this CSD from a diskette at your workstation, insert the
diskette into your A: drive and enter:
A:\TCPINST
Note: You must have at least 3.5 MB of free DASD space on the
disk partition containing the \tcpip tree to install the
new .xfn fonts.
d. If you have added fonts to either the tcpip\x11\misc or
\tcpip\x11\75dpi directories, you must move those fonts manually.
After installing the Corrective Service Diskette, the original
tcpip\X11\misc and tcpip\X11\75dpi directories are renamed to
tcpip\X11\miscPCF and tcpip\X11\75dpiPCF.
New tcpip\X11\misc and tcpip\X11\75dpi font directories are
installed during installation. The new directories contain
fonts in the .xfn (PMX OS/2 PM Private) format.
To avoid problems, we recommend that you install additional
PMX fonts in a directory other than tcpip\x11\misc or
tcpip\x11\75dpi. Always run MKFONTDR on each additional directory,
and add each directory to the PMX font path.
------------------------------------------------------------------------
2. Obtaining CSDs
--------------
This and future CSDs for this product may be obtained electronically
from the following sources:
From outside IBM, you can get CSDs:
1. From SOFTWARE.WATSON.IBM.COM by anonymous FTP.
The CSDs are located in the pub\tcpip\os2 directory.
2. From the NCSBBS bulletin board at 1-919-517-0001.
Set your modem settings to: none,8,1
From inside IBM, you can get CSDs:
1. From SOFTWARE.TCP.RALEIGH.IBM.COM by anonymous FTP.
The CSDs are located in the pub\os2\v20 directory.
2. From the OS2CSD disk.
3. By entering REQUEST PMX20CSD.PKG PACKAGE FROM OS2TCPIP AT RALVM12
*************************************************
*UN68122 CORRECTIVE SERVICE DISKETTE STARTS HERE*
*************************************************
------------------------------------------------------------------------
3. New and Changed Function in This CSD
3.1 New Presentation Manager (PM) Fonts Support Available in PMX
PMX can now use native PM fonts, which display text significantly
faster than .pcf fonts. Use the BDFTOPM or PCFTOPM utilities
to convert X Window Bitmap fonts to native PM Image (Bitmap) fonts.
Notes:
o Only PM Public Outline fonts can be scaled.
o PMX does not support double-byte character set (DBCS) PM fonts.
If a DBCS font must be used, continue to use the .pcf format.
o Public (Image and Outline) fonts, and Private (Image) fonts
in PMX format, are now supported.
3.2 Converting X Window Fonts to OS/2 PM Fonts
3.2.1 BDFTOPM Utility
Use the BDFTOPM utility to convert Bitmap Distribution
Format (BDF) fonts to Presentation Manager fonts.
The syntax of the BDFTOPM command is:
------
Syntax
>>──bdftopm── -o output_filename.xfn──filename────────────><
-o output_filename.xfn
Allows you to specify the name of the output file.
The .xfn extension is used to denote fonts converted from
X Window format.
filename
Specifies the name of the file containing the BDF font.
An example of the BDFTOPM command is:
bdftopm -o cursor.xfn cursor.bdf
Execute the MKFONTDR command after completing each
group of font conversions.
You can accept the default current directory as the target
directory that will be used to create the fonts.dir font
listing, or you can specify one yourself. The format for
the command is:
------
Syntax
┌─ current directory─┐
>>──mkfontdr──┼────────────────────┼──────────────────────><
│ ┌──────────┐ │
│ │ │
└── directory┴───────┘
directory
The name of the directory in which the fonts reside. This
will be used to create the fonts.dir font listing. The
default directory is your current directory.
The MKFONTDR utility will not permit the existence of the same
font in multiple formats in the same directory. For example,
font abcd.xfn and font abcd.pcf would not be permitted to reside
in the same directory. However, a font directory may contain a
variety of font formats, providing each font is unique.
3.2.2 PCFTOPM Utility
Use the PCFTOPM utility to convert Portable Compiled
Format (PCF) fonts to Presentation Manager fonts.
The syntax of the PCFTOPM command is:
------
Syntax
>>──pcftopm── -o output_filename.xfn──filename────────────><
-o output_filename.xfn
Allows you to specify the name of the output file.
The .xfn extension is used to denote fonts converted from
X Window format.
filename
Specifies the name of the file containing the PCF font.
An example of the PCFTOPM command is:
pcftopm -o cursor.xfn cursor.pcf
Execute the MKFONTDR command after completing each
group of font conversions.
You can accept the default current directory as the target
directory that will be used to create the fonts.dir font
listing, or you can specify one yourself. The format for
the command is:
------
Syntax
┌─ current directory─┐
>>──mkfontdr──┼────────────────────┼──────────────────────><
│ ┌──────────┐ │
│ │ │
└── directory┴───────┘
directory
The name of the directory in which the fonts reside. This
will be used to create the fonts.dir font listing. The
default directory is your current directory.
The MKFONTDR utility will not permit the existence of the same
font in multiple formats in the same directory. For example,
font abcd.xfn and font abcd.pcf would not be permitted to reside
in the same directory. However, a font directory may contain a
variety of font formats, providing each font is unique.
3.2.3 ALLFONTS Command
The ALLFONTS command is a REXX program that converts
fonts from .bdf or. pcf format to .xfn (OS/2 PM private)
format. The input directory is the current directory.
------
Syntax
┌─ -pcf─┐ ┌─ current dir──┐
>>──allfonts──┼───────┼──┼───────────────┼──┬─────┬────────>
└─ -bdf─┘ └─ -o directory─┘ └─ -m─┘
>──┬─────────┬────────────────────────────────────────────><
└─ -erase─┘
-bdf
Converts all *.bdf files to .xfn format. The default is to
convert all *.pcf files to .xfn format.
-o directory
Specifies the target, or output, directory to be used. The
default directory is the current directory.
-m
Executes the MKFONTDR command in the target, or output,
directory.
NOTE: When -m is specified, only one font format may exist
in the same directory. Move or rename the files in the
output directory before executing the MKFONTDR command, or
specify the -erase parameter.
-erase
Searches the output directory for file names with multiple
font formats. If .pcf and .xfn font files with identical
file names are found, the .pcf files are deleted.
3.3 PM Public and Private Fonts
There is a clear distinction between OS/2 PM public and private
fonts:
o OS/2 PM Public Fonts - These fonts can be used by any
process in the system, use system
resources, and are usually loaded at
startup time and cannot be deleted
until after system shutdown.
OS/2 public fonts can
be in either Image or Outline format.
o OS/2 PM Private Fonts - These fonts are loaded by a specific
process, and can be used only
by that process. OS/2 private fonts
are in Image format.
PMX private fonts are created using the
BDFTOPM or PCFTOPM utilities, each
generating font files with .xfn
extensions. However, by renaming
the extension from .xfn to .fon, you can
install the resulting .fon font file as
a PM Public font using the Font Palette
application.
If there are other OS/2 PM .fon
private fonts that you want to make
available to PMX, install them as OS/2
public fonts, and specify pmpublic\ on
the PMX font path.
3.4 MKFONTDR command
o The -pmpublic parameter of the MKFONTDR command creates a new
fonts.dir file in the directory pointed to by the ETC environment
variable. The fonts.dir file lists all of the PM Public fonts
currently installed in PM.
o You must issue the MKFONTDR command with the -pmpublic parameter
separately from the MKFONTDR command's directory parameter.
o The syntax of the MKFONTDR command, using the -pmpublic parameter,
is:
------
Syntax
>>──mkfontdr── -pmpublic──────────────────────────────────><
-pmpublic
Creates a new fonts.dir file in the directory pointed to by
the ETC environment variable.
3.5 Backing Store
Backing store, a feature designed to significantly reduce network
traffic, is now supported.
3.6 Installation Notes
o The current PMX font directories, containing .pcf formatted fonts,
will automatically be saved and renamed to \tcpip\x11\miscPCF
and \tcpip\x11\75dpiPCF. You can use erasePCF to delete these two
subdirectories in order to reclaim space taken up by backed-up
.pcf fonts.
Because erasePCF is a REXX program, be sure you have REXX
support installed before running erasePCF.cmd.
o \tcpip\x11\misc and \tcpip\x11\75dpi will contain the new
.xfn formatted PM fonts.
o Listed below are Japanese and Korean DBCS .pcf fonts. If they are
found, they will be moved to the new \tcpip\x11\misc directory.
- jiskan16.pcf
- jiskan24.pcf
- k14.pcf
- hanglg16.pcf
- hanglm16.pcf
- hanglm24.pcf
All other DBCS .pcf fonts will not be detected or moved.
o User fonts are not moved. It is suggested that you convert these
fonts to .xfn format, and add the appropriate directory or
directories to the PMX font path.
These fonts may be re-installed in either of two ways:
o Copy the additional .pcf fonts:
md \tcpip\x11\pvtfonts
cd \tcpip\x11\pvtfonts
copy \tcpip\x11\miscPCF\private1.pcf
copy \tcpip\x11\miscPCF\private2.pcf
mkfontdr
o Convert the additional .pcf fonts to .xfn format:
md \tcpip\x11\pvtfonts
cd \tcpip\x11\pvtfonts
pcftopm -o private1.xfn \tcpip\x11\miscPCF\private1.pcf
pcftopm -o private2.xfn \tcpip\x11\miscPCF\private2.pcf
mkfontdr
o To restore the \tcpip\x11\miscPCF and \tcpip\x11\75dpiPCF
directories to \tcpip\x11\misc and \tcpip\x11\75dpi, respectively,
run resetPCF.cmd, which is an OS/2 REXX program. (Japanese and
Korean DBCS fonts, if present, will be moved.)
o pmpublic\ is not added to the PMX font path at CSD install time.
If PM Public font support is to be enabled, add pmpublic\ to
the font path.
o PM does not support the font code page ISO8859-1. However,
because PM does support code page 850, PMX translates all
ISO8859-1 strings to code page 850 strings.
o Problems have been found with SVGA and ImageAdapter
PM device drivers when using Type 3 PM fonts. This CSD is
shipped with a temporary workaround that enables the Type 3
fonts to work by treating those PM fonts as if they were .pcf
fonts. However, you will not experience improved text performance
using Type 3 PM fonts with these device drivers.
A permanent resolution is currently in process; it will
considerably speed up text performance.
Type 1 (fixed-width) PM fonts perform as expected on all PM
device drivers. As a result, all AIXterm windows will display
faster on all platforms.
All PM fonts work as designed on XGA, S3, and 8514 PM device
drivers.
3.7 New Font Server Utilities Support
3.7.1 FSINFO Utility
The FSINFO command executes a utility for
displaying information about an X font server.
Use this command to examine the:
o Capabilities of a particular server
o Predefined values for various parameters
used in client/server communications
o Font catalogs and availability of alternate servers
------
Syntax
>>──fsinfo── -server server_name──────────────────────────><
-server server_name
Specifies a particular font server. The server_name usually
has the format transport/host:port.
The default port number for most font servers (X11R5) is
7000. AIX font servers use port number 7500 as the default.
An example of the FSINFO command is:
-server tcp/aixhost:7500
NOTE: If you do not specify server_name, then you must connect
to the default font server by defining the FONTSERVER
environment variable.
3.7.2 FSLSFNTS Utility
The FSLSFNTS command lists the fonts from a
font server that match a given pattern.
NOTE: The wildcard character "*" may be used
to match any sequence of characters (including none),
and "?" may be used to match any single character.
If no pattern is specified, "*" is assumed.
You may need to enclose the "*" and "?" wildcard
characters in double quotes to prevent them from being
expanded by the shell.
------
Syntax
>>──fslsfnts──┬─────┬──┬─────┬──┬───────┬──┬─────┬─────────>
└─ -1─┘ └─ -C─┘ ├─ -l───┤ └─ -m─┘
├─ -ll──┤
└─ -lll─┘
>──┬─────────────┬──┬──────────────────────┬──┬─────┬──────>
└─ -n columns─┘ └─ -server server_name─┘ └─ -u─┘
┌─ 79───────┐
>──┼───────────┼── -fn pattern────────────────────────────><
└─ -w width─┘
-1 Specifies that listings should use a single column.
This is the same as -n 1.
-C Specifies that listings should use multiple columns.
This is the same as -n 0.
-l Specifies that medium-length listings should be generated
for each font.
-ll Specifies that long listings should be generated for each font.
-lll
Specifies that very long listings should be generated for
each font.
-m Specifies that long listings (-ll) should also print the
minimum and maximum bounds of each font.
-n columns
Specifies the number of columns to use in displaying the
output. If you don't specify the number of columns, the
utility will fit the maximum number of columns into the space
specified by the -w width.
-server server_name
Specifies a particular font server. The server_name usually
has the format transport/host:port.
The default port number for most font servers (X11R5) is
7000. AIX font servers use port number 7500 as the default.
An example of the FSLSFNTS command is:
-server tcp/aixhost:7500
NOTE: If you do not specify server_name, then you must
connect to the default font server by defining the
FONTSERVER environment variable.
-u Specifies that the output should be left unsorted.
-w width
Specifies the width (in characters) of the output.
The default is 79.
-fn pattern
Lists only those fonts matching the given pattern.
3.7.3 FSTOBDF Utility
The FSTOBDF command converts a font server font to
.bdf format. This command is useful for testing
servers, debugging font metrics, and reproducing lost
BDF files.
By default, output is written to stdout and displayed
on your screen. If you wish to save the output, redirect
stdout to a file. Include the .bdf filename extension.
Once you have converted the font server font to BDF
format, compile it using either:
o The BDFTOPM command to create
an .xfn PMX Private PM font format
o The BDFTOPCF command to create a .pcf font format
After converting to either .xfn or .pcf format,
issue the MKFONTDR command in the directory containing
the compiled font. Be sure to specify that directory
in the PMX font path.
------
Syntax
>>──fstobdf── -fn fontname -server server_name────────────><
-fn fontname
Specifies the font for which a BDF file should be generated.
-server server_name
Specifies a particular font server. The server_name usually has
the format transport/host:port.
The default port number for most font servers (X11R5) is
7000. AIX font servers use port number 7500 as the default.
An example of the FSTOBDF command is:
fstobdf -fn fixed -server tcp/aixhost:7500 >fsfixed.bdf
NOTE: If you do not specify server_name, then you must connect
to the default font server by defining the FONTSERVER
environment variable.
3.8 Server Resetting
Resetting the server is now supported, both by the standard X
protocol functions, and by a menu item. This causes all X
applications to be closed, without shutting down the server.
Normally when all X applications have disconnected, PMX will not
reset automatically. Instead it retains various properties and
atoms that normally would be deleted at that time. This is not the
standard X server behavior. If you need to have the standard X
server behavior in this situation, you may either do a reset server
manually from the command menu, or you may have it done
automatically by including "-resetpmx" (without the quotes) on the
PMX or XINIT command line.
-------------------------------------------------------------------------
4. APARs Fixed in This CSD
The following is a list of APARs fixed since this release became
available. APARs are listed numerically by CSD.
+==========+=============+============================================+
| | MODULE(S) | |
| APAR | AFFECTED | DESCRIPTION |
+==========+=============+============================================+
|>>>>>>>>>>>>>>>>>>>>>>>>>> CSD UN68122 <<<<<<<<<<<<<<<<<<<<<<<<<<|
+----------+-------------+--------------------------------------------+
| PN63135 | BIN\PMX.EXE | Fixed: Backing store was not supported. |
| | | OS/2 native fonts were not supported. |
+----------+-------------+--------------------------------------------+
| PN63893 | BIN\PMX.EXE | Fixed: PMX keyboard flag -k 124 was |
| | | documented, but not implemented |
+----------+-------------+--------------------------------------------+
|>>>>>>>>>>>>>>>>>>>>>>>>>> CSD UN60006 <<<<<<<<<<<<<<<<<<<<<<<<<<|
+----------+-------------+--------------------------------------------+
| PN51433 | BIN\PMX.EXE | Fixed: PMX sometimes loops when moving |
| | | across cascading windows |
+----------+-------------+--------------------------------------------+
| PN52079 | BIN\PMX.EXE | Fixed: Cannot find Courier12 and higher |
| | | fonts when running x-appl |
+----------+-------------+--------------------------------------------+
| PN53814 | BIN\PMX.EXE | Fixed: PMX windows do not behave properly |
| | | for initially iconified window or when |
| | | setting keyboard focus |
+----------+-------------+--------------------------------------------+
| PN57688 | BIN\PMX.EXE | Fixed: Focus control changed when moving |
| | | X application |
+----------+-------------+--------------------------------------------+
|>>>>>>>>>>>>>>>>>>>>>>>>>> CSD UN52841 <<<<<<<<<<<<<<<<<<<<<<<<<<|
+----------+-------------+--------------------------------------------+
| PN38405 | BIN\PMX.EXE | Fixed: Horizontal lines are not initially |
| | | displayed correctly when using Autocad V11 |
+----------+-------------+--------------------------------------------+
| PN46715 | BIN\PMX.EXE | Fixed: PMX server did not display fonts |
| | | correctly on ET4000 display (same as |
| | | PN47310) |
+----------+-------------+--------------------------------------------+
| PN47197 | BIN\PMX.EXE | Fixed: The capslock and numlock keys |
| | | interfered with each other |
+----------+-------------+--------------------------------------------+
| PN47310 | BIN\PMX.EXE | Fixed: PMX fonts are not displayed |
| | | correctly on an SVGA display (same as |
| | | PN46715) |
+----------+-------------+--------------------------------------------+
| PN48388 | BIN\PMX.EXE | Fixed: Cannot store color choices in |
| | | notebook |
+----------+-------------+--------------------------------------------+
| PN48389 | BIN\PMX.EXE | Fixed: XLSFONTS <enter> returns "error 0" |
| | | message |
+----------+-------------+--------------------------------------------+
| PN49138 | BIN\PMX.EXE | Fixed: Cut/paste on PMX and Motif demos |
| | | did not work properly |
+----------+-------------+--------------------------------------------+
5. Acknowledgements
This CSD incorporates compression code by the Info-ZIP group.
There are no extra charges or costs due to the use of this
code, and the original compression sources are freely available
from Compuserve in the OS2USER forum and by anonymous ftp from
the Internet site ftp.uu.net:/pub/archiving/zip.