Permalink
Browse files

[S32] Corrections for typos, mis-formatting, cut-and-paste errors, an…

…d other minor offences.

git-svn-id: http://svn.pugscode.org/pugs@28911 c213334d-75ef-0310-aa23-eaa082d1ae64
  • Loading branch information...
1 parent ff65461 commit ea5fbe13302e515e15bbf17ed0e4bb9b77c0453d Util committed Oct 26, 2009
@@ -10,7 +10,7 @@ DRAFT: Synopsis 32: Setting Library - Abstraction
Tim Nelson <wayland@wayland.id.au>
Larry Wall <larry@wall.org>
-=head1 Version
+=head1 VERSION
Created: 26 Feb 2009
@@ -160,7 +160,7 @@ attribute during the cloning process.
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 @@ quite want to throw an exception.
method REJECTS($self:, $other) {...}
}
+=over
+
=item ACCEPTS
Used in smartmatching; see S03.
@@ -222,6 +224,8 @@ Used in smartmatching; see S03.
Used in smartmatching; see S03.
+=back
+
=head2 Scalar
B<API document>: L<Scalar>
@@ -3,7 +3,7 @@
=head1 TITLE
-DRAFT: Synopsis 32: Setting Library - Executeable
+DRAFT: Synopsis 32: Setting Library - Callable
=head1 AUTHORS
@@ -20,7 +20,7 @@ DRAFT: Synopsis 32: Setting Library - Executeable
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,
@@ -770,7 +770,7 @@ L<S02/Built-In Data Types>.
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 @@ a C<buf8> object.
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
@@ -50,6 +50,3 @@ the SVN repository if you would like to make changes.
Please post errors and feedback to perl6-language. If you are making
a general laundry list, please separate messages by topic.
-
-
-
View
@@ -207,7 +207,7 @@ C<IO::Writeable::Encoded> methods.
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 @@ If blocking is passed in, .blocking() is called (see below).
=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 @@ $how can contain 1 or more of the strings 'Readable' and 'Writeable'.
=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 @@ a list of autochomped lines, so just use ordinary C<IO> operators after the open
=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 @@ The C<@.Elements> array is a list of Str that contain the path elements, but
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 @@ This is called automatically on object creation.
Str :$Target,
Str :$LinkType,
- Str :$Type,
+ Str :$Type,
);
Path and PathElements are mutually exclusive.
@@ -768,7 +768,7 @@ as follows:
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
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 @@ number, and which definitely should I<not> be a string of octal digits:
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 @@ Gone, see Pipe.pair
=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()
@@ -84,7 +84,7 @@ C<< postfix:<++> >> to increment the value in a container.
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 @@ error.
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 @@ with the postfix, it's necessary to use a backslash or parentheses:
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 @@ depend on the current (lexically scoped) trig base:
=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 @@ compiler constant:
=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.
@@ -9,7 +9,6 @@ DRAFT: Synopsis 32: Setting Library - Rules
Tim Nelson <wayland@wayland.id.au>
Larry Wall <larry@wall.org>
- Tim Nelson <wayland@wayland.id.au>
=head1 VERSION
@@ -21,7 +20,7 @@ DRAFT: Synopsis 32: Setting Library - Rules
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
@@ -5,7 +5,7 @@
DRAFT: Synopsis 32: Setting Library - Str
-=head1 AUTHORs
+=head1 AUTHORS
Rod Adams <rod@rodadams.net>
Larry Wall <larry@wall.org>
@@ -25,7 +25,7 @@ DRAFT: Synopsis 32: Setting Library - Str
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 @@ declared the "working Unicode level to be". Default is C<Grapheme>.
[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 @@ X<split>
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 @@ the list version C<@a.fmt($format, $sep)> returns the result of
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<sprintf($format, $p.key, $p.value)>.
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 @@ then the original string will be dynamically resized.
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 @@ See L<S05/Substitution>
Please post errors and feedback to perl6-language. If you are making
a general laundry list, please separate messages by topic.
-
-
-
@@ -263,4 +263,3 @@ The gregorian Duration declares the following attributes.
Please post errors and feedback to perl6-language. If you are making
a general laundry list, please separate messages by topic.
-

0 comments on commit ea5fbe1

Please sign in to comment.