hi, In the current docs of PIR, the
.namespace <id> .endnamespace <id> directives are not mentioned. This patch adds a short description of both to syntax.pod. Regards, klaas-jan
--- syntax.pod 2005-08-08 19:44:47.000000000 +0200 +++ syntax_patched.pod 2005-08-25 16:02:33.000000000 +0200 @@ -1,4 +1,4 @@ -# Copyright: 2001-2005 The Perl Foundation. All Rights Reserved. +# Copyright: 2001-2005 The Perl Foundation. All Rights Reserved. # $Id: syntax.pod 8745 2005-07-30 17:35:35Z chromatic $ =head1 NAME @@ -176,6 +176,29 @@ Define a named constant of style I<type> and value I<const>. +=item .namespace <identifier> + +Open a new scope block. This "namespace" is not the same as the +.namespace [ <identifier> ] syntax, which is used for storing subroutines +in a particular namespace in the global symboltable. +This directive is useful in cases such as (pseudocode): + + local x = 1; + print(x); # prints 1 + do # open a new namespace/scope block + local x = 2; # this x hides the previous x + print(x); # prints 2 + end # close the current namespace + print(x); # prints 1 again + +All types of common language constructs such as if, for, while, repeat and such +that have nested scopes, can use this directive. + +=item .endnamespace <identifier> + +Closes the scope block that was opened with .namespace <identifier>. + + =item .namespace [ <identifier> ] =item .namespace [ <identifier> ; <identifier> ]
