formatting and pod fixes

lib/Rethinkdb.pm

@@ -214,12 +214,12 @@ sub random {
   if ( ref $args->[2] eq 'HASH' ) {
     $optargs = $args->[2];
   }
-  elsif( scalar @{$args} > 2 and $args->[2] ) {
+  elsif ( scalar @{$args} > 2 and $args->[2] ) {
     $optargs->{float} = r->true;
   }
 
   # only keep the first two elements
-  $args = [splice @{$args}, 0, 2];
+  $args = [ splice @{$args}, 0, 2 ];
 
   my $q = Rethinkdb::Query->new(
     _type   => $self->term->termType->random,
@@ -947,7 +947,7 @@ L</wednesday> is a literal day of the week for comparisions.
     r->row('birthdate')->day_of_week()->eq(r->thursday)
   )->run;
 
-L<thursday> is a literal day of the week for comparisions.
+L</thursday> is a literal day of the week for comparisions.
 
 =head2 friday
 
@@ -1177,29 +1177,30 @@ Specifies that a column should be ordered in descending order.
 
   r->wait->run;
 
-Wait on all the tables in the default database (set with the L<connect>
+Wait on all the tables in the default database (set with the L</connect>
 command's C<db> parameter, which defaults to C<test>). A table may be
 temporarily unavailable after creation, rebalancing or reconfiguring. The
-L<wait> command blocks until the given all the tables in database is fully up
+L</wait> command blocks until the given all the tables in database is fully up
 to date.
 
 =head2 minval
 
   r->table('marvel')->between( r->minval, 7 )->run;
 
-The special constants L<minval> is used for specifying a boundary, which
-represent "less than any index key". For instance, if you use L<minval> as the
-lower key, then L<Table/between> will return all documents whose primary keys
-(or indexes) are less than the specified upper key.
+The special constants L</minval> is used for specifying a boundary, which
+represent "less than any index key". For instance, if you use L</minval> as the
+lower key, then L<Rethinkdb::Query::Table/between> will return all documents
+whose primary keys (or indexes) are less than the specified upper key.
 
 =head2 maxval
 
   r->table('marvel')->between( 8, r->maxval )->run;
 
-The special constants L<maxval> is used for specifying a boundary, which
-represent "greater than any index key". For instance, if you use L<maxval> as
-the upper key, then L<Table/between> will return all documents whose primary
-keys (or indexes) are greater than the specified lower key.
+The special constants L</maxval> is used for specifying a boundary, which
+represent "greater than any index key". For instance, if you use L</maxval> as
+the upper key, then L<Rethinkdb::Query::Table/between> will return all
+documents whose primary keys (or indexes) are greater than the specified lower
+key.
 
 =head2 true
 

lib/Rethinkdb/IO.pm

@@ -224,7 +224,7 @@ sub _clean {
   }
   elsif ( ref $data eq 'HASH' ) {
     foreach ( keys %{$data} ) {
-      $data->{$_} = $self->_real_cleaner($data->{$_});
+      $data->{$_} = $self->_real_cleaner( $data->{$_} );
     }
 
     return $data;

lib/Rethinkdb/Query.pm

@@ -1387,8 +1387,8 @@ field's value exists in the specified index on the right-hand side.
   r->table('marvel')->eq_join('main_dc_collaborator',
     r->table('dc'))->zip()->run;
 
-Used to I<zip> up the result of a join by merging the I<right> fields into
-I<left> fields of each member of the sequence.
+Used to zip up the result of a join by merging the right fields into
+left fields of each member of the sequence.
 
 =head2 map
 
@@ -1720,10 +1720,10 @@ with the fields:
 Splits a string into substrings. Splits on whitespace when called with no
 arguments. When called with a separator, splits on that separator. When called
 with a separator and a maximum number of splits, splits on that separator at
-most C<max_splits> times. (Can be called with None as the separator if you want
-to split on whitespace while still specifying C<max_splits>.)
+most C<max_splits> times. (Can be called with C<undef> as the separator if you
+want to split on whitespace while still specifying C<max_splits>.)
 
-Mimics the behavior of Python's string.split in edge cases, except for
+Mimics the behavior of Python's C<string.split> in edge cases, except for
 splitting on the empty string, which instead produces an array of
 single-character strings.
 

lib/Rethinkdb/Query/Database.pm

@@ -276,6 +276,6 @@ Reconfigure all table's sharding and replication.
 
 Wait for all the tables in a database to be ready. A table may be
 temporarily unavailable after creation, rebalancing or reconfiguring.
-The L<wait> command blocks until the given database is fully up to date.
+The L</wait> command blocks until the given database is fully up to date.
 
 =cut

lib/Rethinkdb/Query/Table.pm

@@ -483,7 +483,7 @@ information about the table's shards, replicas and replica readiness states
   r->table('marvel')->wait->run;
 
 Wait for a table to be ready. A table may be temporarily unavailable
-after creation, rebalancing or reconfiguring. The L<wait> command
+after creation, rebalancing or reconfiguring. The L</wait> command
 blocks until the given table is fully up to date.
 
 =cut