RELEASE

Release Instructions - Netdisco

These is a rough outline of the netdisco release procedure.
The release mechanism is make controlled.  Please add to this
document and commit back if you find any discrepancies.

To start: Create a new directory (I call it package/) and copy the
RELEASE_Makefile to Makefile.  Or just `ln -s RELEASE_Makefile Makefile` and
use this dir.  Next check out the mibs and netdisco pacakges from a developer
login.  Never trust the anon servers.

Next run 'make version' and 'make mib-ver' to make sure the makefile is
behaving properly.

The distribution has only what's in CVS plus some generated
documentation.

Then follow the next steps.

PREP:
    0.  double check version number in netdisco and netdisco.pm
        Remove -cvs
    1.  cvs update / commit to sync all devel versions
    2.  Vi update README.pod, UPGRADE.pod, INSTALL.pod in doc/
        Commit changes to .pod's
    3.  created upgrade*.sql?
    4.  Update ChangeLog
    5.  make doc; and check that README, UPDATE and INSTALL are updated
    6.  cvs commit
    7.  cvs tag ver_0_9x
    8.  make dist
    9.  make dist_mib
    10. Double check all contents of the dist files for extra junk
        Especially temp files, files created automatically, dot-files
    11. Do a test install / beta testers, update INSTALL.pod and README.pod
        at least once then go back to #0 :-/

RELEASE:
    0. Submit to -devel for review and wait.
    1. upload to SF
        see: https://sourceforge.net/apps/trac/sourceforge/wiki/Release%20files%20for%20download
        in short:
            go to https://sourceforge.net/project/admin/explorer.php?group_id=80033
            create a new folder for the release VER (right click)
            scp <file.tar.gz> <user>,netdisco@frs.sourceforge.net:/home/frs/project/n/ne/netdisco/netdisco/<VER>
    2. ANNOUNCE to mailing lists / newsgroups
        (snmp-info-users,netdisco-users,mason-users)
    3. Update freshmeat
    4. Update netdisco.org
    5. Add news items on SF site
        Make sure to have links at the bottom of the news item
        to the release notes and the file download page.
    6. Update Demo site. (ouch)
    7. Watch the SF ranking sore for the next day or two :-)

Release Instructions - SNMP::Info

No files that are *not* in CVS and in the MANIFEST should be added to the
archive.  Make sure that generated file in t/ don't get added to the archive.
Make sure that the lib, blib, CVS dirs don't either.

PREP:
    0.  Check out the latest code via developer login
    1.  cd t && push_ver <version> if needed
    2   Check Authors and licenses are good, update copyrights
    3.  cvs stat && cvs commit as needed
    4.  Run perl Makefile.PL to create the Makefile
    5.  make test
    6.  Double check the MANIFEST is good by 
         3a. mv MANIFEST MANIFEST.cvs
         3b. make manifest
         3c. diff MANIFEST.cvs MANIFEST
         3d. modify and commit as needed
    7.  Check and update the DeviceMatrix.txt and ChangeLog
    8.  Update documentation in Info.pm that creates the README
    9.  cvs update -d again just in case
   10.  make README
   11.  Commit the README back.
   12.  cvs tag ver_2_x
   13.  make dist
   14.  unarchive it to a temp dir and check for all files
   15.  check for any extra files 
   16.  Try to install it.

RELEASE:
    1. Submit -beta version to beta testers / devel lists and wait (optional)
       for at least one person to eye-ball it.
    2. Submit to CPAN
        ftp to pause.perl.org/incoming
        wait
        grant co-maintainer to all other release developers at https://pause.perl.org/pause/authenquery?ACTION=share_perms
          for the new modules
    3. Submit to Source Forge
        Create the folder for the new version in the SF web interface (e.g. 2.04)
        scp snmp-info--VERSION.tar.gz README \
            YOU,snmp-info@frs.sourceforge.net:/home/frs/project/s/sn/snmp-info/snmp-info/VERSION/
    4. ANNOUNCE at Freshmeat / mailing lists / news groups
        (snmp-info-users, netdisco-users, comp.protocol.snmp, net-snmp-users)
    5. Add news items to SF.net for snmp-info
    6. Update snmp-info.sf.net website
        ssh -t YOU,snmp-info@shell.sourceforge.net create
        cd /home/groups/s/sn/snmp-info
        ./make_index
    7. Update netdisco.org if needed.
    
$Id$