summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJim Cromie <jcromie@cpan.org>2007-09-04 21:56:19 -0600
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2007-09-05 10:34:42 +0000
commit2dd6f5a35a53bce8ba17b896d0b97a638e612121 (patch)
tree72459ff514f0126974df0f5e961bdcc16e0f7828
parent038c294adf193153c2760ff49fadaf6fffc4ea93 (diff)
downloadperl-2dd6f5a35a53bce8ba17b896d0b97a638e612121.tar.gz
Re: The path to the Release
Message-ID: <46DE7D43.9040309@gmail.com> Doc patch to perlglossary, with tweaks. p4raw-id: //depot/perl@31791
-rw-r--r--pod/perlglossary.pod22
1 files changed, 22 insertions, 0 deletions
diff --git a/pod/perlglossary.pod b/pod/perlglossary.pod
index b27444023c..1663ad3836 100644
--- a/pod/perlglossary.pod
+++ b/pod/perlglossary.pod
@@ -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