Skip to content

Commit 10347ec

Browse files
committed
clarify that SETTING includes its outers
1 parent b28668d commit 10347ec

File tree

1 file changed

+7
-4
lines changed

1 file changed

+7
-4
lines changed

S02-bits.pod

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ Synopsis 2: Bits and Pieces
88

99
Created: 10 Aug 2004
1010

11-
Last Modified: 10 Apr 2015
12-
Version: 293
11+
Last Modified: 21 Apr 2015
12+
Version: 294
1313

1414
This document summarizes Apocalypse 2, which covers small-scale lexical
1515
items and typological issues. (These Synopses also contain updates to
@@ -2720,11 +2720,14 @@ coyotes.)
27202720
The file's scope is known as C<UNIT>, but there are one or more lexical
27212721
scopes outside of that corresponding to the linguistic setting (often known
27222722
as the prelude in other cultures). Hence, the C<SETTING> scope is
2723-
equivalent to C<UNIT::OUTER>. For a standard Perl program C<SETTING> is the
2723+
equivalent to C<UNIT::OUTERS>. For a standard Perl program C<SETTING> is the
27242724
same as C<CORE>, but various startup options (such as C<-n> or C<-p>) can
27252725
put you into a domain specific language, in which case C<CORE> remains the
27262726
scope of the standard language, while C<SETTING> represents the scope
2727-
defining the DSL that functions as the setting of the current file. See
2727+
defining the DSL that functions as the setting of the current file. When used
2728+
as a search term in the middle of a name, C<SETTING> includes all its outer scopes
2729+
up to C<CORE>. To get I<only> the setting's outermost scope, use C<UNIT::OUTER> instead.
2730+
See
27282731
also the C<-L>/C<--language> switch described in L<S19>. If a setting
27292732
wishes to gain control of the main execution, it merely needs to declare a
27302733
C<MAIN> routine as documented in S06. In this case the ordinary execution

0 commit comments

Comments
 (0)