Skip to content

Commit

Permalink
Excise "official" wording
Browse files Browse the repository at this point in the history
  • Loading branch information
perlpilot committed Apr 2, 2015
1 parent 093fdd7 commit 3eeab76
Showing 1 changed file with 11 additions and 11 deletions.
22 changes: 11 additions & 11 deletions S11-modules.pod
Original file line number Diff line number Diff line change
Expand Up @@ -394,8 +394,8 @@ Other than that, the semantics are identical to the direct form.
=head1 Versioning

Whenever an authority (such as a CPAN author or a company) posts a
compilation unit as part of an official distribution, or enters it into
any standard Perl 6 library, the module is required to declare its full
compilation unit as part of a distribution of Perl 6 code, or enters it into
any Perl 6 library, the module is required to declare its full
name so that installations can know its unique, immutable identity,
such that multiple versions by different authors can coexist, all of
them available to any installed version of Perl. (For the purposes of
Expand Down Expand Up @@ -499,12 +499,12 @@ the version lineage that was created first wins, unless overridden by
local policy or by official abandonment by the original auth (as
determined either by the author or by community consensus in case the
author is no longer available or widely regarded as uncooperative).
An officially abandoned lineage will be selected only if it is the
An abandoned lineage will be selected only if it is the
only available lineage of locally installed modules.

Once the auth is selected, then and only then is any version
selection done. This implies that all official compunits record
permanently when they were first installed in the official library,
selection done. This implies that all installed compunits record
permanently when they were first installed in the library,
and this creation date is considered immutable. This date can be specified
with the uppercase block typename CREATED. For example:

Expand Down Expand Up @@ -663,12 +663,12 @@ it make sense more often, some hierarchical authority-naming scheme
may be devised so that authorities can have temporary subauthorities
to hold branches without relinquishing overall naming authority.)

So anyway, the basic rule is this: you may import language tweaks
from your own private (user-library) code as you like; however, all
imports of language tweaks from the official library must specify
the exact interface version of the package.
So anyway, the basic rule is this: you may import language tweaks from
your own private (user-library as specified in @*INC) code as you like;
however, all imports of language tweaks from the installed Perl 6
library must specify the exact interface version of the package.

Such officially installed interface versions must be considered
Such installed interface versions must be considered
immutable on the language level, so that once any language-tweaking
compunit is in circulation, it may be presumed to represent a fixed
language change. By examination of these interface versions a language
Expand Down Expand Up @@ -710,7 +710,7 @@ The requirement for immutable interfaces extends transitively to
any packages imported by a language tweak module. There can be no
indeterminacy in the language definition either directly or indirectly.

It must be possible for any official compilation unit to be separately compiled
It must be possible for any compilation unit to be separately compiled
without knowledge of the lexical or dynamic context in which it will be
embedded, and this separate compilation must be able to produce a deterministic
profile of the interface. It must be possible to extract out the
Expand Down

0 comments on commit 3eeab76

Please sign in to comment.