This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
minor win32 scribbles
authorGurusamy Sarathy <gsar@engin.umich.edu>
Sat, 26 Jul 1997 06:56:48 +0000 (18:56 +1200)
committerTim Bunce <Tim.Bunce@ig.co.uk>
Wed, 6 Aug 1997 12:00:00 +0000 (00:00 +1200)
This patch updates the Config.pm templates to have more
reasonable entries.

Credited: Hugo van der Sanden <hv@crypt.compulink.co.uk>

p5p-msgid: 199707262307.TAA28410@aatma.engin.umich.edu

README.win32
pod/perldelta.pod
win32/Makefile
win32/config.bc
win32/config.vc
win32/makefile.mk

index 0cd070a..8e78e04 100644 (file)
@@ -24,7 +24,7 @@ found in the top-level directory where the Perl distribution
 was extracted.  Make sure you read and understand the terms under
 which this software is being distributed.
 
-Also make sure you read the L<BUGS AND CAVEATS> section below for the
+Also make sure you read L<BUGS AND CAVEATS> below for the
 known limitations of this port.
 
 The INSTALL file in the perl top-level has much information that is
@@ -290,7 +290,7 @@ This pipes "foo" to the pager and writes "bar" in the file "blurch":
     perl -e "print 'foo'; print STDERR 'bar'" 2> blurch | less
 
 
-Discovering the usage of the "command.com" shell on Windows95
+Discovering the usefullness of the "command.com" shell on Windows95
 is left as an exercise to the reader :)
 
 =item Building Extensions
@@ -337,7 +337,7 @@ all of the Activeware extensions and most other Win32 extensions from
 CPAN in source form, along with many added bugfixes, and with MakeMaker
 support.  This bundle is available at:
 
-   http://www.perl.com/CPAN/authors/id/GSAR/libwin32-0.07.tar.gz
+   http://www.perl.com/CPAN/authors/id/GSAR/libwin32-0.08.tar.gz
 
 See the README in that distribution for building and installation
 instructions.  Look for later versions that may be available at the
@@ -374,18 +374,20 @@ time because some details are still in flux and there may be
 changes in any of these areas: build process, installation structure,
 supported utilities/modules, and supported perl functionality.
 In particular, functionality specific to the Win32 environment may
-ultimately be supported as either core modules or extensions.  This
-means that you should be prepared to recompile extensions when binary
-incompatibilites arise due to changes in the internal structure of
-the code.
-
-The DLLs produced by the two supported compilers are incompatible
-with each other due to the conventions they use to export symbols,
-and due to differences in the Runtime libraries that they provide.
-This means that extension binaries built under either compiler will
-only work with the perl binaries built under the same compiler.
-If you know of a robust, freely available C Runtime that can
-be used under win32, let us know.
+ultimately be supported as either core modules or extensions.  The
+beta status implies, among other things, that you should be prepared
+to recompile extensions when binary incompatibilites arise due to
+changes in the internal structure of the code.
+
+An effort has been made to ensure that the DLLs produced by the two
+supported compilers are compatible with each other (despite the
+best efforts of the compiler vendors).  Extension binaries produced
+by one compiler should also coexist with a perl binary built by
+a different compiler.  In order to accomplish this, PERL.DLL provides
+a layer of runtime code that uses the C Runtime that perl was compiled
+with.  Extensions which include "perl.h" will transparently access
+the functions in this layer, thereby ensuring that both perl and
+extensions use the same runtime functions.
 
 If you have had prior exposure to Perl on Unix platforms, you will notice
 this port exhibits behavior different from what is documented.  Most of the
