xref: /freebsd/contrib/ntp/README.bk (revision 3642298923e528d795e3a30ec165d2b469e28b40)
1In order to use the BitKeeper repository version of NTP you will have
2to have the following tools installed:
3
4	autoconf	2.53 or later
5	automake	1.5 or later
6	lynx
7
8Lynx is used to generate the COPYRIGHT file.  Don't ask.
9
10You can get bitkeeper by visiting:
11
12	http://www.bitkeeper.com/
13
14We are using bitkeeper under their free license program.  You can use
15bitkeeper for free to access NTP, too.  If you have questions about this,
16please ask.  The license is pretty easy to read.
17
18Once you have installed bitkeeper, you can clone any NTP repository.
19
20	Note: as of 2002-05, ntp.bkserver.net and ntp.bkbits.net are
21	being upgraded.  Depending on the "phase" of the upgrade, one
22	of the two machines may not answer.
23
24You can get the ntp-stable repository by either of the following commands:
25
26     bk clone bk://www.ntp.org/home/bk/ntp-stable ntp-stable
27
28     bk clone bk://ntp.bkserver.net/ntp-stable ntp-stable
29
30     bk clone bk://ntp.bkbits.net/ntp-stable ntp-stable
31
32You can get the ntp-dev repository by either of the following commands:
33
34     bk clone bk://www.ntp.org/home/bk/ntp-dev ntp-dev
35
36     bk clone bk://ntp.bkserver.net/ntp-dev ntp-dev
37
38     bk clone bk://ntp.bkbits.net/ntp-dev ntp-dev
39
40If you are stuck behind a firewall that blocks access to the default port
41used by bitkeeper (14690) but you can use port 80 instead, you can use
42http as a bk transport mechanism.  Just use:
43
44     bk clone http://ntp.bkserver.net/REPO REPO
45
46Finally, it's possible to use SMTP as a bk transport mechanism.  So far, we
47haven't tried this.
48
49Once you have obtained the sources, do the following:
50
51	cd REPO
52	bk -r edit		to check out the files
53	autoreconf -f -i	generates configure and Makefile.in's
54
55and you should be ready to go.  You will get some warning messages from
56autoreconf.  Ignore these messages.
57
58You can update your repository by incanting:
59
60	cd REPO
61	bk pull
62
63If you want to submit patches, please see the README.hackers file.
64