Author: wayland
Date: 2009-02-23 09:42:50 +0100 (Mon, 23 Feb 2009)
New Revision: 25495
Modified:
docs/Perl6/Spec/S16-io.pod
docs/Perl6/Spec/S28-special-variables.pod
Log:
More S28 updates, including turning things into references to elsewhere, and
better
documenting the standard/default IO handles.
Modified: docs/Perl6/Spec/S16-io.pod
===================================================================
--- docs/Perl6/Spec/S16-io.pod 2009-02-23 08:31:29 UTC (rev 25494)
+++ docs/Perl6/Spec/S16-io.pod 2009-02-23 08:42:50 UTC (rev 25495)
@@ -28,8 +28,9 @@
In Perl 6, there are the I<standard> handles, and the I<default> handles.
-The I<standard> ones are our old familiar friends (with new names). Standard
input is
-C<$*IN>, standard output is C<$*OUT>, and standard error is C<$*ERR>.
+The I<standard> ones are our old familiar friends (with new names). Standard
input
+changed from STDIN to C<$*IN>, standard output changed from STDOUT to
C<$*OUT>, and
+standard error changed from STDERR to C<$*ERR>.
However, the I<default> ones replace the single handle set by the Perl 5
select() call
with with three new variables.
Modified: docs/Perl6/Spec/S28-special-variables.pod
===================================================================
--- docs/Perl6/Spec/S28-special-variables.pod 2009-02-23 08:31:29 UTC (rev
25494)
+++ docs/Perl6/Spec/S28-special-variables.pod 2009-02-23 08:42:50 UTC (rev
25495)
@@ -1,4 +1,4 @@
-=head1 NAME
+=head1 Name
[DRAFT] Synopsis 28 - Special Variables [DRAFT]
@@ -11,7 +11,7 @@
Last Modified: 23 Feb 2009
Version: 1
-=head1 INTRODUCTION
+=head1 Introduction
This document serves as a collection point
for what is known about special variables
@@ -26,7 +26,7 @@
Most/All variables of the form $*SOMETHING should also work in the form
$SOMETHING (without the '*') unless masked by "my $SOMETHING".
-=head1 DESCRIPTION
+=head1 Overview
=head2 Secondary Sigils (also known as "twigils"):
@@ -42,7 +42,7 @@
=head2 Named variables (see S02):
- $/ # match object from last rule
+ $/ # match object from last rule (see S05)
$0 # first captured value from match: $/.[0]
@*ARGS # command-line arguments
&?BLOCK # current block (itself, see S06)
@@ -59,14 +59,14 @@
$*DEFERR # Default error file handle (see S16)
$*EGID # effective group id
%*ENV # system environment
- $*ERR # standard error handle (but you likely want $*DEFERR)
+ $*ERR # standard error handle (see S16)
$*EUID # effective user id
$*EXECUTABLE_NAME # executable name
$?FILE # current file
$?GRAMMAR # current grammar
@?GRAMMAR # current grammars
$*GID # group id
- $*IN # standard input handle (but you likely want $*DEFIN)
+ $*IN # standard input handle (see S16)
$?LABEL # label of current block
@?LABEL # labels of current blocks
$?LINE # current line
@@ -76,7 +76,7 @@
$*OS # operating system running under
$?OSVER # operating system version compiled for
$*OSVER # operating system version running under
- $*OUT # standard output handle (but you likely want $*DEFOUT)
+ $*OUT # standard output handle (see S16)
$?PACKAGE # current package (as object)
@?PACKAGE # current packages
$?PACKAGENAME # name of current package (see S10)
@@ -100,79 +100,22 @@
"ENV" is probably to overloaded to mean the hash of environment variables
(which would be found under $*ENV.environment or some-such).
+=head1 Special Variables
-XXX Everything below this line is older than everything above it. XXX
+This section only lists variables that don't have a "See S16" or suchlike next
to them in
+the overview above.
-=head1 NAME
+XXX Some of the information here is either old, or needs to be moved
elsewhere. XXX
- [DRAFT] Synopsis 28 - Special Variables [DRAFT]
-
-=head1 OUTLINE
-
- DRAFT NOTES
- INTRODUCTION
- SPECIAL VARIABLES
- PERL 6 / PERL 5 COMPARISON
- HISTORY
- SOURCES
-
-=head1 DRAFT NOTES
-
-As of 2007-03-13:
-
-There is a more recent document at docs/Perl6/Overview/Variable.pod
-which contains the bare bones of the next
-iteration of work on special variables in Perl 6.
-
-While the list there appears to be more complete, there remains information
-here that may still be of help in roughing in more details there.
-
-=head1 SPECIAL VARIABLES
-
=over 8
-=item $*IN
-
-=item $*OUT
-
-=item $*ERR
-
-Predefined filehandles for STDIN, STDOUT, and STDERR.
-
-=over 4
-
-=item p5:
-
-Replace STDIN, STDOUT, and STDERR.
-
-=back
-
-=back
-
-=over 8
-
-=item $_
-
-The default input and pattern-searching space.
-Same as in Perl 5 but lexically scoped
-
-=over 4
-
-=item p5:
-
-$_ but more lexically aware.
-
-=back
-
-=back
-
-=over 8
-
=item $a, $b, $c ...
Parameters of the current closure (block
or subroutine) by position in the invocation.
+XXX This needs to go under "Closures". XXX
+
=over 4
=item p5:
@@ -185,24 +128,6 @@
=over 8
-=item $/
-
-Object containing the results of the last regular expression match.
-All match result info found in the contained data structure.
-This is available as the current state of the match in progress.
-
-=over 4
-
-=item p5:
-
-No direct parallel.
-
-=back
-
-=back
-
-=over 8
-
=item $0,$1,$2...
Objects containing information on any subpatterns
@@ -383,13 +308,13 @@
Perl 5 Perl 6 Comment
----------- ----------- -----------------------
- STDIN $*IN
+ STDIN $*IN See S16
- STDOUT $*OUT
+ STDOUT $*OUT See S16
- STDERR $*ERR
+ STDERR $*ERR See S16
- $_ $_
+ $_ $_ More lexically aware
$_[1],$_[2].. $^a,$^b..
@@ -578,13 +503,16 @@
&*ON_PARSEERROR
- $^S $EXCEPTIONS_BEING_CAUGHT
-=head1 HISTORY
- 2007-03-13 dvergin Reference to docs/Perl6/Overview/Variable.pod
- 2005-04-11 dvergin Filling in more pieces
- 2005-04-10 dvergin Roughed in main table
- 2005-04-02 anonpugster Placeholder file containing Larry's email
+XXX Everything below this line is older than everything above it. XXX
+=head1 OUTLINE
+
+ SPECIAL VARIABLES
+ PERL 6 / PERL 5 COMPARISON
+ HISTORY
+ SOURCES
+
=head1 SOURCES
At its present stage of development this file
