Author: chromatic
Date: Sun Jun 1 01:14:10 2008
New Revision: 28000
Modified:
trunk/docs/pdds/draft/pdd19_pir.pod
Log:
[docs] Updated PIR PDD 19 to reflect changes in empty namespace declaration
(Andrew Whitworth, RT #54942).
Modified: trunk/docs/pdds/draft/pdd19_pir.pod
==============================================================================
--- trunk/docs/pdds/draft/pdd19_pir.pod (original)
+++ trunk/docs/pdds/draft/pdd19_pir.pod Sun Jun 1 01:14:10 2008
@@ -276,20 +276,21 @@
=item .namespace [ <identifier> ; <identifier> ]
+ .namespace [ <key>? ]
+
+ key: <identifier> [';' <identifier>]*
+
Defines the namespace from this point onwards. By default the program is not
in any namespace. If you specify more than one, separated by semicolons, it
creates nested namespaces, by storing the inner namespace object in the outer
namespace's global pad.
-{{ PROPOSAL: make the brackets non-optional for specifying the "root"
-namespace, so the key becomes optional.
+You can specify the root namespace by using empty brackets, such as:
- .namespace [ <key>? ]
+ .namespace [ ]
- key: <identifier> [';' <identifier>]*
+The brackets are not optional, although the string inside them is.
- Also, the "identifier" should be a quoted string?
-}}
=item .pragma n_operators