doc/release_steps.txt
author Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
Fri, 26 Oct 2007 14:14:20 +0200
changeset 2036 0cb3c7151e89
parent 1789 39a56c382884
child 1797 7cd3c92af131
permissions -rw-r--r--
add missing copyright headers
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
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
     3
0. check out a clean ns-3-dev somewhere
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     4
1. prepare the source files
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     5
   - revise and check in AUTHORS, if needed
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     6
   - revise and check in RELEASE_NOTES
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     7
   - update and check in VERSION to the latest release number
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
     8
2. make a new "architecture.pdf" document and place it in the doc/ directory
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
     9
   of the ns-3-dev working directory
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    10
3. ./waf configure; ./waf dist
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    11
   - this will create a ns-3.0.x.tar.bz2 tarball
1286
4b90ad2ff1a0 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 932
diff changeset
    12
4. test tarball on release platforms (waf check and maybe some other scripts)
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    13
5. once you are happy with the tarball, tag ns-3-dev with "release ns-3.0.X"
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    14
   - hg tag "release ns-3.0.x"
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    15
   - hg push 
1286
4b90ad2ff1a0 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 932
diff changeset
    16
6. clone the tagged ns-3-dev and place it on the repository
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    17
   - ssh code.nsnam.org; sudo; su code;
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    18
   - cp -r /home/code/repos/ns-3-dev /home/code/repos/ns-3.0.x
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    19
   - cd /home/code/repos/ns-3.0.x/.hg and edit the hgrc appropriately
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    20
7. upload "ns-3.0.x.tar.bz2" to the /var/www/html/releases/ directory on 
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    21
   the www.nsnam.org server
1286
4b90ad2ff1a0 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 932
diff changeset
    22
8. update web page
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    23
   - add link to news.html
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    24
   - update getting_started.html
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    25
   - update documents.html
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    26
   - update roadmap on wiki
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    27
   - build and update Doxygen directory on the server
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    28
     -- ssh www.nsnam.org; sudo tcsh; su nsnam;
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    29
     -- ~/bin/update-doxygen-release
776
34d5715456b3 release_steps.txt document
Tom Henderson <tomh@tomh.org>
parents:
diff changeset
    30
   - update and upload software architecture document (PDF, HTML)
1789
39a56c382884 more detail in release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 1286
diff changeset
    31
     -- note:  HTML image generation is not currently automatic
1286
4b90ad2ff1a0 update release_steps.txt
Tom Henderson <tomh@tomh.org>
parents: 932
diff changeset
    32
9. announce to ns-developers, with summary of release notes