develooper Front page | perl.perl5.porters | Postings from October 2011

Re: [perl #101976] [PATCH] Remove cruft from the module example

Thread Previous | Thread Next
Michael G Schwern
October 23, 2011 14:16
Re: [perl #101976] [PATCH] Remove cruft from the module example
Message ID:
On 2011.10.23 5:04 AM, H.Merijn Brand wrote:
>> * Remove %EXPORT_TAGS.  It's not explained and rarely used.
> I use them all the time in some corporate modules.

I have no doubt.  There's lots of features we use all the time which this
example does not and should not mention.

This is supposed to be a concise teaching example of My First Module and only
needs what is necessary to get a module working.  It's still too long.
There's plenty of confusion available for the first time module author without
bringing %EXPORT_TAGS into it.

That said, I'm sure the %EXPORT_TAGS docs in Exporter could use work.  To go
further, chopping out the tutorial from Exporter into Exporter::Tutorial and
leaving Exporter as API docs would make Exporter far easier to understand.

40. I do not have super-powers.
    -- The 213 Things Skippy Is No Longer Allowed To Do In The U.S. Army

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