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

[perl #128200] documentation shouldn't recommend usenet

Thread Previous
From:
l.mai@web.de via RT
Date:
June 12, 2016 13:14
Subject:
[perl #128200] documentation shouldn't recommend usenet
Message ID:
rt-4.0.18-32391-1465737253-1043.128200-15-0@perl.org
On Wed Jun 08 19:29:48 2016, dcollinsn@gmail.com wrote:
> We have much consensus but no patches or commits yet. I have attached
> two in the hopes of closing this.

Great!

> 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
https://rt.perl.org/Ticket/Display.html?id=128200

Thread Previous


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