Permalink
Browse files

Some reflow and grammar changes

  • Loading branch information...
JJ committed Nov 8, 2018
1 parent 7075ac4 commit 4992c971486cabcfd175492ef43b4c52fa468879
Showing with 14 additions and 10 deletions.
  1. +14 −10 doc/Language/pod.pod6
@@ -68,8 +68,8 @@ Boolean). Also note that "bigints" can be used if required.
For hashes, '$k1, $k2, ...' are keys of type Str and '$v1, $v2, ...'
are values of type String, Int, Number, or Boolean.
Strings are delimited by single or double quotes. Whitespace is insignificant outside
of strings. Hash keys need not be quote-delimited unless they contain
Strings are delimited by single or double quotes. Whitespace is not significant
outside of strings. Hash keys need not be quote-delimited unless they contain
significant whitespace. Strings entered inside angle brackets become lists when
whitespace is used inside the brackets.
@@ -80,9 +80,9 @@ Perl 6 pair notations.
The configuration section may be extended over subsequent lines by
starting those lines with an C<=> in the first (virtual) column followed
by a whitespace character. (NOTE: This feature is not yet completely implemented.
by a whitespace character. N<This feature is not yet completely implemented.
All configuration information currently must be provided on the same
line as the C<=begin> marker line or C<=for name> for paragraph blocks.)
line as the C<=begin> marker line or C<=for name> for paragraph blocks.>
=head2 Paragraph blocks
@@ -122,10 +122,11 @@ sequence of closing brackets.
Blocks starting with C<#|> are attached to the code after them,
and blocks starting with C<#=> are attached to the code before them.
Since declarator blocks are attached to source code, they can be used to document
classes, roles, subroutines etc.
Since declarator blocks are attached to source code, they can be used to
document classes, roles, subroutines and in general any statement or block.
The C<WHY> method can be used on these classes, roles, subroutines etc. to return the attached Pod value.
The C<WHY> method can be used on these classes, roles, subroutines etc. to
return the attached Pod value.
=begin code :skip-test
#| Base class for magicians
@@ -163,7 +164,9 @@ sub search-in-seq( Int $end, Int $number ) {
»
=end code
By using a matched pair of parenthesis constructs such as C<()> or C<«»> the comments can extend multiple lines. This format, however, will not translate to a multi-line display by C<perl6 -doc>.
By using a matched pair of parenthesis constructs such as C<()> or C<«»> the
comments can extend multiple lines. This format, however, will not translate to
a multi-line display by C<perl6 -doc>.
=head1 Block types
@@ -184,8 +187,9 @@ where N is greater than zero (e.g., C<=head1>, C<=head2>, …).
=head2 Ordinary paragraphs
An ordinary paragraph consists of text that is to be formatted into a document at the current level of nesting,
with whitespace squeezed, lines filled, and any special inline mark-up applied.
An ordinary paragraph consists of text that is to be formatted into a document
at the current level of nesting, with whitespace squeezed, lines filled, and any
special inline mark-up applied.
Ordinary paragraphs consist of one or more consecutive lines of text,
each of which starts with a non-whitespace character.

0 comments on commit 4992c97

Please sign in to comment.