services: services/perl/lib/AppSwitch Echo.pm Services.pm

[<app...@li...>]

jgsmith     01/07/20 07:45:24

  Added:       perl/lib/AppSwitch Echo.pm Services.pm
  Log:
  Initial documentation for general services and the echo service
  
  Revision  Changes    Path
  1.1                  services/perl/lib/AppSwitch/Echo.pm
  
  Index: Echo.pm
  ===================================================================
  package AppSwitch::Echo;
  
  our $VERSION = q(0.01);
  
  # $Id: Echo.pm,v 1.1 2001/07/20 14:45:24 jgsmith Exp $
  
  __END__
  
  =head1 NAME
  
  AppSwitch::Echo
  
  =head1 SYNOPSIS
  
    use AppSwitch::Echo::Client;
    use AppSwitch::Echo::Server;
  
  =head1 DESCRIPTION
  
  AppSwitch::Echo provides the client and service interfaces for 
  the C<echo> service.
  
  =head1 SERVICE DEFINITION
  
  The following methods are defined by the C<echo> service.
  
  =over 4
  
  =item echo.version
  
  This method requires no arguments and returns a string 
  representing the version of the interface supported by the 
  service.
  
  =item echo.echo
  
  This method returns the value of its single argument (C<content>).
  
  =back
  
  =head1 AUTHOR
  
  James Smith <jg...@ja...>
  
  =head1 SEE ALSO
  
  L<AppSwitch::Echo::Client>,
  L<AppSwitch::Echo::Server>
  
  =head1 COPYRIGHT
  
  Copyright (C) 2001  James Smith
  
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
  are met:
  
  1. Redistributions of source code must retain the above copyright 
  notice, this list of conditions and the following disclaimer.
  
  2. Redistributions in binary form must reproduce the above copyright 
  notice, this list of conditions and the following disclaimer in the 
  documentation and/or other materials provided with the distribution.
  
  3. Neither the name of the Project nor the names of its contributors 
  may be used to endorse or promote products derived from this 
  software without specific prior written permission.
  
  =cut
  
  
  
  1.1                  services/perl/lib/AppSwitch/Services.pm
  
  Index: Services.pm
  ===================================================================
  package AppSwitch::Services;
  
  our $VERSION = q(0.01);
  
  __END__
  
  =head1 NAME
  
  AppSwitch::Services
  
  =head1 DESCRIPTION
  
  The Perl modules distributed with this package provide easy to 
  use client and service provider interfaces for the full range of 
  Application Switch enabled services.
  
  A typical client use of a service is as follows.
  
    my $client = new AppSwitch::Echo::Client;
    print $client -> echo("A string");
  
  Each service has a well-defined interface independent of the 
  service provider.  This allows applications to work with any 
  service provider that the user selects in the Application Switch 
  daemon (L<AppSwitch::Daemon>).
  
  =head1 SERVICES
  
  See the documentation for each service for a full description of 
  the interface.
  
  =over 4
  
  =item echo
  
  This is an echo service provided by the AppSwitch::Echo packages.
  
  =back
  
  =head1 COPYRIGHT
  
  Copyright (C) 2001  James Smith
  
  Redistribution and use in source and binary forms, with or without
  modification, are permitted provided that the following conditions
  are met:
  
  1. Redistributions of source code must retain the above copyright 
  notice, this list of conditions and the following disclaimer.
  
  2. Redistributions in binary form must reproduce the above copyright 
  notice, this list of conditions and the following disclaimer in the 
  documentation and/or other materials provided with the distribution.
  
  3. Neither the name of the Project nor the names of its contributors 
  may be used to endorse or promote products derived from this 
  software without specific prior written permission.
  
  =cut