--- Convert-UUlib/UUlib.pm 2020/02/27 04:24:13 1.45 +++ Convert-UUlib/UUlib.pm 2020/02/28 06:57:25 1.46 @@ -216,7 +216,7 @@ On my machine, a fairly complete decode with DBI backend needs about 10MB RSS to decode 20000 files. -=over 4 +=over =item Initialize @@ -231,7 +231,7 @@ =head2 Setting and querying options -=over 4 +=over =item $option = GetOption OPT_xxx @@ -243,7 +243,7 @@ =head2 Setting various callbacks -=over 4 +=over =item SetMsgCallback [callback-function] @@ -257,7 +257,7 @@ =head2 Call the currently selected FNameFilter -=over 4 +=over =item $file = FNameFilter $file @@ -265,7 +265,7 @@ =head2 Loading sourcefiles, optionally fuzzy merge and start decoding -=over 4 +=over =item ($retval, $count) = LoadFile $fname, [$id, [$delflag, [$partno]]] @@ -304,9 +304,9 @@ =head2 Decoding files -=over 4 +=over -=item $retval = $item->rename($newname) +=item $retval = $item->rename ($newname) Change the ondisk filename where the decoded file will be saved. @@ -319,27 +319,27 @@ Remove the temporarily decoded file again. -=item $retval = $item->decode([$target_path]) +=item $retval = $item->decode ([$target_path]) -Decode the file to it's destination, or the given target path. +Decode the file to its destination, or the given target path. -=item $retval = $item->info(callback-function) +=item $retval = $item->info (callback-function) =back =head2 Querying (and setting) item attributes -=over 4 +=over =item $state = $item->state -=item $mode = $item->mode([newmode]) +=item $mode = $item->mode ([newmode]) =item $uudet = $item->uudet =item $size = $item->size -=item $filename = $item->filename([newfilename}) +=item $filename = $item->filename ([newfilename}) =item $subfname = $item->subfname @@ -353,7 +353,7 @@ =head2 Information about source parts -=over 4 +=over =item $parts = $item->parts @@ -377,7 +377,7 @@ =back -=head2 Functions below not documented and not very well tested +=head2 Functions below are not documented and not very well tested - feedback welcome QuickDecode EncodeMulti @@ -391,7 +391,7 @@ Functions found in this module but not documented in the uulib documentation: -=over 4 +=over =item $msg = straction ACT_xxx @@ -560,6 +560,25 @@ CleanUp; +=head1 PERLMULTICORE SUPPORT + +This module supports the perlmulticore standard (see +L for more info) for the following +functions - generally these are functions accessing the disk and/or using +considerable CPU time: + + LoadFile + $item->decode + $item->decode_temp + $item->remove_temp + $item->info + +The perl interpreter will be reacquired/released on every callback +invocation, so for performance reasons, callbacks should be avoided if +that is costly. + +Future versions might enable multicore support for more functions. + =head1 BUGS AND LIMITATIONS The original uulib library this module uses was written at a time where