From 2dd6f5a35a53bce8ba17b896d0b97a638e612121 Mon Sep 17 00:00:00 2001 From: Jim Cromie Date: Tue, 4 Sep 2007 21:56:19 -0600 Subject: [PATCH] Re: The path to the Release Message-ID: <46DE7D43.9040309@gmail.com> Doc patch to perlglossary, with tweaks. p4raw-id: //depot/perl@31791 --- pod/perlglossary.pod | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/pod/perlglossary.pod b/pod/perlglossary.pod index b274440..1663ad3 100644 --- a/pod/perlglossary.pod +++ b/pod/perlglossary.pod @@ -793,6 +793,17 @@ textual object, not to be confused with a L or L. "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, and notices are found in Ls, as well as various +other PODs. Coding practices that misuse features, such as C, can also be deprecated. + =item dereference A fancy computer science term meaning "to follow a L 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), 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 -- 2.7.4