I've been wrangling with the lack of documentation on how to start a module that one would expect CPAN inclusion at some point. Not that the docs aren't there, but there's nothing coherent to them and are spread throughout time and space, at least in the standard perl documentation space (including info from CPAN and PAUSE). While learning by example (other CPAN modules) works, it's not always intuitive. So I am considering at least putting a tutorial or a howto together on how to go about doing this, partially for myself, and partially for the community as a whole.
Note that if you have a better reference already, please let me know, I'd rather not reinvent the wheel.
Dr. Michael K. Neylon - mneylon-pm@masemware.com || "You've left the lens cap of your mind on again, Pinky" - The Brain
The steps, as I see it (and will be trying in the very near future) appear to go along these lines:
- Use "h2xs" to create a 'new' perl project within a new directory; if not using any lib stubs, the -X will only create perl files. This includes Makefile.PL, README, and test.pl
- Create/move the library files into place in this new directory, making sure to define $VERSION
- If tests are desired, either create them in test.pl, or delete test.pl, create a directory 't', and within 't', name any scripts that are part of the test suite as '*.t'.
- use "perl Makefile.PL" to create a unix-compat makefile.
- Edit README and other document files to liking.
- At this point, one has a nearly complete package; at this point, a program like CVS can be used to maintain version control.
- Use "make; make build; make test" to make sure everything works as expected, and edit as necessary.
- Use "make clean" to return to a distribution-ready directory structure.
- Distribute as necessary.
Dr. Michael K. Neylon - mneylon-pm@masemware.com || "You've left the lens cap of your mind on again, Pinky" - The Brain
|
---|
Replies are listed 'Best First'. | |
---|---|
Re: Starting the development of a module : thoughts
by btrott (Parson) on Jun 29, 2001 at 03:27 UTC | |
Re: Starting the development of a module : thoughts
by VSarkiss (Monsignor) on Jun 28, 2001 at 23:38 UTC | |
Re: Starting the development of a module : thoughts
by blakem (Monsignor) on Jun 29, 2001 at 02:09 UTC | |
Re: Starting the development of a module : thoughts
by lhoward (Vicar) on Jun 28, 2001 at 23:23 UTC | |
by runrig (Abbot) on Jun 29, 2001 at 00:44 UTC | |
Re: Starting the development of a module : thoughts
by dragonchild (Archbishop) on Jun 28, 2001 at 23:26 UTC | |
by Masem (Monsignor) on Jun 28, 2001 at 23:51 UTC |
Back to
Meditations