From a700883cb9b7b7280b0833ebacc31170fa4e32a8 Mon Sep 17 00:00:00 2001 From: Sascha Wildner Date: Mon, 1 Dec 2008 02:45:30 +0100 Subject: [PATCH] Update some documents for git usage. --- UPDATING | 32 ++++--------------------- nrelease/root/README | 57 +++++++++++++++++++------------------------- 2 files changed, 30 insertions(+), 59 deletions(-) diff --git a/UPDATING b/UPDATING index 351792acc0..34b9cfc52f 100644 --- a/UPDATING +++ b/UPDATING @@ -15,31 +15,8 @@ + GENERAL + +-----------------------------------------------------------------------+ -The best way to upgrade DragonFly is to maintain a copy of the DragonFly -CVS repository via cvsup and to checkout the source base via this repository. -The repository is stored in /home/dcvs by default and requires about 800MB -of disk space. The checked out source tree (/usr/src) requires about 400MB -of disk space, and the build will eat around 800MB of space out of /usr/obj. -To maintain the build you should reserve at least 2.5GB of disk space, and -3.5GB if you have the space. - -Note: most people run cvsup via a root cron job to keep the repository up to -date. Please limit such automatic updates to once a day and try to randomize -the hour and minute in the cron job a bit to avoid pileups. - - # get the CVS repository (it is placed in /home/dcvs) - cvsup /usr/share/examples/cvsup/DragonFly-cvs-supfile - # install the source from the CVS hierarchy - cd /usr - cvs -R -d /home/dcvs checkout -P src - -Once you have the repository and broken out sources you can decide whether to -update your sources from the repository automatically or manually. Since -you are tracking changes made to DragonFly, it is usually a good idea to -update the sources manually: - - cd /usr/src - cvs update -dP +Instructions on how to obtain and maintain DragonFly source code using git +are in the development(7) manual page. To upgrade a DragonFly system from sources you run the following sequence: @@ -55,12 +32,13 @@ older DragonFly installations and should delete them automatically. make upgrade +See the build(7) manual page for further information. + Once you've done a full build of the world and kernel you can do incremental upgrades of either by using the 'quickworld' and 'quickkernel' targets instead of 'buildworld' and 'buildkernel'. If you have any problems with -the quick targets, try doing a cvsup, cvs update, and then a full buildworld +the quick targets, try updating your repo first, and then a full buildworld and buildkernel as shown above, before asking for help. -See also build(7) and development(7) manual pages. +-----------------------------------------------------------------------+ + UPGRADING FROM DRAGONFLY <= 2.0 TO DRAGONFLY >= 2.1 + diff --git a/nrelease/root/README b/nrelease/root/README index 4eb047644d..bf7f0e9044 100644 --- a/nrelease/root/README +++ b/nrelease/root/README @@ -258,42 +258,35 @@ the network. - USING CVSUP TO OBTAIN A CVS TREE AND DOING BUILDWORLDS - - cvsup can be used to obtain the DragonFly cvs repository. 'man cvsup' - for more information on its capabilities. cvsup is a package (not part - of the base system), but it IS included on the CD. The cvsup example - files are in /usr/share/examples/cvsup. You will primarily be interested - in the DragonFly CVS repository, DragonFly-cvs-supfile. Once you have - done the initial cvsup of the blocks of data that you want you may wish - to create a cron job to keep it all up to date. However, please do not - run an unattended cvsup more than once a day. - - # get the CVS repository (it is placed in /home/dcvs) - cvsup /usr/share/examples/cvsup/DragonFly-cvs-supfile - # install the source from the CVS hierarchy - cd /usr - cvs -R -d /home/dcvs checkout src - - # buildworld and installworld examples - # + USING GIT TO OBTAIN A SOURCE TREE AND DOING BUILDWORLDS + + Instructions on how to obtain and maintain DragonFly source code using + git are in the development(7) manual page. + + To upgrade a DragonFly system from sources you run the following + sequence: + cd /usr/src make buildworld + make buildkernel KERNCONF= + make installkernel KERNCONF= make installworld - # buildkernel and installkernel examples. Create your own custom kernel - # config in /usr/src/sys/config/ and you can build and - # install custom kernels. - # - # WARNING! Always keep a fully working backup kernel in / in case - # you blow it. Remember that /kernel.old is overwritten when you - # make installkernel. It is usually a good idea to maintain an emergency - # kernel as /kernel.GENERIC or /kernel.bak. If all else fails you can - # still fall back to booting the CD. - # - cd /usr/src - make buildkernel KERNCONF=GENERIC - make installkernel KERNCONF=GENERIC + You will also want to run the 'upgrade' target to upgrade your /etc + and the rest of your system. The upgrade target is aware of stale + files created by older DragonFly installations and should delete them + automatically. + + make upgrade + + See the build(7) manual page for further information. + + Once you've done a full build of the world and kernel you can do + incremental upgrades of either by using the 'quickworld' and + 'quickkernel' targets instead of 'buildworld' and 'buildkernel'. If + you have any problems with the quick targets, try updating your repo + first, and then a full buildworld and buildkernel as shown above, before + asking for help. OBTAINING A PKGSRC TREE TO BUILD/INSTALL PACKAGES -- 2.41.0