document the default HLL root namespace

[barney]

In the absence of a .HLL directive the hll root namespace seems to be [ 'parrot' ]. But this isn't documented in either PDD21 nor PDD 19. Documentation should be added.

[whiteknight]

I added a short note about this to each PDD in r34246. If this is sufficient, I will close this ticket.

[barney]

IMHO the change to PDD21 is not correct. I propose the following:

Index: docs/pdds/pdd21_namespaces.pod =================================================================== --- docs/pdds/pdd21_namespaces.pod (Revision 34246) +++ docs/pdds/pdd21_namespaces.pod (Arbeitskopie) @@ -84,7 +84,7 @@

$P0 = get_root_namespace

-This root namespace is called C<'parrot'>. +This root namespace stringifies to the empty string.

=item HLL Root Namespaces

@@ -98,6 +98,8 @@

unicode encoding. The reasons for these restrictions is to allow compilers to remain completely ignorant of each other.

+Parrot internals are stored in the default HLL root namespace C<parrot>. +

=item HLL Implementation Namespaces

Each HLL must store implementation internals (private items) in an HLL

[barney]

Replying to barney: IMHO the change to PDD21 is not correct. I propose the following:

> 
> Index: docs/pdds/pdd21_namespaces.pod
> ===================================================================
> --- docs/pdds/pdd21_namespaces.pod      (Revision 34246)
> +++ docs/pdds/pdd21_namespaces.pod      (Arbeitskopie)
> @@ -84,7 +84,7 @@
> 
>    $P0 = get_root_namespace
> 
> -This root namespace is called C<'parrot'>.
> +This root namespace stringifies to the empty string.
> 
>  =item HLL Root Namespaces
> 
> @@ -98,6 +98,8 @@
>  unicode encoding.  The reasons for these restrictions is to allow compilers
>  to remain completely ignorant of each other.
> 
> +Parrot internals are stored in the default HLL root namespace C<parrot>.
> +
>  =item HLL Implementation Namespaces
> 
>  Each HLL must store implementation internals (private items) in an HLL

[whiteknight]

This change appears to have been made to the PDD. I'm closing this ticket.