Ticket #80 (closed todo: fixed)

Opened 6 years ago

Last modified 6 years ago

document the default HLL root namespace

Reported by: barney Owned by: whiteknight
Priority: normal Milestone:
Component: docs Version:
Severity: low Keywords:
Cc: Language:
Patch status: Platform:

Description

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.

Change History

  Changed 6 years ago by whiteknight

  • owner set to whiteknight

  Changed 6 years ago by whiteknight

  • status changed from new to assigned

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

follow-up: ↓ 4   Changed 6 years ago by 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

in reply to: ↑ 3   Changed 6 years ago by 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

  Changed 6 years ago by whiteknight

  • status changed from assigned to closed
  • resolution set to fixed

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

Note: See TracTickets for help on using tickets.