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

[perl #128200] documentation shouldn't recommend usenet

Thread Next
From:
Father Chrysostomos via RT
Date:
June 12, 2016 13:29
Subject:
[perl #128200] documentation shouldn't recommend usenet
Message ID:
rt-4.0.18-8272-1465738158-419.128200-15-0@perl.org
On Sun Jun 12 06:14:13 2016, mauke- wrote:
> 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.

What about the module-authors mailing list?

-- 

Father Chrysostomos


---
via perlbug:  queue: perl5 status: open
https://rt.perl.org/Ticket/Display.html?id=128200

Thread Next


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