develooper Front page | perl.perl5.porters | Postings from May 2012

[perl #47027] Documentation: BEGIN, END docs in wrong section

Thread Previous | Thread Next
From:
James E Keenan via RT
Date:
May 3, 2012 18:51
Subject:
[perl #47027] Documentation: BEGIN, END docs in wrong section
Message ID:
rt-3.6.HEAD-4610-1336096254-383.47027-15-0@perl.org
On Tue Oct 30 08:01:32 2007, denis.howe@gmail.com wrote:
> 
> This is a bug report for perl from denis.howe@gmail.com,
> generated with the help of perlbug 1.35 running under perl v5.8.8.
> 
> -----------------------------------------------------------------
> 
> The section "BEGIN, CHECK, INIT and END" in the
> "perlmod" docs has nothing to do with modules and should
> be moved to the "perlsyn" "Compound Statements" section
> where any reasonable person would expect to find it.
> 
> -----------------------------------------------------------------

Reviewing this older ticket tonight, I note that there was some
back-and-forth as to a better place to put documentation of these named
blocks:  perlsyn, perlsub and perlcompile were all mentioned.

However, the facts that (a) no one ever submitted any patches for any of
these ideas; (b) the thread petered out over four years ago suggest that
we don't have a compelling reason to move this out of perlmod.

Do people agree with that argument?  If so, we can put this ticket out
of its misery.

Thank you very much.
Jim Keenan

---
via perlbug:  queue: perl5 status: open
https://rt.perl.org:443/rt3/Ticket/Display.html?id=47027

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About