1132451SrobertoSee README.hackers for notes on coding styles.
2132451Sroberto
3182007SrobertoThe master copy of this information can be found at:
4182007Sroberto
5200576Sroberto http://support.ntp.org/Dev/MaintainerIssues#How_to_work_on_a_bug_using_BitKe
6182007Sroberto
7132451SrobertoIf you are going to patch both ntp-stable and ntp-dev
8132451Srobertoplease do it this way:
9132451Sroberto
10132451Sroberto > cd ntp-stable
11132451Sroberto > (make and test your changes to ntp-stable first)
12132451Sroberto > (commit your changes to ntp-stable)
13132451Sroberto > cd ../ntp-dev
14132451Sroberto > bk pull ../ntp-stable	(get your changes from ntp-stable)
15132451Sroberto > (resolve any problems and test your changes)
16132451Sroberto > (commit your changes to ntp-dev)
17132451Sroberto
18132451SrobertoWith the current release of bitkeeper it is *much* easier to move changes
19132451Srobertofrom ntp-stable to ntp-dev than it is to move changes from ntp-dev to
20132451Srobertontp-stable.
21132451Sroberto
22132451SrobertoIf you make your changes in the above order and then submit them,
23132451Srobertoit will be trivial to apply your patches.
24132451Sroberto
25132451SrobertoOtherwise, it will be much more difficult to apply your patches.
26132451Sroberto
27182007SrobertoYou are pretty much done now if your repos are on pogo.udel.edu.
28182007Sroberto
29182007SrobertoIf these patches are for a bugzilla issue, mark the issue as Resolved/READY
30182007Srobertowith a comment of "Please pick up the patches in pogo:/wherever"
31182007Sroberto
32132451Sroberto---
33132451Sroberto
34132451SrobertoPlease read (and follow) the previous section if you want to submit
35132451Srobertopatches for both ntp-stable and ntp-dev.
36132451Sroberto
37182007SrobertoIf you cannot easily get your patches to pogo, you may submit patches
38182007Srobertovia the 'bk send' command:
39132451Sroberto
40132451Sroberto > cd REPO
41132451Sroberto > bk citool	(or bk ci ... ;  bk commit ... )
42132451Sroberto > bk pull	# make sure your repo is up-to-date
43132451Sroberto > bk send -d -ubk://www.ntp.org/home/bk/REPO - > file-containing-the-patch
44132451Sroberto > bk receive -vv -a < file-containing-the-patch
45132451Sroberto		# Sanity check.
46132451Sroberto
47132451Sroberto # Open a bugzilla item at <http://bugzilla.ntp.org>
48132451Sroberto
49132451Sroberto # After the bug is opened, visit the bug and attach file-containing-the-patch
50