The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
Win32API::Const -- Win32 API Constants

LOCATION
--------
http://www.perl.com/CPAN/modules/by-module/Win32API/


SYNOPSIS
--------

Win32API::Const -- contains all of the Win32 constants, such as
WM_CLOSE, SW_SHOWMAXIMIZED, etc


SETUP
-----

You must have a compiler such as Borland or VC to compile and install
Win32API::Const. If you are using VC, during the installation it asked if you
wanted to register environment variables (default was off/unchecked). If you
did not turn this on, you must run vcvars32.bat to set up these variables.

In the following steps, $MAKE represents the name of your make utility. This
is "nmake" for VC. Borland users should download Gurusamy Sarathy's port of
dmake from http://www-personal.umich.edu/~gsar/.

1)  If you're using ActivePerl, you first need to fix one of its bugs. See below.

2)  Expand the .gz file (using, for example, WinZip) and its folders. Switch to
    the directory you expanded it into.

3)  perl Makefile.PL

4)  $MAKE

5)  $MAKE test
    (this step uses the English version of Notepad to test the modules. You can skip
	the test if you're installing on a foreign language OS, or overwrite notepad.exe
	with an English version).

6)  $MAKE install

Ta da! Them's the basic steps for installing any perl module.

To reinstall, run "$MAKE realclean", then skip back up to step #3.


ACTIVEPERL
----------

The Perl installation program (MakeMaker) uses Config.pm (located in one of
your Perl subdirs) to install Perl modules. Unfortunately, when ActivePerl is
installed, it does not set up Config.pm correctly.

To fix it:

1)   Find Config.pm. If you installed ActivePerl into C:\Perl (the default) it
     will be in "C:\Perl\5.00502\lib\MSWin32-x86-object\Config.pm".

2)   attrib -r Config.pm

3)   Open Config.pm in notepad.

4)   Change the "libpth=" line to include your lib dir for VC as well as the
     directory where ActivePerl installed perlcrt.lib to (by default,
	 "C:\Perl\5.00502\bin\MSWin32-x86-object")

	 For example, my "libpth=" line looks like this:

     libpth='C:\Perl\5.00502\bin\MSWin32-x86-object "C:\Program Files\dev\vs\VC98\Lib"'

	 Your libpth will *definitely* look different since I didn't install VC into
	 the default directory.

5)   The last item in the "libs=" line is perlcrt.lib, without a path. Put the
     full path on perlcrt.lib.

	 For example, my "libs=" line looks like this:

	 libs=' oldnames.lib kernel32.lib user32.lib gdi32.lib  winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib  oleaut32.lib netapi32.lib uuid.lib wsock32.lib mpr.lib winmm.lib  version.lib odbc32.lib odbccp32.lib C:\Perl\5.00502\bin\MSWin32-x86-object\perlcrt.lib'

Whew! That should work.


DOCUMENTATION
-------------

All the documentation is stored in the .pm files, in POD format. To view the documentation:

1)  Switch to the directory containing a .pm file, such as Const.pm.

2)  Run "pod2html Foo.pm > Foo.html" where Foo is the name of the module.

3)  View Foo.html in your web browser.


BUGS
----
Send bug reports to Brian Dellert: <aspider@pobox.com>


COPYRIGHT
---------
Copyright (c) 1998 Brian Dellert <aspider@pobox.com>,
<http://applespider.com>. All rights reserved.

Constants parsed from the egcs 1.1 header files Defines.h, Messages.h,
Errors.h, Base.h, & Sockets.h, which are licensed under the GNU
Library General Public License (LGPL).

Because the aforementioned header files are licensed under the GNU LGPL,
this module is also licensed under the GNU LGPL.

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Library General Public
License along with this library; see the file lgpl.license.txt.
If not, write to the Free Software Foundation,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.