Skip to content

Commit

Permalink
[S32] Corrections for typos, mis-formatting, cut-and-paste errors, an…
Browse files Browse the repository at this point in the history
…d other minor offences.

git-svn-id: http://svn.pugscode.org/pugs@28911 c213334d-75ef-0310-aa23-eaa082d1ae64
  • Loading branch information
Util authored and Util committed Oct 26, 2009
1 parent ff65461 commit ea5fbe1
Show file tree
Hide file tree
Showing 10 changed files with 38 additions and 42 deletions.
2 changes: 1 addition & 1 deletion S32-setting-library/Abstraction.pod
Expand Up @@ -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

Expand Down
6 changes: 5 additions & 1 deletion S32-setting-library/Basics.pod
Expand Up @@ -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
Expand Down Expand Up @@ -214,6 +214,8 @@ quite want to throw an exception.
method REJECTS($self:, $other) {...}
}

=over

=item ACCEPTS

Used in smartmatching; see S03.
Expand All @@ -222,6 +224,8 @@ Used in smartmatching; see S03.

Used in smartmatching; see S03.

=back

=head2 Scalar

B<API document>: L<Scalar>
Expand Down
4 changes: 2 additions & 2 deletions S32-setting-library/Callable.pod
Expand Up @@ -3,7 +3,7 @@

=head1 TITLE

DRAFT: Synopsis 32: Setting Library - Executeable
DRAFT: Synopsis 32: Setting Library - Callable

=head1 AUTHORS

Expand All @@ -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,
Expand Down
6 changes: 3 additions & 3 deletions S32-setting-library/Containers.pod
Expand Up @@ -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
Expand All @@ -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
Expand Down
3 changes: 0 additions & 3 deletions S32-setting-library/Exception.pod
Expand Up @@ -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.



26 changes: 13 additions & 13 deletions S32-setting-library/IO.pod
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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;
...
}

Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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.
Expand All @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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()

Expand Down
12 changes: 6 additions & 6 deletions S32-setting-library/Numeric.pod
Expand Up @@ -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
Expand All @@ -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

Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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,
Expand All @@ -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.
Expand Down
3 changes: 1 addition & 2 deletions S32-setting-library/Rules.pod
Expand Up @@ -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

Expand All @@ -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
Expand Down
17 changes: 7 additions & 10 deletions S32-setting-library/Str.pod
Expand Up @@ -5,7 +5,7 @@

DRAFT: Synopsis 32: Setting Library - Str

=head1 AUTHORs
=head1 AUTHORS

Rod Adams <rod@rodadams.net>
Larry Wall <larry@wall.org>
Expand All @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand All @@ -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).
Expand All @@ -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

Expand All @@ -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.



1 change: 0 additions & 1 deletion S32-setting-library/Temporal.pod
Expand Up @@ -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.