author | Mathieu Lacage <mathieu.lacage@sophia.inria.fr> |
Fri, 26 Oct 2007 22:10:52 +0200 | |
changeset 2040 | 3436ba2b4bf4 |
parent 1789 | 39a56c382884 |
child 1797 | 7cd3c92af131 |
permissions | -rw-r--r-- |
776 | 1 |
Steps in doing an ns-3 release |
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 | 4 |
1. prepare the source files |
5 |
- revise and check in AUTHORS, if needed |
|
6 |
- revise and check in RELEASE_NOTES |
|
7 |
- update and check in VERSION to the latest release number |
|
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 | 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 | 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 | 22 |
8. update web page |
776 | 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 | 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 | 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 | 32 |
9. announce to ns-developers, with summary of release notes |