[perl-ldap-checkins] CVS: ldap/lib/Net/LDAP Search.pod,1.5,1.6

[Chris R. <chr...@us...>]

Update of /cvsroot/perl-ldap/ldap/lib/Net/LDAP
In directory sc8-pr-cvs1:/tmp/cvs-serv18169

Modified Files:
	Search.pod 
Log Message:
Updated documentation style.


Index: Search.pod
===================================================================
RCS file: /cvsroot/perl-ldap/ldap/lib/Net/LDAP/Search.pod,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- Search.pod	7 May 2003 11:17:06 -0000	1.5
+++ Search.pod	1 Aug 2003 16:34:42 -0000	1.6
@@ -4,35 +4,36 @@
 
 =head1 SYNOPSIS
 
-  use Net::LDAP;
+ use Net::LDAP;
 
-  $mesg = $ldap->search( @search_args );
+ $mesg = $ldap->search( @search_args );
 
-  @entries = $mesg->entries;
+ @entries = $mesg->entries;
 
 =head1 DESCRIPTION
 
 A B<Net::LDAP::Search> object is returned from the
-L<search|Net::LDAP/item_search> method of a L<Net::LDAP>
-object. It is a container object which holds the results of the search.
+L<search|Net::LDAP/item_search> method of a L<Net::LDAP> object. It is
+a container object which holds the results of the search.
 
 =head1 METHODS
 
-B<Net::LDAP::Search> inherits from L<Net::LDAP::Message>, and so supports
-all methods defined in L<Net::LDAP::Message>.
+B<Net::LDAP::Search> inherits from L<Net::LDAP::Message>, and so
+supports all methods defined in L<Net::LDAP::Message>.
 
 =over 4
 
-=item as_struct
+=item as_struct ( )
 
-Returns a reference to a HASH, where the keys are the DN's of the results
-and the values are HASH references. These second level HASH's hold the
-attributes such that the keys are the attribute names, in lowercase, and
-the values are references to and ARRAY holding the values.
+Returns a reference to a HASH, where the keys are the DNs of the
+results and the values are HASH references. These second level HASHes
+hold the attributes such that the keys are the attribute names, in
+lowercase, and the values are references to and ARRAY holding the
+values.
 
 This method will block until the whole search request has finished.
 
-=item count
+=item count ( )
 
 Returns the number of entries returned by the server.
 
@@ -42,45 +43,48 @@
 
 Return the N'th entry, which will be a L<Net::LDAP::Entry> object. If
 INDEX is greater than the total number of entries returned then
-undef will be returned.
+C<undef> will be returned.
 
 This method will block until the search request has returned enough
 entries.
 
-=item entries
+=item entries ( )
 
-Return an array of L<Net::LDAP::Entry> objects hat were returned from the
-server.
+Return an array of L<Net::LDAP::Entry> objects that were returned from
+the server.
 
 This method will block until the whole search request has finished.
 
-=item pop_entry
+=item pop_entry ( )
 
-Pop an entry from the internal list of L<Net::LDAP::Entry> objects for this
-search. If there are not more entries then undef is returned.
+Pop an entry from the internal list of L<Net::LDAP::Entry> objects for
+this search. If there are no more entries then C<undef> is returned.
 
-This call will block, if the list is empty, until the server returns
+This call will block if the list is empty, until the server returns
 another entry.
 
-=item references
+=item references ( )
 
-Return a list of references that the server returned. This will be a list
-of L<Net::LDAP::Reference> objects.
+Return a list of references that the server returned. This will be a
+list of L<Net::LDAP::Reference> objects.
 
-=item sorted ( [ ATTR_LIST ] )
+=item sorted ( )
 
-Return a list of L<Net::LDAP::Entry> objects,
-sorted by the attributes given in ATTR_LIST.  The attributes are
-compared in the order specified, each only being compared if all
-the prior attributes compare equal. If all the specified attributes
-compare equal then the DN is used to determine order.
+Return a list L<Net::LDAP:Entry> objects, sorted by their DNs.
 
-=item shift_entry
+=item sorted ( ATTR, ... )
 
-Shift an entry from the internal list of L<Net::LDAP::Entry> objects for this
-search. If there are not more entries then undef is returned.
+Return a list of L<Net::LDAP::Entry> objects, sorted by the specified
+attributes. The attributes are compared in the order specified, each
+only being compared if all the prior attributes compare equal.
 
-This call will block, if the list is empty, until the server returns
+=item shift_entry ( )
+
+Shift an entry from the internal list of L<Net::LDAP::Entry> objects
+for this search. If there are no more entries then C<undef> is
+returned.
+
+This call will block if the list is empty, until the server returns
 another entry.
 
 =back
@@ -94,21 +98,21 @@
 
 =head1 ACKNOWLEDGEMENTS
 
-This document is based on a document originally written by Russell Fulton
-E<lt>r.f...@au...E<gt>.
+This document is based on a document originally written by Russell
+Fulton E<lt>r.f...@au...E<gt>.
 
 =head1 AUTHOR
 
 Graham Barr E<lt>gb...@po...E<gt>
 
-Please report any bugs, or post any suggestions, to the perl-ldap mailing list
-E<lt>per...@pe...E<gt>.
+Please report any bugs, or post any suggestions, to the perl-ldap
+mailing list E<lt>per...@pe...E<gt>.
 
 =head1 COPYRIGHT
 
-Copyright (c) 1997-2000 Graham Barr. All rights reserved. This program is
-free software; you can redistribute it and/or modify it under the same
-terms as Perl itself.
+Copyright (c) 1997-2000 Graham Barr. All rights reserved. This program
+is free software; you can redistribute it and/or modify it under the
+same terms as Perl itself.
 
 =for html <hr>