################################################################################

# File: ....................... INSTALL
# Original Author: ............ Jeff Nokes
# Last modified by: ........... Jeff Nokes
# Last modified: .............. 03/15/2007 @ 14:46

################################################################################

MODULE INSTALLATION

Method 1: The traditional Perl process of:

1.1 download module eBay-API-0.01.tar.gz from CPAN or eBay Developer Zone

(TBD: eBay Dev Zone URL)
1.2 cd to directory where tar.gz was downloaded 1.3 gzip -d eBay-API-0.01.tar.gz
1.4 tar -xvf eBay-API-0.01.tar
1.5 (recompress the tar: gzip --best eBay-API-0.01.tar) 1.6 cd to eBay-API-0.01

Determine all build options by:
1.7 perl Makefile.PL --help

1.8 perl Makefile.PL [options]
1.9 make
1.10 make test
1.11 make install

Notes: - If you provide the proper arguments to Makefile.PL, all tests

             during the `make test` phase should attempt to execute, otherwise
             some tests that require proper API credentials will skip, but
             return OK.

Method 2: Pull from a CPAN mirror archive

(Note: may not be available via CPAN yet)

2.1 perl -MCPAN -e shell
2.2 install eBay::API

Notes: - By using this method, you will not be able to provide the

             optional arguments to Makefile.PL, and thus the `make test` phase
             of the installation will skip any tests that require proper
             API credentials, but return OK.

NOTES

(N1) During the install process, the MAKEFILE.PL will attempt to autogenerate

all class data-types for you by default, unless you provide the

--noautogen

... switch at runtime.

(N2) If you would like a test API call during the intallation process, you must

provide the following options:

         --appid
         --devid
         --certid
         --authtoken

      ... otherwise the test API call step will be skipped.

(N3) The location for the latest eBay XML API xsd schema file is usually found

at

http://developer.ebay.com/webservices/latest/ebaySvc.xsd

(N4) If you choose not to autogenerate all of the classes at installation, or

      you are upgrading the classes to a more current schema version, you can
      do it manually at anytime, by following the directions outlined in the
      file

         <your lib dir>/eBay/API/XML/tools/codegen/xsd/README

(N5) You can generate HTML CPAN-style documentation for all of the provided

      and autogenerated POD documentation in this SDK.  Reference the following
      on how to do this.

         <your lib dir>/eBay/API/XML/tools/doc/README

EXAMPLES (Assuming a Bourne/Bash shell):

(E1) You want to autogenerate, and you want to test the API call.

         perl MAKEFILE.PL \
            PREFIX=/home/me/my_special_lib_dir \
            --appid='<your appid provided to you by eBay>' \
            --devid='<your devid provided to you by eBay>' \
            --certid='<your certid provided to you by eBay>' \
            --authtoken='<a current authtoken you've generated>'

      Note:  To generate an authtoken, you will need to use your eBay provided
             userid/password and the authentication token generator tool located
             at:
                http://www.developer.ebay.com/tokentool/

             ActiveState users may have to use doublequotes instead of single
             quotes around the option values.

(E2) You want to autogenerate, but do not want to test the API call.

(This is the default behavior of MAKEFILE.PL).

         perl MAKEFILE.PL \
            PREFIX=/home/me/my_special_lib_dir

(E3) You just want to install the core distribution files, and will autognerate

at a later time.

         perl MAKEFILE.PL \
            --noautogen

      Note:  Obviously, you cannot attempt a test API call without the
             auto-generated classes/data-types.