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

[perl #114280] Carp's longmess() and shortmess() should be documented

Thread Next
James E Keenan via RT
July 26, 2012 16:12
[perl #114280] Carp's longmess() and shortmess() should be documented
Message ID:
On Thu Jul 26 07:49:59 2012, wrote:
> This is a bug report for perl from,
> generated with the help of perlbug 1.39 running under perl 5.16.0.
> -----------------------------------------------------------------
> The documentation for these functions were largely removed in commit
> d735c2efe0b08b05adfb893625476bf4480a2ece (there's still one place
> mentioning "longmess" without any further explanation).
> In the discussion in
> the removal was explained:
> | - Removed documentation of shortmess and longmess.  Unfortunately
> | longmess doesn't do anything particularly reasonable, and it can't
>    be
> | made to do so because of backwards compatibility with code that
> | depended on the old behaviour.
> However, longmess() and shortmess() are still exported. 

Confirmed.  Any identifier which is exportable must be documented.

> And there's a
> lot of code which is still using longmess(). Just try "git grep
> Carp::longmess" in perl's source code, and I assume that many CPAN
> modules are also using longmess(). 

See attachment for results of:  ack -l 'Carp::(long|short)mess' *

> So for me it looks like longmess()
> *is* doing something reasonable.
> My suggestion is to restore the documentation, or to at least mention
> the functions, and explain the shortcomings if there are any.


via perlbug:  queue: perl5 status: new

Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About