r28750 - docs/Perl6/Spec

2009-10-11 Thread pugs-commits
Author: carlin
Date: 2009-10-11 09:21:58 +0200 (Sun, 11 Oct 2009)
New Revision: 28750

Modified:
   docs/Perl6/Spec/S16-io.pod
Log:
[Spec/S16-io] Tidied up some formatting and escaped the brackets in %*ENVPATH 
to (hopefully) fix a POD-error

Modified: docs/Perl6/Spec/S16-io.pod
===
--- docs/Perl6/Spec/S16-io.pod  2009-10-11 06:22:37 UTC (rev 28749)
+++ docs/Perl6/Spec/S16-io.pod  2009-10-11 07:21:58 UTC (rev 28750)
@@ -183,19 +183,21 @@
 
 The global variable $*CWD is a Path object with certain special properties, 
 mainly:
+
  * It must check whether the path exists before changing its value
  * It can only be assigned an absolute path; if you want to make relative 
changes, use the Array interface
 
-$*CWD is specific to the current thread, unlike %*ENVPATH or the native 
-getcwd/chdir path, which are both usually process-wide.  
+$*CWD is specific to the current thread, unlike %*ENVEltPATHEgt or the
+native getcwd/chdir path, which are both usually process-wide.
 
 The variable is used in at least these cases:
-* When a Path object is created, if the string it is given is not an absolute 
-  path, then $*CWD is prepended to it.  
-* When a subprocess is executed, it is executed with the current thread's 
-  $*CWD as its working directory.  
 
+ * When a Path object is created, if the string it is given is not an
+   absolute path, then $*CWD is prepended to it.
+ * When a subprocess is executed, it is executed with the current
+   thread's $*CWD as its working directory.
+
 =head1 Name Services
 
 =head2 User role



r28751 - docs/Perl6/Spec

2009-10-11 Thread pugs-commits
Author: jimmy
Date: 2009-10-11 10:55:02 +0200 (Sun, 11 Oct 2009)
New Revision: 28751

Modified:
   docs/Perl6/Spec/S02-bits.pod
Log:
[Spec/S02-bits.pod] changed colon to comma

Modified: docs/Perl6/Spec/S02-bits.pod
===
--- docs/Perl6/Spec/S02-bits.pod2009-10-11 07:21:58 UTC (rev 28750)
+++ docs/Perl6/Spec/S02-bits.pod2009-10-11 08:55:02 UTC (rev 28751)
@@ -247,7 +247,7 @@
 $object\
 .say
 
-But unspace is mainly about language extensibility: it lets you continue
+But unspace is mainly about language extensibility, it lets you continue
 the line in any situation where a newline might confuse the parser,
 regardless of your currently installed parser.  (Unless, of course,
 you override the unspace rule itself...)
@@ -593,7 +593,7 @@
 
 my Int $x = undef;# works
 
-Variables with native types do not support undefinedness: it is an error
+Variables with native types do not support undefinedness, it is an error
 to assign an undefined value to them:
 
 my int $y = undef;# dies



Re: r28751 - docs/Perl6/Spec

2009-10-11 Thread Mark J. Reed
That's not grammatical; you've just created a run-on sentence.  Why not
leave it as a colon?

On Sun, Oct 11, 2009 at 4:55 AM, pugs-comm...@feather.perl6.nl wrote:

 Author: jimmy
 Date: 2009-10-11 10:55:02 +0200 (Sun, 11 Oct 2009)
 New Revision: 28751

 Modified:
   docs/Perl6/Spec/S02-bits.pod
 Log:
 [Spec/S02-bits.pod] changed colon to comma

 Modified: docs/Perl6/Spec/S02-bits.pod
 ===
 --- docs/Perl6/Spec/S02-bits.pod2009-10-11 07:21:58 UTC (rev 28750)
 +++ docs/Perl6/Spec/S02-bits.pod2009-10-11 08:55:02 UTC (rev 28751)
 @@ -247,7 +247,7 @@
 $object\
 .say

 -But unspace is mainly about language extensibility: it lets you continue
 +But unspace is mainly about language extensibility, it lets you continue
  the line in any situation where a newline might confuse the parser,
  regardless of your currently installed parser.  (Unless, of course,
  you override the unspace rule itself...)
 @@ -593,7 +593,7 @@

 my Int $x = undef;# works

 -Variables with native types do not support undefinedness: it is an error
 +Variables with native types do not support undefinedness, it is an error
  to assign an undefined value to them:

 my int $y = undef;# dies




-- 
Mark J. Reed markjr...@gmail.com


r28754 - docs/Perl6/Spec

2009-10-11 Thread pugs-commits
Author: masak
Date: 2009-10-11 13:04:33 +0200 (Sun, 11 Oct 2009)
New Revision: 28754

Modified:
   docs/Perl6/Spec/S02-bits.pod
Log:
Revert [Spec/S02-bits.pod] changed colon to comma

The improvement was of the kind where things were actually more improved
before the change than after. Reverting.

Modified: docs/Perl6/Spec/S02-bits.pod
===
--- docs/Perl6/Spec/S02-bits.pod2009-10-11 10:28:11 UTC (rev 28753)
+++ docs/Perl6/Spec/S02-bits.pod2009-10-11 11:04:33 UTC (rev 28754)
@@ -247,7 +247,7 @@
 $object\
 .say
 
