c4774803f50ea7d44c75346d666b4b06c8a602bc
[ikiwiki.git] / docs / handbook / handbook-updating-using.mdwn
1
2
3 ## Configuration 
4
5
6 DragonFly uses the git(1) distributed revision control system.  If it is not already on the system, it needs to be installed via pkgsrc(7) (`/usr/pkgsrc/devel/scmgit`).
7 cvsup is guided by a configuration file that describes what files to update, and the source from which to update them.
8
9
10 A fresh copy of the repository can be cloned anywhere.  Note that the directory to clone into (`/usr/src` in the following example) must not exist, so all previous work in this directory has to be saved and the directory be removed prior to cloning. Simple setup and updating of local repository is done using `/usr/Makefile`:
11
12     # cd /usr
13     # make help  # get help
14     # make git-clone  # initial setup
15     # make git-update
16
17 Somewhat finer control can be achieved using git(1) directly: To clone the repository and check out the master branch (this will take some time):
18
19     # cd /usr
20     # git clone -o chlamydia git://chlamydia.fs.ei.tum.de/dragonfly.git src
21     # cd src
22
23 The repository can be held up to date by pulling frequently (to set up a cron(8) job, git(1)'s `--git-dir` option can be used):
24
25     # cd /usr/src
26     # git pull