perl5 icon indicating copy to clipboard operation
perl5 copied to clipboard

Need definition for 'construct' (noun) for use in documentation

Open jkeenan opened this issue 2 months ago • 1 comments

As part of my research on Fatalization of currently deprecated goto construct I have been re-reading our current documentation of goto in blead and have been trying to locate in our test suite examples of each claim made in that documentation. What we find -- or fail to find -- there will have an impact on the documentation updates provided as part of a pull request like the current https://github.com/Perl/perl5/pull/23782. I've posted the preliminary results of that documentation review here.

This is the sixth in a series of GH issues addressing the items which I believe are lacking in that documentation.

perldoc -f goto states:

Use of "goto LABEL" or "goto EXPR" to jump into a construct is
deprecated and will issue a warning; it will become a fatal
error in Perl 5.42. While still available, it may not be used to
go into any construct that requires initialization, such as a
subroutine, a "foreach" loop, or a "given" block. 

"[C]onstruct" (as a noun) is a vague term for which we have no definition -- but we use it a lot:

$ ack -i '\bconstruct\b' pod | ack -v delta

Discuss whether we should have a definition and what it should be.

jkeenan avatar Oct 04 '25 17:10 jkeenan