
You are reading: RELEASE.TXT
----------------------------

-------------------------------
Version 5.001l, Release a
-------------------------------

Changes
-------
- none

Bugs Fixed
----------
- fixed problem with accept() when compiled with /D "USE_SOCKET_AS_HANDLES".

Known Issues
------------
- install script does not work under Windows 95. See "WIN95.TXT".
- See this section for previous release.

Known Bugs
----------
- No new bugs specific to the NT port.

~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-

-------------------------------
Version 5.001 Release
-------------------------------

Changes
-------
-none

Bugs Fixed
----------
- none

Known Issues
------------
- Unicode characters are not supported for extensions to the
  Windows NT Registry. Thanks to Dean Troyer at Honeywell for
  pointing this out.
- OCX's will not be supported in this version.
- Environment variables referenced through %ENV are case sensitive
  from Perl, but Windows NT is not. Environment variables need to be 
  accessed in the same case that they appear in the shell.
- the code to support the use of sockets as file handles (print to socket)
  is in the source code, but not compiled into the binary release.
  Defining USE_SOCKET_AS_HANDLES and recompiling will include this 
  functionality - note this will hang under Windows 95 because the
  osf* routines are not implemented in Windows 95 currently.

Known Bugs
----------
- getops: apparently this is a bug in the unix Perl distribution. There
  was some discussion on comp.lang.perl about getopts consistently dumping
  core on both HP/UX 10.0 and DEC OSF/1 3.2. This is not one that we will
  undertake to fix ourselves.

~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-

-------------------------------
Version 5.001 Release Candidate
-------------------------------

Changes
-------
- none

Bugs Fixed
----------
- use of COMSPEC to determine shell to run
- exec with redirection
- OLE Auto glitch in Word

Known Issues
------------
- OCX's will not be supported in this version.
- Environment variables referenced through %ENV are case sensitive
   from Perl, but Windows NT is not. Environment variables need to be 
   accessed in the same case that they appear in the shell.
- the code to support the use of sockets as file handles (print to socket)
   is in the source code, but not compiled into the binary release.
   Defining USE_SOCKET_AS_HANDLES and recompiling will include this 
   functionality - note this will hang under Windows 95 because the
   osf* routines are not implemented in Windows 95 currently.

Known Bugs
----------
- there have been reports that getopts does not work - we have not been able to 
   duplicate this bug

~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-


--------------------
Version 5.001 BETA 4
--------------------

Changes
-------

Bugs Fixed
----------
- apparently those who encountered problems with getopts.pl are no longer
having any trouble after upgrading to NT 3.51
- install script couldn't create 'bin' directory.
- refixed code that was broken by Clark Williams' patches to system/exec/``.

Known Issues
------------
- OCX's still not supported (in the works).

Known Bugs
----------
- OLE not quite as stable as we thought, 
- system() will not save exit status in $?, probably due to lack of fork() in
NT. Working on it.

~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-


--------------------
Version 5.001 BETA 3
--------------------

Changes
-------
- makefile for building Windows NT Perl using SDK
- most filenames shortened to 8.3 for ease of distribution
    OLE Extensions and library names are the main exceptions
- Multiple PROG_IDs handled in OLE Type Libraries
- added some OLE functions so that unregistered Dispatch Interfaces can be accessed
- revised NTOLE.htm to reflect above additions 
- included UN*X Distribution Unofficial Patches a-i

Bugs Fixed
----------
- _aspawn now preserves environment variables - op/magic.ntt test #1 now succeeds
        thanks to Clark Williams at Intergraph for fixing that bug
- fixed op/ref.ntt test to match UN*X test - op/reff.ntt tests all succeed 
        thanks to Wei-Yuen for introducing that bug ;-)

Known Issues
------------
- Perl OLE Extensions shipped with the kit have long filenames 
	must use 32 bit unzip or rename files
- Unregistered OLE Automation Dispatch Interfaces must be accessed with low level routines
- OCXes are not officially supported (we have not tested any)

Known Bugs
----------
- DDE Application error (causes GPF), after requiring and utilizing
getopts.pl. We have not been able to replicate the bug. 

~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-

--------------------
Version 5.001 BETA 2
--------------------
Things missing that should be in the next release:
--------------------------------------------------
- DispCalc sample application
- Example script for OLE Automation
- Test script for OLE Automation
- makefile for building Windows NT Perl using SDK

Changes
-------
- OLE Automation docs and extensions added
- OLE Extensions now perform late binding
- PerlGlob.mak and PerlGlob.c added to kit

Bugs Fixed
----------
- PerlGlob was not included in the first release - file globbing did not work
- EventLog functions fixed
- System sometimes executed twice

Known Issues
------------
- Aftermarket shells need to be compatible with cmd.exe

Known Bugs
----------
- test op/magic.ntt #1 fails - _aspawn does not preserve environment variables
- test op/ref.ntt #36 & #37 fail - ref bug - in UNIX Distribution

~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-
--------------------
Version 5.001 BETA 1
--------------------

Things missing that should be in the next release:

- OLE automation is not supported yet. Use at your own risk. You get to
keep both pieces if it breaks.

- Comprehensive documentation for the Windows Registry interface, OLE
Automation and Event Logging is not yet available, and will be released ASAP.

Differences between Windows NT Perl 5 and Intergraph Perl 4 for NT
------------------------------------------------------------------

The Windows NT Perl 5 interface to the registration database is essentially
the same as that implemented in Intergraph's port of Perl 4 to Windows
NT, with some minor semantic differences.
- All NT extensions to Perl 5 now begin with 'NT', e.g. RegDeleteKey in Perl
4 is now named NTRegDeleteKey.
- One does not need to invoke the routine with the preceeding ampersand (&),
since all routines are built directly into Perl 5.
- C macros now follow the usual h2ph convention  of being defined as perl
subroutines. E.g.:

 in Intergraph NT Perl 4
    $HKEY_CLASSES_ROOT = 0x80000000

 in Windows NT Perl 5
    sub HKEY_CLASSES_ROOT {( 0x80000000 );}

 To use the macros, one now types '&HKEY_CLASSES_ROOT' instead
 '$HKEY_CLASSES_ROOT'

Known Bugs
----------

- Sockets are supported in this release of Windows NT Perl 5, but as of
now they cannot be treated as normal UNIX file handles. You must use an
explicit send() or recv() on sockets, you cannot use print() or
printf() or the <> operators on sockets to perform I/O operations. This
will hopefully be corrected within the next release.

- modifying the %ENV hash does not affect the environment passed to
shell commands executed using the backtick (`) operator. Hopefully this
will be corrected in the next release.

- several functions that are not supported on NT do not spit out a
warning message, this requires changes to the Unix Distribution Perl
code. A mechanism for warning about use of unsupported functions during
compilation of a script is being explored.

- Compilation of perly.c generates a warning message on parameter lists.
This is a bug in the UNIX Distribution.

- References in OO - code sometimes fail. We haven't been able to
isolate the bug.

- This release of Windows NT Perl 5 is based on the Perl 5.001 UNIX Distribution.
There are several known bugs in this code - we will upgrade to 5.002 when it is 
available.
