develooper Front page | perl.perl5.porters | Postings from November 2010

Re: Documentation for ${^GLOBAL_PHASE}

Thread Next
From:
Chas. Owens
Date:
November 2, 2010 07:37
Subject:
Re: Documentation for ${^GLOBAL_PHASE}
Message ID:
AANLkTin9M5LrDUOhTOM-6G6xMiyswRSmut2v5h5d5V87@mail.gmail.com
On Mon, Nov 1, 2010 at 10:55, Chas. Owens <chas.owens@gmail.com> wrote:
> On Mon, Nov 1, 2010 at 02:14, Florian Ragwitz <rafl@debian.org> wrote:
> snip
>> Obviously it needs an entry in perlvar, but I don't think explaining
>> all the details of it there is appropriate. "BEGIN, UNITCHECK, CHECK,
>> INIT and END" in perlmod explains many things related to
>> ${^GLOBAL_PHASE}, but it does so from the perspective of a single
>> module, i.e. one compilation unit, for which most of the behaviour of
>> the new variable is irrelevant, as that's only concert with global
>> phases. Also it'd seem somewhat unlikely that anyone would look up
>> "perlmod - Perl modules (packages and symbol tables)" to read about the
>> phases of the interpreter.
> snip
>
> My gut reaction is that the values need to be documented in perlvar in
> a similar way to how you have listed them here and a mention of it
> should be in each paragraph of perlmod that deals with BEGIN, INIT,
> etc.  I will throw something together tonight.
snip

I have attached my first draft of the documentation (they include
brian d foy's changes from last night).

Also attached is a patch that adds a mention of the fact that string
do and require behave the same way as string eval with respect to UNIT
and INIT blocks.

-- 
Chas. Owens
wonkden.net
The most important skill a programmer can have is the ability to read.

Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About