Author: moritz Date: Tue Nov 25 02:15:26 2008 New Revision: 33188 Modified: trunk/docs/pdds/draft/pdd14_numbers.pod
Log: [cage] some more line wrappings in pdd14 Modified: trunk/docs/pdds/draft/pdd14_numbers.pod ============================================================================== --- trunk/docs/pdds/draft/pdd14_numbers.pod (original) +++ trunk/docs/pdds/draft/pdd14_numbers.pod Tue Nov 25 02:15:26 2008 @@ -36,8 +36,8 @@ Parrot provides a native floating-point data type, generally known as a "Num". The size of the float is chosen at Parrot configuration time, the same size as platform-native floats. In C, the typedef C<FLOATVAL> is a native float data -type. The semantics of the native float data type are the same as the semantics -of the C equivalent. +type. The semantics of the native float data type are the same as the +semantics of the C equivalent. Float data types have a dedicated register set. In PIR, the C<N> register variables (C<$N0>, etc.) and C<.param>s or C<.local>s declared with the C<num> @@ -73,8 +73,8 @@ Set the C<Integer> to the passed-in integer value. -=item set_number_native(FLOATVAL value), set_bool(INTVAL value), set_bigint_int(INTVAL value), - set_string_native(STRING *value) +=item set_number_native(FLOATVAL value), set_bool(INTVAL value), + set_bigint_int(INTVAL value), set_string_native(STRING *value) Morphs the C<Integer> PMC to a C<Float>, C<Boolean>, C<BigInt>, or C<String> PMC, and sets the value from the passed in value. @@ -102,7 +102,8 @@ Returns the integer value of the C<Integer> as a string. -=item [add|subtract|multiply|divide|floor_divide|modulus|pow]_int(INTVAL b, PMC *dest) +=item [add|subtract|multiply|divide|floor_divide|modulus|pow]_int(INTVAL b, + PMC *dest) Add/subtract/multiply/divide/modulus/exponent an integer value with the C<Integer> PMC, and return the result as a new PMC (the C<dest> parameter is @@ -119,11 +120,12 @@ purely internally (perhaps by swapping vtables), rather than converting to a different PMC type.}} -=item i_[add|subtract|multiply|divide|floor_divide|modulus|pow]_float(INTVAL b) +=item i_[add|subtract|multiply|divide|floor_divide|modulus|pow]_float(INTVAL + b) Add/subtract/multiply/divide/modulus/exponent an integer value with the -C<Integer> PMC, and set the C<Integer> to the resulting value, morphing it to a -C<Float>. +C<Integer> PMC, and set the C<Integer> to the resulting value, morphing it +to a C<Float>. =item increment() @@ -159,12 +161,13 @@ =over 4 -=item [add|subtract|multiply|divide|floor_divide|modulus|pow](PMC *value, PMC *dest) +=item [add|subtract|multiply|divide|floor_divide|modulus|pow](PMC *value, + PMC *dest) Perform the addition/subtraction/multiplication/division/modulus/exponent operation, and return a new PMC containing the resulting value. Multiple -dispatch variants are defined for C<Integer>, C<Complex>, C<BigInt>, C<String>, -and C<DEFAULT>. +dispatch variants are defined for C<Integer>, C<Complex>, C<BigInt>, +C<String>, and C<DEFAULT>. Overflow of the native integer storage auto-promotes the result PMC to a C<BigInt>. @@ -172,8 +175,8 @@ =item i_[add|subtract|multiply|divide|floor_divide|modulus|pow](PMC *value) Perform the addition/subtraction/multiplication/division/modulus/exponent -operation, morphing the C<Integer> to the passed in type, and setting it to the -result. Multiple dispatch variants are defined for C<Integer>, C<Complex>, +operation, morphing the C<Integer> to the passed in type, and setting it to +the result. Multiple dispatch variants are defined for C<Integer>, C<Complex>, C<BigInt>, and C<DEFAULT>. Overflow of the native integer storage auto-promotes the C<Integer> to a @@ -181,24 +184,24 @@ =item is_equal(PMC *value) -Compare the C<Integer> to the passed in PMC, return true (1) if they are equal, -and false (0) otherwise. Multiple dispatch variants are defined for C<BigInt> -and C<DEFAULT>. {{NOTE: Presumably the C<String>, C<Integer>, and C<Float> -cases are all covered by C<DEFAULT>.}} +Compare the C<Integer> to the passed in PMC, return true (1) if they are +equal, and false (0) otherwise. Multiple dispatch variants are defined for +C<BigInt> and C<DEFAULT>. {{NOTE: Presumably the C<String>, C<Integer>, +and C<Float> cases are all covered by C<DEFAULT>.}} =item cmp(PMC *value) -Compare the C<Integer> to the passed in PMC, return 1 if C<Integer> is greater, --1 if the PMC is greater, and 0 if they are equal. Multiple dispatch variants -are defined for C<String>, C<Float>, and C<DEFAULT>. {{NOTE: Presumably the -C<Integer> and C<BigInt> cases are covered by C<DEFAULT>.}} +Compare the C<Integer> to the passed in PMC, return 1 if C<Integer> is +greater, -1 if the PMC is greater, and 0 if they are equal. Multiple dispatch +variants are defined for C<String>, C<Float>, and C<DEFAULT>. {{NOTE: +Presumably the C<Integer> and C<BigInt> cases are covered by C<DEFAULT>.}} =item cmp_num(PMC *value) -Compare the C<Integer> to the passed in PMC, return 1 if C<Integer> is greater, --1 if the PMC is greater, and 0 if they are equal. Multiple dispatch variants -are defined for C<String>, C<Float>, and C<DEFAULT>. {{NOTE: Presumably the -C<Integer> and C<BigInt> cases are covered by C<DEFAULT>.}} +Compare the C<Integer> to the passed in PMC, return 1 if C<Integer> is +greater, -1 if the PMC is greater, and 0 if they are equal. Multiple dispatch +variants are defined for C<String>, C<Float>, and C<DEFAULT>. {{NOTE: +Presumably the C<Integer> and C<BigInt> cases are covered by C<DEFAULT>.}} =back @@ -588,4 +591,4 @@ Local Variables: fill-column:78 End: -vim: expandtab shiftwidth=4: +vim: expandtab tw=78 shiftwidth=4: