This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Re: The path to the Release
authorJim Cromie <jcromie@cpan.org>
Wed, 5 Sep 2007 03:56:19 +0000 (21:56 -0600)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Wed, 5 Sep 2007 10:34:42 +0000 (10:34 +0000)
Message-ID: <46DE7D43.9040309@gmail.com>

Doc patch to perlglossary, with tweaks.

p4raw-id: //depot/perl@31791

pod/perlglossary.pod

index b274440..1663ad3 100644 (file)
@@ -793,6 +793,17 @@ textual object, not to be confused with a L</separator> or
 L</terminator>.  "To delimit" really just means "to surround" or "to
 enclose" (like these parentheses are doing).
 
+=item deprecated modules and features
+
+Deprecated modules and features are those which were part of a stable
+release, but later found to be subtly flawed, and which should be avoided.
+They are subject to removal and/or bug-incompatible reimplementation in
+the next major release (but they will be preserved through maintainance
+releases).  Deprecation warnings are issued under B<-w> or C<use
+diagnostics>, and notices are found in L<perldelta>s, as well as various
+other PODs. Coding practices that misuse features, such as C<my $foo if
+0>, can also be deprecated.
+
 =item dereference
 
 A fancy computer science term meaning "to follow a L</reference> to
@@ -862,6 +873,17 @@ A standard, bundled release of a system of software.  The default
 usage implies source code is included.  If that is not the case, it
 will be called a "binary-only" distribution.
 
+=item (to be) dropped modules
+
+When Perl 5 was first released (see L<perlhistory>), several modules were
+included, which have now fallen out of common use.  It has been suggested
+that these modules should be removed, since the distribution became rather
+large, and the common criterion for new module additions is now limited to
+modules that help to build, test, and extend perl itself.  Furthermore,
+the CPAN (which didn't exist by the time of Perl 5.0) can become a new
+home dropped modules. Dropping modules is currently not an option, but
+further developments may clear the last barriers.
+
 =item dweomer
 
 An enchantment, illusion, phantasm, or jugglery.  Said when Perl's