1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
|
Developer Notes
===============
When incrementing the VERSION, do it in two places:
- TextToHTML.pm
- txt2html
This is because the version of the whole package is taken from the module,
and it would be very confusing if the script version was different,
considering they're distributed in the same bundle.
One also needs to change it in the README file.
One also needs to change the META tag in tfiles/good_*.html (the ones
that have a META tag) so that the version there matches the new current
version.
All new options need to be added in five places:
- TextToHTML.pm init_our_args(), to initialize the default
- TextToHTML.pm args() in the parse-the-array-ref part, unless
it is a simple option-with-a-value. If it is a boolean option,
it also needs to be added in its "no" form.
- TextToHTML.pm OPTIONS documentation
- txt2html Getopt call, including its type and possible shortnames
- txt2html OPTIONS documentation
If you want to change the location or name of the default system link
dictionary, it needs to be changed in four places:
- Makefile.PL
- TextToHTML.pm init_our_args()
- TextToHTML.pm OPTIONS documentation
- txt2html OPTIONS documentation
Release Notes
=============
Before releasing, don't forget to run
make
make test
make dist
(and usually "make install" as well)
This bundle is released in three different external places:
- CPAN
- Sourceforge
- FreshMeat
CPAN Release
------------
Log in to PAUSE, and browser-upload the .tar.gz file. Simple, huh?
Sourceforge Release
-------------------
Do a CVS commit if you haven't already.
Go to the Admin/Files section and follow the instructions.
You will need to ftp upload the .tar.gz file to upload.sourceforge.net
/incoming directory before doing certain steps.
One also needs to update the web-page. Cd to txt2html_web/htdocs on
your home machine, and edit index.html to update the version number.
Then do "make del_cpfiles". Then edit the Makefile to update the
version number. Then do
make cpfiles
make
cvs commit
Then log in to txt2html.sourceforge.net, cd to the
/home/groups/.../txt2html directory, and run "getweb" and this
will update the website from CVS.
One should also post a message to the mailing list.
FreshMeat Release
-----------------
Log in to freshmeat.net, and follow the instructions for new releases.
The "changes this release" will need to be a summary of the changes.
Since the file is on sourceforge, you won't need to alter the download
URL.
|