@@ -446,7 +448,12 @@ returned values or effects may be bogus.
 =item *
 
 Signal handling may not behave as on Unix platforms (where it
-doesn't exactly "behave", either :).
+doesn't exactly "behave", either :).  For instance, calling C<die()>
+or C<exit()> from signal handlers will cause an exception, since most
+implementations of C<signal()> on Win32 are severely crippled.
+Thus, signals may work only for simple things like setting a flag
+variable in the handler.  Using signals under this port should
+currently be considered unsupported.
 
 =item *
 
@@ -479,6 +486,8 @@ Nick Ing-Simmons E<lt>nick@ni-s.u-net.comE<gt>
 
 =back
 
+This document is maintained by Gurusamy Sarathy.
+
 =head1 SEE ALSO
 
 L<perl>
@@ -494,7 +503,7 @@ sundry hacks since then.
 
 Borland support was added in 5.004_01 (Gurusamy Sarathy).
 
-Last updated: 15 June 1997
+Last updated: 25 July 1997
 
 =cut
 
index 4c94482..bfa57c0 100644 (file)
@@ -705,7 +705,8 @@ Support for the following operating systems is new in Perl 5.004.
 
 Perl 5.004 now includes support for building a "native" perl under
 Windows NT, using the Microsoft Visual C++ compiler (versions 2.0
-and above).  The resulting perl can be used under Windows 95 (if it
+and above) or the Borland C++ compiler (versions 5.02 and above).
+The resulting perl can be used under Windows 95 (if it
 is installed in the same directory locations as it got installed
 in Windows NT).  This port includes support for perl extension
 building tools like L<MakeMaker> and L<h2xs>, so that many extensions
@@ -719,8 +720,6 @@ Cygwin32 is a set of GNU tools that make it possible to compile and run
 many UNIX programs under Windows NT by providing a mostly UNIX-like 
 interface for compilation and execution.  See L<README.cygwin32> for
 more details on this port, and how to obtain the Cygwin32 toolkit.
-This port has not been as well tested as the "native" port described
-above (which is not as well tested as we'd like either :)
 
 =head2 Plan 9
 
index 8c8b1ad..bc5ec50 100644 (file)
@@ -294,7 +294,7 @@ config.w32 : $(CFGSH_TMPL)
 ..\config.sh : config.w32 $(MINIPERL) config_sh.PL
        $(MINIPERL) -I..\lib config_sh.PL "INST_DRV=$(INST_DRV)" \
            "INST_TOP=$(INST_TOP)" "cc=$(CC)" "ccflags=$(RUNTIME) -DWIN32" \
-           "cf_email=$(EMAIL)" "libs=$(LIBFILES)" \
+           "cf_email=$(EMAIL)" "libs=$(LIBFILES)" "incpath=$(CCINCDIR)" \
            "libpth=$(CCLIBDIR)" "libc=$(LIBC)" \
            config.w32 > ..\config.sh
 
index 4b148de..ab3a429 100644 (file)
@@ -58,7 +58,7 @@ byacc='byacc'
 byteorder='1234'
 c=''
 castflags='0'
-cat='cat'
+cat='type'
 cccdlflags=''
 ccdlflags=' '
 cf_by='garyng'
@@ -68,10 +68,10 @@ chgrp=''
 chmod=''
 chown=''
 clocktype='clock_t'
-comm='comm'
+comm=''
 compress=''
 contains='grep'
-cp='cp'
+cp='copy'
 cpio=''
 cpp='cpp32'
 cpp_stuff='42'
@@ -371,13 +371,13 @@ line='line'
 lint=''
 lkflags=''
 ln=''
-lns=''
+lns='copy'
 locincpth='/usr/local/include /opt/local/include /usr/gnu/include /opt/gnu/include /usr/GNU/include /opt/GNU/include'
 loclibpth='/usr/local/lib /opt/local/lib /usr/gnu/lib /opt/gnu/lib /usr/GNU/lib /opt/GNU/lib'
 longsize='4'
 lp=''
 lpr=''
-ls='ls'
+ls='dir'
 lseektype='off_t'
 mail=''
 mailx=''
@@ -421,7 +421,7 @@ path_sep=';'
 perl='perl'
 perladmin=''
 perlpath='~INST_TOP~\bin\perl.exe'
-pg='pg'
+pg=''
 phostname='hostname'
 plibpth=''
 pmake=''
@@ -432,7 +432,7 @@ prototype='define'
 randbits='15'
 ranlib=''
 rd_nodata='-1'
-rm='rm'
+rm='del'
 rmail=''
 runnm='true'
 scriptdir='~INST_TOP~\bin'
@@ -459,7 +459,7 @@ sockethdr=''
 socketlib=''
 sort='sort'
 spackage='Perl5'
-spitshell='cat'
+spitshell=''
 split=''
 ssizetype='int'
 startperl='#perl'
@@ -474,11 +474,11 @@ sysman='/usr/man/man1'
 tail=''
 tar=''
 tbl=''
-test='test'
+test=''
 timeincl='/usr/include/sys/time.h '
 timetype='time_t'
 touch='touch'
-tr='tr'
+tr=''
 troff=''
 uidtype='uid_t'
 uname='uname'
index 0219969..7cc91da 100644 (file)
@@ -58,7 +58,7 @@ byacc='byacc'
 byteorder='1234'
 c=''
 castflags='0'
-cat='cat'
+cat='type'
 cccdlflags=''
 ccdlflags=' '
 cf_by='garyng'
@@ -68,10 +68,10 @@ chgrp=''
 chmod=''
 chown=''
 clocktype='clock_t'
-comm='comm'
+comm=''
 compress=''
 contains='grep'
-cp='cp'
+cp='copy'
 cpio=''
 cpp='cpp'
 cpp_stuff='42'
@@ -371,13 +371,13 @@ line='line'
 lint=''
 lkflags=''
 ln=''
-lns=''
+lns='copy'
 locincpth='/usr/local/include /opt/local/include /usr/gnu/include /opt/gnu/include /usr/GNU/include /opt/GNU/include'
 loclibpth='/usr/local/lib /opt/local/lib /usr/gnu/lib /opt/gnu/lib /usr/GNU/lib /opt/GNU/lib'
 longsize='4'
 lp=''
 lpr=''
-ls='ls'
+ls='dir'
 lseektype='off_t'
 mail=''
 mailx=''
@@ -421,7 +421,7 @@ path_sep=';'
 perl='perl'
 perladmin=''
 perlpath='~INST_TOP~\bin\perl.exe'
-pg='pg'
+pg=''
 phostname='hostname'
 plibpth=''
 pmake=''
@@ -432,7 +432,7 @@ prototype='define'
 randbits='15'
 ranlib=''
 rd_nodata='-1'
-rm='rm'
+rm='del'
 rmail=''
 runnm='true'
 scriptdir='~INST_TOP~\bin'
@@ -459,7 +459,7 @@ sockethdr=''
 socketlib=''
 sort='sort'
 spackage='Perl5'
-spitshell='cat'
+spitshell=''
 split=''
 ssizetype='int'
 startperl='#perl'
@@ -474,11 +474,11 @@ sysman='/usr/man/man1'
 tail=''
 tar=''
 tbl=''
-test='test'
+test=''
 timeincl='/usr/include/sys/time.h '
 timetype='time_t'
 touch='touch'
-tr='tr'
+tr=''
 troff=''
 uidtype='uid_t'
 uname='uname'
index b91fffc..5ee58bb 100644 (file)
@@ -367,7 +367,7 @@ config.w32 : $(CFGSH_TMPL)
 ..\config.sh : config.w32 $(MINIPERL) config_sh.PL
        $(MINIPERL) -I..\lib config_sh.PL "INST_DRV=$(INST_DRV)" \
            "INST_TOP=$(INST_TOP)" "cc=$(CC)" "ccflags=$(RUNTIME) -DWIN32" \
-           "cf_email=$(EMAIL)" "libs=$(LIBFILES:f)" \
+           "cf_email=$(EMAIL)" "libs=$(LIBFILES:f)" "incpath=$(CCINCDIR)" \
            "libpth=$(strip $(CCLIBDIR) $(LIBFILES:d))" "libc=$(LIBC)" \
            config.w32 > ..\config.sh