Author: Util Date: 2009-10-26 23:37:27 +0100 (Mon, 26 Oct 2009) New Revision: 28911
Modified: docs/Perl6/Spec/S32-setting-library/Abstraction.pod docs/Perl6/Spec/S32-setting-library/Basics.pod docs/Perl6/Spec/S32-setting-library/Callable.pod docs/Perl6/Spec/S32-setting-library/Containers.pod docs/Perl6/Spec/S32-setting-library/Exception.pod docs/Perl6/Spec/S32-setting-library/IO.pod docs/Perl6/Spec/S32-setting-library/Numeric.pod docs/Perl6/Spec/S32-setting-library/Rules.pod docs/Perl6/Spec/S32-setting-library/Str.pod docs/Perl6/Spec/S32-setting-library/Temporal.pod Log: [S32] Corrections for typos, mis-formatting, cut-and-paste errors, and other minor offences. Modified: docs/Perl6/Spec/S32-setting-library/Abstraction.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Abstraction.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Abstraction.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -10,7 +10,7 @@ Tim Nelson <wayl...@wayland.id.au> Larry Wall <la...@wall.org> -=head1 Version +=head1 VERSION Created: 26 Feb 2009 Modified: docs/Perl6/Spec/S32-setting-library/Basics.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Basics.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Basics.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -160,7 +160,7 @@ our Order multi sub cmp (Ordering $by = &infix:<cmp>, $a, $b) Returns C<Order::Increase>, or C<Order::Same>, or C<Order::Decrease> -(which numify to -1, 0, +1 respectively) indicating if paramater C<$a> should +(which numify to -1, 0, +1 respectively) indicating if parameter C<$a> should be ordered before/tied with/after parameter C<$b>, using criteria C<$by> or C<@by> for comparisons. C<@by> differs from C<$by> in that each criterion is applied, in order, until a non-zero @@ -214,6 +214,8 @@ method REJECTS($self:, $other) {...} } +=over + =item ACCEPTS Used in smartmatching; see S03. @@ -222,6 +224,8 @@ Used in smartmatching; see S03. +=back + =head2 Scalar B<API document>: L<Scalar> Modified: docs/Perl6/Spec/S32-setting-library/Callable.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Callable.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Callable.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -3,7 +3,7 @@ =head1 TITLE -DRAFT: Synopsis 32: Setting Library - Executeable +DRAFT: Synopsis 32: Setting Library - Callable =head1 AUTHORS @@ -20,7 +20,7 @@ The document is a draft. If you read the HTML version, it is generated from the Pod in the pugs -repository under /docs/Perl6/Spec/S32-setting-library/Exception.pod so edit it there in +repository under /docs/Perl6/Spec/S32-setting-library/Callable.pod so edit it there in the SVN repository if you would like to make changes. This document documents Code, Block, Signature, Capture, Routine, Sub, Method, Submethod, Modified: docs/Perl6/Spec/S32-setting-library/Containers.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Containers.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Containers.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -770,7 +770,7 @@ our Str method decode($encoding = $?ENC, $nf = $?NF) Decode the C<Buf> into a C<Str>. For subtypes that know their encoding (like -C<utf8>, C<utf16>) the C<$encoding> parameter defaults to their intrisic +C<utf8>, C<utf16>) the C<$encoding> parameter defaults to their intrinsic encoding instead. =back @@ -787,10 +787,10 @@ Comparing or concatenating two C<Buf> objects of different bit sizes, or a C<Buf> that doesn't know its encoding with a C<Str> throws an exception. -Likewising coercing an encoding-unaware C<Buf> to C<Str> dies. +Likewise, coercing an encoding-unaware C<Buf> to C<Str> dies. [Conjecture: The behaviour of encoding-aware C<Buf> objects on string -operators is intentially not defined yet, because I have no idea what +operators is intentionally not defined yet, because I have no idea what implications on speed and usage they might have --moritz]. =head2 Pair Modified: docs/Perl6/Spec/S32-setting-library/Exception.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Exception.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Exception.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -50,6 +50,3 @@ Please post errors and feedback to perl6-language. If you are making a general laundry list, please separate messages by topic. - - - Modified: docs/Perl6/Spec/S32-setting-library/IO.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/IO.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/IO.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -207,7 +207,7 @@ EOI = End Of Input -- equivalent to End Of File, but applies to other kinds of sockets as well. -Returns true if it's the end of the input (ie. end of file or whatever), returns false if +Returns true if it's the end of the input (i.e. end of file or whatever), returns false if not, returns undef if we can't say for certain. =item method seek(Int $position --> Bool) @@ -278,7 +278,7 @@ =item method blocking( --> Bool) is rw This allows the user to control whether this object should do a -blocking wait or immediatly return in the case of not having data +blocking wait or immediately return in the case of not having data available. =item uri @@ -558,11 +558,11 @@ =item method read($buf is rw, Int $bytes --> Int) -Implementes the IO::Readable interface by doing a I<recv(2)>. +Implements the IO::Readable interface by doing a I<recv(2)>. =item method write($buf, Int $bytes --> Int) -Implementes the IO::Writeable interface by doing a I<send(2)>. +Implements the IO::Writeable interface by doing a I<send(2)>. =item getpeername @@ -658,13 +658,13 @@ =head2 IO::FileSystems -This represents the file systems mounted on the current machine (ie. accessible via a +This represents the file systems mounted on the current machine (i.e. accessible via a filesystem path). class IO::FileSystems { - has Str $.illegal-chars; # ie. /\x0 + has Str $.illegal-chars; # i.e. /\x0 has Int $.max-path; - has Int $.max-path-element; + has Int $.max-path-element; ... } @@ -721,7 +721,7 @@ all are checked before being pushed onto the array. Note that @.Elements can not be accessed unless $.Encoding is defined. -The C<%times> has keys that can be eg. C<ctime>, C<Modification>, and +The C<%times> has keys that can be e.g. C<ctime>, C<Modification>, and C<Access> (and maybe others on other operating systems), and the values are all C<Temporal::Instant> objects. @@ -750,7 +750,7 @@ Str :$Target, Str :$LinkType, - Str :$Type, + Str :$Type, ); Path and PathElements are mutually exclusive. @@ -768,7 +768,7 @@ Value Condition ===== ========= - Directory $Path ends in a separator (ie. /) + Directory $Path ends in a separator (i.e. /) Link $Target is specified Other $Protocol is specified Undefined All other cases @@ -1053,7 +1053,7 @@ Should be supported by all filesystems as an item to read from the hash for the group "Everyone". -=item Executeable +=item Executable Supported on most Unix systems, anyway. Windows should be able to guess when this is read, and throw an exception if written to. @@ -1208,7 +1208,7 @@ C<0o644> is okay, C<0644> is not. Returns the number of files successfully changed. - $cnt = chmod 0o755, 'foo', 'bar'; + $count = chmod 0o755, 'foo', 'bar'; chmod 0o755, @executables; $mode = '0644'; chmod $mode, 'foo'; # !!! sets mode to --w----r-T $mode = '0o644'; chmod $mode, 'foo'; # this is better @@ -1343,7 +1343,7 @@ =item select(both) -Gone. (Note: for subsecond sleep, just use sleep with a fractional argument.) +Gone. (Note: for sub-second sleep, just use sleep with a fractional argument.) =item IO.shutdown() Modified: docs/Perl6/Spec/S32-setting-library/Numeric.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Numeric.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Numeric.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -84,7 +84,7 @@ our Numeric multi method pred ( Numeric $x: ) is export our Int multi method pred ( Int $x: ) is export -Returns the predeccessor of C<$x>. This method is used by C<< prefix:<--> >> +Returns the predecessor of C<$x>. This method is used by C<< prefix:<--> >> and C<< postfix:<--> >> to decrement the value in a container. =item abs @@ -111,7 +111,7 @@ our Numeric multi method log10 (Numeric $x:) is export -A base C<10> logarithm, othewise identical to C<log>. +A base C<10> logarithm, otherwise identical to C<log>. =item rand @@ -163,7 +163,7 @@ role Real does Numeric; C<Real>, like C<Numeric>, is an abstract role that represents the interface of -a real scalar number (ie neither C<Complex> nor vector-like). For example +a real scalar number (i.e. neither C<Complex> nor vector-like). For example C<Num>, C<Int>, C<Bool> and C<Rat> implement the C<Real> role. =over @@ -286,7 +286,7 @@ =item I<Standard Trig Functions> - Nuermic multi method func ( Nuermic $x: TrigBase $base = $?TRIGBASE ) is export + Numeric multi method func ( Numeric $x: TrigBase $base = $?TRIGBASE ) is export where I<func> is one of: sin, cos, tan, asin, acos, atan, sec, cosec, cotan, asec, acosec, @@ -312,8 +312,8 @@ =item atan2 - our Nuermic multi method atan2 ( Nuermic $y: Nuermic $x = 1 ) - our Nuermic multi atan2 ( Nuermic $y, Nuermic $x = 1 ) + our Numeric multi method atan2 ( Numeric $y: Numeric $x = 1 ) + our Numeric multi atan2 ( Numeric $y, Numeric $x = 1 ) This second form of C<atan> computes the arctangent of C<$y/$x>, and takes the quadrant into account. Otherwise behaves as other trigonometric functions. Modified: docs/Perl6/Spec/S32-setting-library/Rules.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Rules.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Rules.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -9,7 +9,6 @@ Tim Nelson <wayl...@wayland.id.au> Larry Wall <la...@wall.org> - Tim Nelson <wayl...@wayland.id.au> =head1 VERSION @@ -21,7 +20,7 @@ The document is a draft. If you read the HTML version, it is generated from the Pod in the pugs -repository under /docs/Perl6/Spec/S32-setting-library/Exception.pod so edit it there in +repository under /docs/Perl6/Spec/S32-setting-library/Rules.pod so edit it there in the SVN repository if you would like to make changes. =head1 Roles Modified: docs/Perl6/Spec/S32-setting-library/Str.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Str.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Str.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -5,7 +5,7 @@ DRAFT: Synopsis 32: Setting Library - Str -=head1 AUTHORs +=head1 AUTHORS Rod Adams <r...@rodadams.net> Larry Wall <la...@wall.org> @@ -25,7 +25,7 @@ The document is a draft. If you read the HTML version, it is generated from the Pod in the pugs -repository under /docs/Perl6/Spec/S32-setting-library/Miscellaneous-scalars.pod +repository under /docs/Perl6/Spec/S32-setting-library/Str.pod so edit it there in the SVN repository if you would like to make changes. =head1 Str @@ -38,7 +38,7 @@ [Default can't be C<CharLingua> because we don't go into "language" mode unless there's a specific language declaration saying either exactly what language we're going into or, in the absence of that, how to -find the exact language somewhere in the enviroment.] +find the exact language somewhere in the environment.] Attempting to use a string at a level higher it can support is handled without warning. The current highest supported level of the string @@ -344,7 +344,7 @@ our List multi method split ( Str $input: Str $delimiter, Int $limit = * ) our List multi method split ( Str $input: Regex $delimiter, Int $limit = *, Bool :$all = False) -Splits a string up into pieces based on delimeters found in the string. +Splits a string up into pieces based on delimiters found in the string. String delimiters must not be treated as rules but as constants. The default is no longer S<' '> since that would be interpreted as a constant. @@ -526,7 +526,7 @@ C<join $sep, map { sprintf($format, $_) }, @a>. A call to the hash version C<%h.fmt($format, $sep)> returns the result of C<join $sep, map { sprintf($format, $_.key, $_.value) }, %h.pairs>. A call -to the pair versionC<$p.fmt($format)> returns the result of +to the pair version C<$p.fmt($format)> returns the result of C<sprintf($format, $p.key, $p.value)>. =item substr @@ -541,7 +541,7 @@ C<substr> returns part of an existing string. You control what part by passing a starting position and optionally either an end position or length. If you pass a number as either the position or length, then it will be used -as the start or length with the assumtion that you mean "chars" in the +as the start or length with the assumption that you mean "chars" in the current Unicode abstraction level, which defaults to graphemes. A number in the 3rd argument is interpreted as a length rather than a position (just as in Perl 5). @@ -563,7 +563,7 @@ multi method trim() is export; -Returns a copy of the string, with leading and trailing whitespaces removed. +Returns a copy of the string, with leading and trailing whitespace removed. =item unpack @@ -589,6 +589,3 @@ Please post errors and feedback to perl6-language. If you are making a general laundry list, please separate messages by topic. - - - Modified: docs/Perl6/Spec/S32-setting-library/Temporal.pod =================================================================== --- docs/Perl6/Spec/S32-setting-library/Temporal.pod 2009-10-26 21:48:36 UTC (rev 28910) +++ docs/Perl6/Spec/S32-setting-library/Temporal.pod 2009-10-26 22:37:27 UTC (rev 28911) @@ -263,4 +263,3 @@ Please post errors and feedback to perl6-language. If you are making a general laundry list, please separate messages by topic. -