change for git
authormatthias <matthias@web>
Wed, 18 Feb 2009 18:38:36 +0000 (10:38 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Wed, 18 Feb 2009 18:38:36 +0000 (10:38 -0800)
docs/handbook/handbook-updating-using.mdwn

index 2af4c67..c477480 100644 (file)
@@ -1,30 +1,26 @@
-\r
-\r
-## Configuration \r
-\r
-cvsup is guided by a configuration file that describes what files to update, and the source from which to update them.\r
-\r
-Here is a basic DragonFly cvsup configuration file:\r
-\r
-    \r
-    
-*default host=cvsup.dragonflybsd.org\r
-    *default base=/usr\r
-    *default prefix=/usr\r
-    *default release=cvs\r
-    *default release#cvs tag.\r
-    *default delete use-rel-suffix\r
-    *default compress\r
-
-    \r
-    cvs-src\r
-\r
-\r
-Alternately, the file `/usr/share/examples/cvsup/DragonFly-src-supfile` can be used as-is to update system source.\r
-\r
-Run cvsup using `/usr/share/examples/cvsup/DragonFly-src-supfile` as an argument or with a separate file containing the above example text. Your system source files will be updated.\r
-\r
-\r
-\r
-CategoryHandbook\r
-CategoryHandbook-updating\r
+
+
+## Configuration 
+
+
+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`).
+cvsup is guided by a configuration file that describes what files to update, and the source from which to update them.
+
+
+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`:
+
+    # cd /usr
+    # make help         # get help
+    # make git-clone  # initial setup
+    # make git-update
+
+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):
+
+    # cd /usr
+    # git clone -o chlamydia git://chlamydia.fs.ei.tum.de/dragonfly.git src
+    # cd src
+
+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):
+
+    # cd /usr/src
+    # git pull