Re: Reporting a Bug in Core Documentation

[BrowserUk]

Here's the problem. Under perldelta (5.18.0) - Updated Modules and Pragmata, the entry for Scalar::Util includes information on functions from List::Util (i.e. sum, first and reduce).

List::Util & Scalar::Util are both actually distributed as a single package called Scalar-List-Utils.

[kcott]

Thanks for the reply. Yes, I did notice they were bundled in the one package.

I get the feeling that you're implying something beyond simply stating that they're bundled together; however, if you are, I'm not sure what it is. Are you, for instance, suggesting that the entry should appear something like

• List::Util and Scalar::Util have both been upgraded to version 1.27.

  ...

rather than having separate entries for the two modules?

My intention was only to report that List::Util functions appeared under a Scalar::Util heading. My problem was that I wasn't sure if perlbug was the correct tool for the job.

[BrowserUk]

I get the feeling that you're implying something

Mostly just informational. Only that it may be intentional to treat the two modules as a single package.

That's not to say it would not be better if both modules were treated separately; or at least both mention in the section header.

I'm also unsure whether it is worth changing a delta document that becomes (kind of) redundant with the next release. But then again, a report might mean an improvement if the package requires a mention in the next delta.

As far as I am aware (but don't definitively know; hence why I didn't comment on that first time around), perlbug is the right vehicle for doc changes. But I'd wait for someone who has had one accepted (or one of those that might accept or reject them) to reply before going ahead with it.