X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.netware;h=ac9a19e931b57565adff7773202fa325d5d849a5;hb=055bb491aa1c61403cb7de2ea930a89a362e1807;hp=2113e7ba0d855640fc186456e3e7b3823990e22b;hpb=2986a63f7e513cf37f46db9f211b77071260031f;p=p5sagit%2Fp5-mst-13.2.git
diff --git a/README.netware b/README.netware
index 2113e7b..ac9a19e 100644
--- a/README.netware
+++ b/README.netware
@@ -1,5 +1,6 @@
-This file is written in the POD format. If you are reading it thro'
-a text editor, ignore the words like =head1, =over etc.
+If you read this file _as_is_, just ignore the funny characters you
+see. It is written in the POD format (see pod/perlpod.pod) which is
+specifically designed to be readable as is.
=head1 Name
@@ -7,199 +8,62 @@ Perl for NetWare5.x
=head1 Description
-This file gives the instructions for building Perl5.6.1 for NetWare5.x.
-Please read and understand the terms under which this software is distributed.
-
+This file gives the instructions for building Perl5.6 and above for
+NetWare5.x. Please read and understand the terms under which this
+software is distributed.
=head1 Build
-This section describes the steps to be performed to build a Perl NLM and other associated
-NLMs.
+This section describes the steps to be performed to build a Perl NLM
+and other associated NLMs.
=head2 Tools & SDK
-The build requires Watcom 11.x compiler and linker. NetWare SDK, available at L, is required.
-Apart from NetWare SDK, "NLM & NetWare Libraries for C" and "NetWare Server Protocol Libraries for C"
-are also required. This is also available at the above mentioned site.
+The build requires Watcom 11.x compiler and linker. In addition,
+the "NetWare SDK", "NLM & NetWare Libraries for C" and
+"NetWare Server Protocol Libraries for C", all available at
+L, are also required.
Microsoft Visual C++ version 4.2 or later is also required.
-Currently the interpreter builds only with Watcom, we do have plans of making this work with
-CodeWarrior as well.
+Currently the interpreter builds only with Watcom and we do have plans of
+making this work with CodeWarrior as well.
=head2 Setup
-The build process is dependent on the location of the NetWare SDK. Once the required software
-is installed, the build environment has to be setup. The following batch files setup
-the environment.
-
-I - This sets the build type to release or debug.
-
-I - This sets the NetWare SDK path, Compiler & other tools path & MPK SDK path.
-
-I - This is required only it we are building multi-processor enabled NLMs.
-
-These batch files are under NetWare\bat folder. These batch files call a couple of other
-batch files to setup the environment. Invoking the batch file with I will show the
-current settings and I or I?> gives the usage help.
-
-=head2 Make
-
-The makefile is located under the NetWare folder. Type nmake at the WinNT command prompt.
-The make process runs only under WinNT shell. The makefile makes use of miniperl.exe to
-run some of the Perl scripts. Please run nmake from win32 folder which builds miniperl.exe before
-running nmake from NetWare folder. The build process can be stopped after miniperl.exe is created.
-
-Currently the follwing two build types are tested on NetWare
+The build process is dependent on the location of the NetWare SDK.
+Once the required software is installed, the build environment has to
+be setup. The following batch files setup the environment.
=over 4
-=item *
-
-USE_MULTI, USE_ITHREADS & USE_IMP_SYS defined
-
-=item *
-
-USE_MULTI & USE_IMP_SYS defined and USE_ITHREADS not defined
-
-=back
-
-=head2 Interpreter
-
-Once miniperl.exe creation is over, run nmake from the NetWare folder. This will build the
-Perl interpreter for NetWare as I. This is copied under the I folder if you
-are doing a release build else will be copied under I folder for debug builds.
-
-=head2 Extensions
-
-The make process also creates the Perl extensions which are called NLPs (NetWare Loadable Perl).
-
-=head1 Install
-
-Installing NetWare Perl on Windows doesn't make any sense. To install, type I. This
-will copy the binaries and module files to a NetWare server. The makefile, by default sets the
-drive letter to I which should be mapped to the I volume of a NetWare server. The Perl
-interpreter, I, is copied under I folder. Copy I to
-I folder. Before running I, make sure the NetWare server on which
-the files have to go is mapped to the drive letter I.
-
-=head1 Build new extensions
-
-To build extensions other than standard extensions, NetWare Perl has to be installed on Windows as well.
-This can be done by invoking I on the Windows NT command prompt. This will copy all
-the *.pm files and other required files. Documentation files are not copied. This has be done after
-installing Perl for Windows. Once this is done, to build any extension, do the following
+=item Buildtype.bat
-=over 4
-
-=item *
-perl -II -II Makefile.pl
+This sets the build type to release or debug.
-Ex: perl -Ic:/perl/5.6.1/lib/NetWare-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl
+=item SetNWBld.bat
-=item *
-nmake
+This sets the NetWare SDK path, Compiler & other tools path & MPK SDK path.
-=item *
-nmake install
+=item MPKBuild.bat
+This is required only it we are building multi-processor enabled NLMs.
-Install will copy the files into the Windows machine where NetWare Perl is installed, these files
-have to be copied to the NetWare server manually. Alternatively, pass I
-as an input to makefile.pl above. Where I is the mapped drive to the sys: volume of the
-server where Perl on NetWare is installed. Now saying I, will copy the files
-to the server.
-
+These batch files are under NetWare\bat folder. These batch files
+call a couple of other batch files to setup the environment. Invoking
+the batch file with I will show the current settings and I
+or I?> gives the usage help.
=back
-=head1 Known Issues
-
-=item *
-
-With USE_ITHREADS not defined, backtick seems to be having some problems.
-
-=item *
-
-The utility scripts (pod2html.pl, pod2man.pl, perldoc.pl etc.) are not yet ported to work on NetWare.
-
-=item *
-
-Also fork() is not currently implemented.
-
-=head1 Acknowledgements
-
-For the porting purpose, the PerlHost of Win32 port was used as reference and NetWare portions are
-added. Also the makefile for Win32 is used as a reference to create the makefile for NetWare build.
-Additionally the make process for NetWare port uses miniperl.exe to run scripts during the make and
-installation process.
-
-=head1 Author
-
-Guruprasad S (sguruprasad@novell.com)
-
-=head1 Date
-
-=over 4
-
-=item *
-
-Created - 18th Jan 2001
-
-=item *
-
-Modified - 16th April 2001
-
-=back
-This file is written in the POD format. If you are reading it thro'
-a text editor, ignore the words like =head1, =over etc.
-
-=head1 Name
-
-Perl for NetWare5.x
-
-=head1 Description
-
-This file gives the instructions for building Perl5.6.1 for NetWare5.x.
-Please read and understand the terms under which this software is distributed.
-
-
-=head1 Build
-
-This section describes the steps to be performed to build a Perl NLM and other associated
-NLMs.
-
-=head2 Tools & SDK
-
-The build requires Watcom 11.x compiler and linker. NetWare SDK, available at L, is required.
-Apart from NetWare SDK, "NLM & NetWare Libraries for C" and "NetWare Server Protocol Libraries for C"
-are also required. This is also available at the above mentioned site.
-Microsoft Visual C++ version 4.2 or later is also required.
-
-Currently the interpreter builds only with Watcom, we do have plans of making this work with
-CodeWarrior as well.
-
-=head2 Setup
-
-The build process is dependent on the location of the NetWare SDK. Once the required software
-is installed, the build environment has to be setup. The following batch files setup
-the environment.
-
-I - This sets the build type to release or debug.
-
-I - This sets the NetWare SDK path, Compiler & other tools path & MPK SDK path.
-
-I - This is required only it we are building multi-processor enabled NLMs.
-
-These batch files are under NetWare\bat folder. These batch files call a couple of other
-batch files to setup the environment. Invoking the batch file with I will show the
-current settings and I or I?> gives the usage help.
-
=head2 Make
-The makefile is located under the NetWare folder. Type nmake at the WinNT command prompt.
-The make process runs only under WinNT shell. The makefile makes use of miniperl.exe to
-run some of the Perl scripts. Please run nmake from win32 folder which builds miniperl.exe before
-running nmake from NetWare folder. The build process can be stopped after miniperl.exe is created.
+The make process runs only under WinNT shell.
+The NetWare makefile is located under the NetWare folder.
+The makefile for NetWare makes use of miniperl.exe to run some of
+the Perl scripts. To create miniperl.exe, run nmake from
+win32 folder through WinNT commond prompt. The build process
+can be stopped after miniperl.exe is created. Then run nmake
+from NetWare folder through WinNT command prompt.
Currently the follwing two build types are tested on NetWare
@@ -217,77 +81,91 @@ USE_MULTI & USE_IMP_SYS defined and USE_ITHREADS not defined
=head2 Interpreter
-Once miniperl.exe creation is over, run nmake from the NetWare folder. This will build the
-Perl interpreter for NetWare as I. This is copied under the I folder if you
-are doing a release build else will be copied under I folder for debug builds.
+Once miniperl.exe creation is over, run nmake from the NetWare folder.
+This will build the Perl interpreter for NetWare as I.
+This is copied under the I folder if you are doing
+a release build, else will be copied under I folder for debug builds.
=head2 Extensions
-The make process also creates the Perl extensions which are called NLPs (NetWare Loadable Perl).
+The make process also creates the Perl extensions which are called
+NLPs (NetWare Loadable Perl).
=head1 Install
-Installing NetWare Perl on Windows doesn't make any sense. To install, type I. This
-will copy the binaries and module files to a NetWare server. The makefile, by default sets the
-drive letter to I which should be mapped to the I volume of a NetWare server. The Perl
-interpreter, I, is copied under I folder. Copy I to
-I folder. Before running I, make sure the NetWare server on which
-the files have to go is mapped to the drive letter I.
+To install NetWare Perl onto a NetWare server, first map the Sys volume
+of a NetWare server to I. This is because the makefile by default
+sets the drive letter to I. Type I from NetWare folder
+on a WinNT command prompt. This will copy the binaries and module files
+onto the NetWare server. The Perl interpreter, I, is copied under
+I folder. Copy I to I folder.
=head1 Build new extensions
-To build extensions other than standard extensions, NetWare Perl has to be installed on Windows as well.
-This can be done by invoking I on the Windows NT command prompt. This will copy all
-the *.pm files and other required files. Documentation files are not copied. This has be done after
-installing Perl for Windows. Once this is done, to build any extension, do the following
+To build extensions other than standard extensions, NetWare Perl has
+to be installed on Windows as well. This can be done by invoking
+I from the NetWare folder on a WinNT command prompt.
+This will copy all the *.pm files and other required files.
+Documentation files are not copied. This has to be done after
+installing Perl for Windows. Once this is done, do the following
+to build any extension:
=over 4
=item *
+
perl -II -II Makefile.pl
-Ex: perl -Ic:/perl/5.6.1/lib/NetWare-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl
+For example:
+
+ perl -Ic:/perl/5.6.1/lib/NetWare-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl
=item *
+
nmake
=item *
-nmake install
+nmake install
-Install will copy the files into the Windows machine where NetWare Perl is installed, these files
-have to be copied to the NetWare server manually. Alternatively, pass I
-as an input to makefile.pl above. Where I is the mapped drive to the sys: volume of the
-server where Perl on NetWare is installed. Now saying I, will copy the files
-to the server.
-
+Install will copy the files into the Windows machine where NetWare
+Perl is installed, these files have to be copied to the NetWare server
+manually. Alternatively, pass I as an
+input to makefile.pl above. Where I is the mapped drive to the
+sys: volume of the server where Perl on NetWare is installed. Now
+saying I, will copy the files to the server.
=back
=head1 Known Issues
+=over 4
+
=item *
With USE_ITHREADS not defined, backtick seems to be having some problems.
=item *
-The utility scripts (pod2html.pl, pod2man.pl, perldoc.pl etc.) are not yet ported to work on NetWare.
+The utility scripts (pod2html.pl, pod2man.pl, perldoc.pl etc.) are not
+yet ported to work on NetWare.
=item *
Also fork() is not currently implemented.
+=back
+
=head1 Acknowledgements
-For the porting purpose, the PerlHost of Win32 port was used as reference and NetWare portions are
-added. Also the makefile for Win32 is used as a reference to create the makefile for NetWare build.
-Additionally the make process for NetWare port uses miniperl.exe to run scripts during the make and
-installation process.
+The makefile for Win32 is used as a reference to create the makefile
+for NetWare build. Also, the make process for NetWare port uses
+miniperl.exe to run scripts during the make and installation process.
-=head1 Author
+=head1 Authors
Guruprasad S (sguruprasad@novell.com)
+Anantha Kesari H Y (hyanantha@novell.com)
=head1 Date
@@ -299,6 +177,11 @@ Created - 18th Jan 2001
=item *
-Modified - 16th April 2001
+Modified - 25th June 2001
+
+=item *
+
+Modified - 13 July 2001
=back
+