This is Mac::Serial.pm, an easy-to-use object-oriented Perl5 library for accessing the serial ports on the Macintosh.


INSTALLATION

To install this library, make an alias of the Serial.pm file and put it into the :site_perl:Mac folder in your MacPerl folder. You can also put the Serial v1.x folder in the site_perl folder for convenience but it is not required. Run the test program (master.t) located in the t folder to verify proper operation. If you elect to put the Serial.pm file anywhere else you may have to edit the LoadExternals line in it.


TESTED PLATFORMS

This library has been tested and found to work on 68k, PowerPC, and iMac Macintosh systems.


DOCUMENTATION

Documentation including detailed descriptions, known bugs, todo items, copyright, and author information can be found in the library itself using Shuck. Version information can be found in the file named 'changes'. A collection of examples demonstrating various features and techniques can be found (not surprisingly) in the examples folder.


VERSION HISTORY

version 1.007

- Used Serial objects as containers for intermediate varibles to reduce memory creep
- Eliminated break signal pulse control
- Revised master.t test to eliminate random behavior and test all ports
- Used MacPerl Environment Variable to help LoadExternals locate Mac::Serial.pm

version 1.006

- Fixed failure to MacBinarize in distribution creation process
- Added makefile.PL to support Chris Nandor's installme.plx script

version 1.005

- Changed name to Mac::Serial.pm.

version 1.004

- Made corrections to the documentation.

version 1.003

- Changed receive method to include termination character in a returned string.
- Miscellaneous changes to the example scripts.
- Made some methods good citizens by giving up some time to the OS in their loops.
- Cleared up some loose handles which caused erratic crashes.

version 1.002

- First distribution of OO interface module.


MANIFEST

ANNOUNCE
:examples:get_available_ports.pl
:examples:hello_world.pl
:examples:hello_world_quittable.pl
:examples:read_line.pl
MANIFEST
README
Serial.pm
:t:master.t