contrib/ntp/README.bk

   1 In order to use the BitKeeper repository version of NTP you will have
   2 to have the following tools installed:
   3
   4         autoconf        2.53 or later
   5         automake        1.5 or later
   6         lynx
   7
   8 Lynx is used to generate the COPYRIGHT file.  Don't ask.
   9
  10 You can get bitkeeper by visiting:
  11
  12         http://www.bitkeeper.com/
  13
  14 We are using bitkeeper under their free license program.  You can use
  15 bitkeeper for free to access NTP, too.  If you have questions about this,
  16 please ask.  The license is pretty easy to read.
  17
  18 Once 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
  24 You 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
  32 You 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
  40 If you are stuck behind a firewall that blocks access to the default port
  41 used by bitkeeper (14690) but you can use port 80 instead, you can use
  42 http as a bk transport mechanism.  Just use:
  43
  44      bk clone http://ntp.bkserver.net/REPO REPO
  45
  46 Finally, it's possible to use SMTP as a bk transport mechanism.  So far, we
  47 haven't tried this.
  48
  49 Once 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
  55 and you should be ready to go.  You will get some warning messages from
  56 autoreconf.  Ignore these messages.
  57
  58 You can update your repository by incanting:
  59
  60         cd REPO
  61         bk pull
  62
  63 If you want to submit patches, please see the README.hackers file.