doc/release_steps.txt
author Tom Henderson <tomh@tomh.org>
Mon, 16 Jul 2007 22:49:48 -0700
changeset 932 249039a9ce73
parent 776 34d5715456b3
child 1286 4b90ad2ff1a0
permissions -rw-r--r--
update release checklist
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     1
Steps in doing an ns-3 release
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     2
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     3
1. prepare the source files
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     4
   - revise and check in AUTHORS, if needed
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     5
   - revise and check in RELEASE_NOTES
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     6
   - update and check in VERSION to the latest release number
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     7
2. make a new "architecture.pdf" document and place it in the doc/ directory
932
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
     8
3. add current version of waf script from subversion:
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
     9
   - svn checkout http://waf.googlecode.com/svn/tags/ns3/ waf
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    10
   - build waf script and put it into top of ns-3-dev
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    11
4. cd ns-3-dev; ./waf configure; ./waf dist
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    12
5. test tarball on release platforms (run-tests and simple-p2p)
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    13
6. tag ns-3-dev with "release ns-3.0.X"
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    14
  - hg tag "release ns-3.0.x"
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    15
  - hg push 
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    16
7. clone the tagged ns-3-dev and place it on the repository
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    17
  - ssh code.nsnam.org; sudo; su code;
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    18
  - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.0.x
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    19
  - cd /home/code/repos/ns-3.0.x/.hg and edit the hgrc appropriately
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    20
8. upload "ns-3.0.x.tar.bz2" to the releases/ directory on the server
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    21
9. update web page
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    22
   - add link to news.html
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    23
   - update download.html
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    24
   - update roadmap.html
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    25
   - build and update Doxygen directory on the server
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    26
   - update and upload software architecture document (PDF, HTML)
932
249039a9ce73 update release checklist
Tom Henderson <tomh@tomh.org>
parents: 776
diff changeset
    27
10. announce to ns-developers, with summary of release notes