-But unspace is mainly about language extensibility, it lets you continue
+But unspace is mainly about language extensibility: it lets you continue
 the line in any situation where a newline might confuse the parser,
 regardless of your currently installed parser.  (Unless, of course,
 you override the unspace rule itself...)
@@ -593,7 +593,7 @@
 
 my Int $x = undef;# works
 
-Variables with native types do not support undefinedness, it is an error
+Variables with native types do not support undefinedness: it is an error
 to assign an undefined value to them:
 
 my int $y = undef;# dies



Re: r28751 - docs/Perl6/Spec

2009-10-11 Thread Brandon S. Allbery KF8NH

On Oct 11, 2009, at 06:36 , Mark J. Reed wrote:
That's not grammatical; you've just created a run-on sentence.  Why  
not

leave it as a colon?


Or semicolon.  I agree comma seems wrong.

--
brandon s. allbery [solaris,freebsd,perl,pugs,haskell] allb...@kf8nh.com
system administrator [openafs,heimdal,too many hats] allb...@ece.cmu.edu
electrical and computer engineering, carnegie mellon universityKF8NH




PGP.sig
Description: This is a digitally signed message part


r28768 - docs/Perl6/Spec

2009-10-11 Thread pugs-commits
Author: carlin
Date: 2009-10-12 03:15:43 +0200 (Mon, 12 Oct 2009)
New Revision: 28768

Modified:
   docs/Perl6/Spec/S16-io.pod
   docs/Perl6/Spec/S29-functions.pod
Log:
[Spec/S29-functions.pod] Added some details about die and fail


Modified: docs/Perl6/Spec/S16-io.pod
===
--- docs/Perl6/Spec/S16-io.pod  2009-10-12 01:03:40 UTC (rev 28767)
+++ docs/Perl6/Spec/S16-io.pod  2009-10-12 01:15:43 UTC (rev 28768)
@@ -188,7 +188,7 @@
  * It can only be assigned an absolute path; if you want to make relative 
changes, use the Array interface
 
-$*CWD is specific to the current thread, unlike %*ENVEltPATHEgt or the
+$*CWD is specific to the current thread, unlike C %*ENVPATH  or the
 native getcwd/chdir path, which are both usually process-wide.
 
 The variable is used in at least these cases:

Modified: docs/Perl6/Spec/S29-functions.pod
===
--- docs/Perl6/Spec/S29-functions.pod   2009-10-12 01:03:40 UTC (rev 28767)
+++ docs/Perl6/Spec/S29-functions.pod   2009-10-12 01:15:43 UTC (rev 28768)
@@ -14,12 +14,13 @@
 Carl Mäsak cma...@gmail.com
 Moritz Lenz mor...@faui2k3.org
 Tim Nelson wayl...@wayland.id.au
+Carlin Bingham car...@theintersect.org
 
 =head1 Version
 
 Created: 12 Mar 2005
 
-Last Modified: 30 May 2009
+Last Modified: 13 October 2009
 Version: 43
 
 The document is a draft.
@@ -252,10 +253,18 @@
 
 =item die
 
+ multi die (@LIST)
+
+Prints each element to $*ERR (STDERR) and throws an exception.
+
 =item fail
 
-BTODO: Research the exception handling system.
+ multi fail (Str $message)
 
+Can only be called inside a routine and causes the routine to Creturn an
+unthrown exception; a CFailure object which stringifies to C$message.
+If Cuse fatal is in effect where the routine was called from, it throws
+the exception.
 
 =back
 



r28769 - docs/Perl6/Spec

2009-10-11 Thread pugs-commits
Author: carlin
Date: 2009-10-12 03:19:18 +0200 (Mon, 12 Oct 2009)
New Revision: 28769

Modified:
   docs/Perl6/Spec/S16-io.pod
Log:
[Spec/S16-io.pod] Use Z to escape %*ENVPATH. Accidentally commited the last 
change. carlin--

Modified: docs/Perl6/Spec/S16-io.pod
===
--- docs/Perl6/Spec/S16-io.pod  2009-10-12 01:15:43 UTC (rev 28768)
+++ docs/Perl6/Spec/S16-io.pod  2009-10-12 01:19:18 UTC (rev 28769)
@@ -188,7 +188,7 @@
  * It can only be assigned an absolute path; if you want to make relative 
changes, use the Array interface
 
-$*CWD is specific to the current thread, unlike C %*ENVPATH  or the
+$*CWD is specific to the current thread, unlike C %*ENVZPATH  or the
 native getcwd/chdir path, which are both usually process-wide.
 
 The variable is used in at least these cases:



Re: r28768 - docs/Perl6/Spec

2009-10-11 Thread Carl Mäsak
commitbot, channeling Carlin ():
  =item die

 + multi die (@LIST)
 +
 +Prints each element to $*ERR (STDERR) and throws an exception.

Well, no. If that were true, die calls within (the dynamic scope of)
a try block would also print things, which they don't. It's the thing
that catches the exception that decides to print or not print.

// Carl