# New Ticket Created by Andrew Whitworth
# Please include the string: [perl #54942]
# in the subject line of all future correspondence about this issue.
# <URL: http://rt.perl.org/rt3/Ticket/Display.html?id=54942 >
The unbracketed .namespace declaration is deprecated as per #48549.
Included is a patch to PDD19_pir.pod to reflect this. Previously,
there was a temporary note there suggesting this.
--Andrew Whitworth
Index: docs/pdds/draft/pdd19_pir.pod
===================================================================
--- docs/pdds/draft/pdd19_pir.pod (revision 27852)
+++ docs/pdds/draft/pdd19_pir.pod (working copy)
@@ -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
