develooper Front page | perl.perl5.porters | Postings from June 2016

[perl #128200] documentation shouldn't recommend usenet

Thread Previous
From: via RT
June 12, 2016 13:14
[perl #128200] documentation shouldn't recommend usenet
Message ID:
On Wed Jun 08 19:29:48 2016, wrote:
> We have much consensus but no patches or commits yet. I have attached
> two in the hopes of closing this.


> The first one is easy - my only question here is that I thought all
> the .SH files like myconfig.SH were automatically generated, but I
> can't figure out where from. So please just sanity check that that is
> a file that I can modify.

My understanding is that foo.SH files are templates for generating foo. So patching myconfig.SH should be OK.

> The second one patches a comment in DynaLoader/dl_dlopen.xs, not sure
> if that's appropriate.

Looks OK to me.

But about your first patch:

Your change to INSTALL results in:

| more quickly. But first you should read the advice in this file,
| carefully re-read the error message and check the relevant manual pages
| on your system, as these may help you find an immediate solution.
| get advice. Once you've exhausted the documentation, please report
| bugs to us using the 'perlbug' tool.

That "get advice." in there looks wrong. Did you mean to delete it instead?

And perlnewmod.pod:

| =item Discuss the need
| You might love it. You might feel that everyone else needs it. But there
| might not actually be any real demand for it out there.
| =item Choose a name

Well, there's not much discussion left in that paragraph. :-)

If we don't have any place to recommend for discussion, we should just remove the whole section.

via perlbug:  queue: perl5 status: open

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