From: Jim Cromie Date: Wed, 5 Sep 2007 03:56:19 +0000 (-0600) Subject: Re: The path to the Release X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=2dd6f5a35a53bce8ba17b896d0b97a638e612121;p=p5sagit%2Fp5-mst-13.2.git Re: The path to the Release Message-ID: <46DE7D43.9040309@gmail.com> Doc patch to perlglossary, with tweaks. p4raw-id: //depot/perl@31791 --- 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