
                        Net::SMS, version 1.00

Copyright (c) 2000 SimpleWire. All rights reserved. This program is free
software; you can redistribute it and/or modify it under the same terms
as Perl itself.

Written By: Joe Lauer <joelauer@simplewire.com>

For further documentation and support, please check out
www.simplewire.com


  Description
  -----------

    Net::SMS is a global short text messaging service interface via the
    Internet.  It brings you the first and only way to send SMS messages
    through one easy interface.  SimpleWire has defined an XML SMS standard
    and will make numerous tools available for developer's use so that SMS
    technology can be better utilized.  Currently, this interface supports
    more than just SMS enabled devices and can send messages to ANY
    protocol.

    The module hides all the difficulties of sending SMS messages and
    guarantees the same interface no matter what changes happen in the
    wireless market.

    Net::SMS is the perl interface to SimpleWire's expanding messaging
    network.  The module interacts with SimleWire's Remote Procedure Calls.
    The Remote Procedure Calls provide an XML API and the protocol is open to
    all developers.  For futher support or questions, you should visit
    SimpleWire's website at www.simplewire.com.  There you will find
    support and documentation including the white paper explaining the
    SimpleWire XML API.



  Dependencies
  ------------

    The following packages are required in order to run or even install
    Net::SMS.

      * LWP::UserAgent >= 5.47
      * XML::DOM (libxml-enno) >= 1.02
      * Net::Pager >= 2.00


  Features in 1.00
  ----------------

    .  Send messages to ANY wireless device

    .  Provides a consistent interface to wireless devices

    .  Removes the difficult part of interfacing to many different
       wireless providers and carriers.

    .  The SimpleWire network will maintain every service so that you
       don't have to.


  Archive Location
  ----------------

    .  The newest release/extensive help/faq/exaples on www.simplewire.com

    .  In the CPAN directory: modules/by-module/Net/

    .  To find a CPAN site near you see http://cpan.perl.org/SITES.html


  Prerequisites
  -------------

    .  Perl Version 5.002 or later

    .  A Windows 95/NT machine requires Perl version 5.003_07 or later



  Documentation
  -------------

    User documentation in POD format is contained within the module
    source (i.e. the .pm file).  Installing using "make install"
    places this documentation in a man page in the perl library under
    the directory "man/man3".  However, the best documentation is
    the example code in the /eg directory form the tar.gz file or
    on www.simplewire.com.


  Installation
  ------------

    These notes work on Unix based systems and there are some changes
    if you are using Windows NT/95/98.  See the special notes below.

	To install, cd to the directory containing the unpacked
    distribution and do one of the following:

	a.  Create a makefile by running Makefile.PL using the perl
        program into whose library you want to install and then run
        make three times:

            perl Makefile.PL
            make
            make test
            make install

    b.  To install into a private library, for example your home
        directory:

            perl Makefile.PL INSTALLSITELIB=$HOME/lib INSTALLMAN3DIR=$HOME/man
            make
            make test
            make pure_install

    c.  Alternatively, you can just copy or move Pager.pm
        from the distribution into a directory named Net/ in the Perl
        library.  You can then manually build the documentation using
        pod2man or pod2html.

    d.  At the time of printing this, there should be more ways to install
        Net::Pager.  Please go to www.simplewire.com and visit our
        Developers section for the easiest ways.  There should be a CPAN
        install and a ppm install.

    Windows NT/95/98 Installation
    -----------------------------
    
	Windows does not come with the make program.  Instead, you will have to
	use a similar program called 'nmake'.  If you have happened to install
    Microsoft's Visual Studio then 'nmake' is already installed on your
    computer and you can fun the following instructions.  If you don't have
    'nmake' then please visit
		
		http://www.simplewire.com/clienttools/perl.epl

    for instructions on how to get 'nmake'.

    Once you have 'nmake.exe' then you can replicate the instructions laid
    out in the previous a, b, and c subpoint above except replace the 'make'
    command with 'nmake'.  So (a) would be now

          perl Makefile.PL
          nmake
          nmake test
          nmake install


    Some Common Problems
    --------------------

    You most likely have to logged in as root on any machine to be able to
    successfully install either module.  If you cannot log in as root then
    follow choice c. above and just make a directory called Net where your
    programs will run and then copy Pager.pm into it.

    If you have any other questions please visit SimpleWire's FAQ or online
	support forum for anwers.

----------------------------------------------------------------------
SimpleWire
743 Beaubien
Suite 300
Detroit, MI 48226
313.961.4407

Released: 10/04/2000
Coded By: Joe Lauer <joelauer@simplewire.com>
