mirror of
https://github.com/KevinMidboe/linguist.git
synced 2025-10-29 09:40:21 +00:00
160 lines
4.4 KiB
Plaintext
160 lines
4.4 KiB
Plaintext
$Id: contents.pod,v 1.3 2003/05/04 04:05:14 tower Exp $
|
|
|
|
=begin html
|
|
|
|
<style = "text/css">
|
|
code { font-family: sans-serif; font-weight:bold; }
|
|
</style>
|
|
|
|
=end html
|
|
|
|
=head1 Net::Z3950::AsyncZ
|
|
|
|
=head2 Intro
|
|
|
|
Net::Z3950::AsyncZ adds an additional layer of asynchronous support for the Z3950 module through the use
|
|
of multiple forked processes. I hope that users will also find that it provides a convenient
|
|
front end to C<Net::Z3950>. My initial idea was to write something that
|
|
would provide a convenient means of processing and formatting Z39.50 records--which I
|
|
did, using the C<Z3950> synchronous code. But I also wanted something that could
|
|
handle queries to large numbers of servers at one session. Working on this part of my
|
|
project, I found that I had trouble with the C<Z3950> asynchronous features
|
|
and so ended up with what I have here.
|
|
|
|
=begin html
|
|
|
|
I give a more detailed account in the <A href="AsyncZ.html#apologia"><B>DESCRIPTION</b></a>
|
|
section of <code>AsyncZ.html</code>.
|
|
|
|
=end html
|
|
|
|
=pod
|
|
|
|
I give a more detailed account in in the B<DESCRIPTION> section of C<AsyncZ.pod>.
|
|
|
|
=cut
|
|
|
|
=head2 Documentation
|
|
|
|
=pod
|
|
|
|
=over 4
|
|
|
|
=item AsyncZ.pod
|
|
|
|
This is the starting point--it gives an overview of the AsyncZ module,
|
|
describes the basic mechanics of its asynchronous workings, and details
|
|
the particulars of the objects and methods. But see
|
|
L</"Examples.pod> for detailed explanations of the sample
|
|
scripts which come with the C<Net::Z3950::AsyncZ> distribution.
|
|
|
|
=item Options.pod
|
|
|
|
This document details the various options that can be set to modify
|
|
the behavior of AsyncZ Index
|
|
|
|
=item Report.pod
|
|
|
|
Report.pod deals with how records are treated line by line
|
|
and how you can affect the apearance of a record's line by line output
|
|
|
|
=item Examples.pod
|
|
|
|
This document goes through the sample scripts that come with the
|
|
C<Net::Z3950::AsyncZ> distribution and annotates them
|
|
in a line-by-line fashion. It's a basic HOW-TO.
|
|
|
|
=back
|
|
|
|
=cut
|
|
|
|
=begin html
|
|
|
|
<UL>
|
|
<LI>
|
|
<A href="AsyncZ.html">AsyncZ.html</a>
|
|
<br>This is the starting point--it gives an overview of the AsyncZ module,
|
|
describes the basic mechanics of its asynchronous workings, and details
|
|
the particulars of the objects and methods. But see
|
|
<a href="#examples">Examples</a> for detailed explanations of the sample
|
|
scripts which come with the <code>Net::Z3950::AsyncZ</code> distribution.
|
|
|
|
<LI>
|
|
<A href="Options.html">Options.html</a>
|
|
<br> This document details the various options that can be set to modify
|
|
the behavior of <code>AsyncZ</code>
|
|
|
|
<LI>
|
|
<A href="Report.html">Report.html</a>
|
|
<br><Code>Report.html</code> deals with how records are treated line by line
|
|
and how you can affect the apearance of a record's line by line output
|
|
|
|
<LI><A name = "examples"></a>
|
|
<A href="Examples.html">Examples.html</a>
|
|
This document goes through the sample scripts that come with the
|
|
<code>Net::Z3950::AsyncZ</code> distribution and annotates them
|
|
in a line-by-line fashion. It's a basic HOW-TO.
|
|
|
|
</UL>
|
|
|
|
=end html
|
|
|
|
=head2 The Modules
|
|
|
|
=pod
|
|
|
|
There are more modules than there is documentation. The reason for this
|
|
is that the only module you have full and complete access to is
|
|
C<Net::Z3950::AsyncZ>. The other modules are either internal to C<Net::AsyncZ>
|
|
or accessed indirectly or in part indirectly.
|
|
|
|
=cut
|
|
|
|
=for html
|
|
There are more modules than there is documentation. The reason for this
|
|
is that the only module you have full and complete access to is
|
|
<code>Net::Z3950::AsyncZ</code>. The other modules are either internal to <code>Net::AsyncZ</code>
|
|
or accessed indirectly or in part indirectly.
|
|
|
|
=head3 Here are the modules:
|
|
|
|
=over 4
|
|
|
|
=item Net::Z3950::AsyncZ
|
|
|
|
The main module: direct access --documented in
|
|
C<AsyncZ> and C<Options> documentation
|
|
|
|
=item Net::Z3950::AsyncZ::ErrMsg
|
|
|
|
User error message handling: indirect access -- documented in
|
|
C<AsyncZ> documentation
|
|
|
|
=item Net::Z3950::AsyncZ::Errors
|
|
|
|
Error handling for debugging: limited access -- documented in
|
|
C<AsyncZ> documentation
|
|
|
|
=item Net::Z3950::AsyncZ::Report
|
|
|
|
Module reponsible for fetching and formatting records: limited access -- documented
|
|
|
|
=item Net::Z3950::AsyncZ::ZLoop
|
|
|
|
Event loop for child processes: no access -- not documented
|
|
|
|
=item Net::Z3950::AsyncZ::ZSend
|
|
|
|
Connection details for child processes: no access -- not documented
|
|
|
|
=item Net::Z3950::AsyncZ::Options::_params
|
|
|
|
Options for child processes: direct and indirect access -- documented
|
|
in C<Options> and C<AsyncZ> documentation
|
|
|
|
=back
|
|
|
|
=head1 INDEX
|
|
|
|
|