From: Vincent Pit Date: Wed, 20 Aug 2008 21:06:51 +0000 (+0200) Subject: POD beautification X-Git-Url: http://git.vpit.fr/?a=commitdiff_plain;h=9c114b45769d6880b8635884bb3734f00c2742c2;p=perl%2Fmodules%2FSub-Nary.git POD beautification --- diff --git a/lib/Sub/Nary.pm b/lib/Sub/Nary.pm index 1406d66..f3f87e3 100644 --- a/lib/Sub/Nary.pm +++ b/lib/Sub/Nary.pm @@ -59,7 +59,9 @@ The probability is computed as such : =over 4 -=item * When branching, each branch is considered equally possible. +=item * + +When branching, each branch is considered equally possible. For example, the subroutine @@ -85,7 +87,9 @@ As for it is considered to return C<3> scalars with probability C<1/2>, C<2> with probability C<1/2 * 1/2 = 1/4> and C<1> (when the two tests fail, the last computed value is returned, which here is C<< $x > 0.9 >> evaluated in the scalar context of the test) with remaining probability C<1/4>. -=item * The total probability law for a given returning point is the convolution product of the probabilities of its list elements. +=item * + +The total probability law for a given returning point is the convolution product of the probabilities of its list elements. As such, @@ -101,11 +105,15 @@ returns C<3> or C<4> arguments with probability C<1/2> ; and never returns C<1> argument but returns C<2> with probability C<1/2 * 1/2 = 1/4>, C<3> with probability C<1/2 * 1/2 + 1/2 * 1/2 = 1/2> and C<4> with probability C<1/4> too. -=item * If a core function may return different numbers of scalars, each kind is considered equally possible. +=item * + +If a core function may return different numbers of scalars, each kind is considered equally possible. For example, C returns C<13> elements on success and C<0> on error. The according probability will then be C<< { 0 => 0.5, 13 => 0.5 } >>. -=item * The C state is absorbing in regard of all the other ones. +=item * + +The C state is absorbing in regard of all the other ones. This is just a pedantic way to say that "list + fixed length = list". That's why