perlpolicy does not explain what a "maintenance branch" is before stipulating restrictions on it #15672
Comments
From @wchristianCreated by @wchristianWhile trying to read up something in the perlpolicy file i stumbled on the heading of "MAINTENANCE BRANCHES" within which the thing i was looking for was mentioned. However at no point before said heading, nor directly after it, is detailed what a maintenance branch actually is. It can be guessed from context, but i think explicit mention would be good. Perl Info |
From @jkeenanOn Wed Oct 19 07:52:29 2016, walde.christian@gmail.com wrote:
I figured I'd suggest some language to address this concern and next figured that it would be a good idea to discuss 'maintenance branch' in relation to releases of 'major versions' of Perl. It turns out, however, that we use the term 'major version' in two different ways in our documentation. (The following is not intended to be exhaustive.) 1. In 'pod/perlfaq1.pod', we have: ##### The current major release of Perl is Perl 5, first released in 1994. So in the above, '5' is a major version, the '24' in '5.24.x' is a minor version. And 'maintenance version' is any integer(s) in the 'x' position above. 2. In pod/perlpolicy.pod, we have: ##### In the above, 'major version' seems to mean '5.20', '5.22', '5.24' much more than simply '5'. I suspect that for those of us in P5P or otherwise involved in the development of Perl 5, 'Perl 5' is the language (Perl 6 is perhaps a "sister" language) and 5.24 is its current 'major version'. Now, since 'perlfaq*' is maintained CPAN-upstream, I can live with differences between those files and pod/perl*.pod. But I think we should be consistent in our terminology within the group of files maintained blead-upstream. I'm too sleeply to say more at this time, so let's get come comments from others. Thank you very much. -- |
|
The RT System itself - Status changed from 'new' to 'open' |
From @xsawyerxOn 10/22/2016 02:30 AM, James E Keenan via RT wrote:
We have "major", "minor", and "maintenance" as part of a version number. We also have "experimental" (or "development") and "stable", which are There is also the "Perl language", to which there is a major version, So, to try and clarify this, let's look at "5.22.2". Because 22 is an The only confusing part, IMHO, is that the maintenance release can be 0. I don't think I made it any clearer. :) |
Migrated from rt.perl.org#129917 (status was 'open')
Searchable as RT129917$
The text was updated successfully, but these errors were encountered: