Move up the section about upgrading pkgsrc system packages.
authorluxh <luxh@web>
Thu, 10 Mar 2011 17:10:20 +0000 (09:10 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Thu, 10 Mar 2011 17:10:20 +0000 (09:10 -0800)
docs/howtos/HowToPkgsrc.mdwn

index 52c3173..74b32ca 100644 (file)
@@ -224,7 +224,21 @@ This can be combined with other steps:
 
 ## Upgrading packages 
 
-There's a number of ways to upgrade pkgsrc; some of these are built in and some are packages installable with pkgsrc.  This list is not necessarily comprehensive. Be sure to read the note about upgrading pkgsrc system packages at the end of this subsection!
+There's a number of ways to upgrade pkgsrc; some of these are built in and some are packages installable with pkgsrc.  This list is not necessarily comprehensive.
+
+### Update pkgsrc system packages
+
+**Note**: Sometimes basic pkgsrc tools; *bmake*, *pkg_install* and *bootstrap-mk-files* need to be upgraded.  However, they can't be deleted and replaced since you need that tool to accomplish replacement.  The solution is to build a separate package before deletion, and install that package. 
+
+    # cd /usr/pkgsrc/devel/bmake
+    # env USE_DESTDIR=yes bmake package
+    # bmake clean-depends clean
+
+And go to the packages directory and install the binary package with
+
+    # cd /usr/pkgsrc/packages/All
+    # pkg_add -u <pkg_name> (i.e. the name of the .tgz file).
+
 
 ### bmake replace
 Performed in the `/usr/pkgsrc` directory that correlates with the installed package, the software is first built and then replaced.
@@ -234,7 +248,7 @@ Performed in the `/usr/pkgsrc` directory that correlates with the installed pack
 
 ### pkg_rolling-replace
 
-*pkg_rolling-replace* replaces packages one by one and one can use it for a better way of package management. Actually it does `bmake replace` on one package at a time, sorting the packages being replaced according to their interdependencies, which avoids most duplicate rebuilds. Once *pkg_rolling-replace* is installed you can update the packages through the following steps.
+*pkg_rolling-replace* replaces packages one by one and you can use it for a better way of package management. Actually it does `bmake replace` on one package at a time, sorting the packages being replaced according to their interdependencies, which avoids most duplicate rebuilds. Once *pkg_rolling-replace* is installed you can update the packages through the following steps.
 
     # cd /usr && make pkgsrc-update
     # pkg_rolling-replace -u
@@ -261,17 +275,6 @@ The above process removes all packages at once and installs the missing packages
 
 Point at a local or online binary archive location to download and update packages.
 
-#### Update pkgsrc system packages
-
-**Note**: Sometimes, basic pkgsrc tools, like *bmake* or *pkg_install*, need to be upgraded.  However, they can't be deleted and replaced since you need that tool to accomplish replacement.  The solution is to build a separate package before deletion, and install that package. Inside the packages directory (`/usr/pkgsrc/devel/bmake` in this case)
-
-    # env USE_DESTDIR=yes bmake package
-    # bmake clean-depends clean
-
-And go to the packages directory and install the binary package with
-
-    # pkg_add -u <pkg_name> (i.e. the name of the .tgz file).
-
 ## Start pkgsrc applications on system startup
 
 Packages often install rc.d scripts to control software running on startup.  To specify where the rc.d scripts from the installed packages should go, add the following lines to your `/usr/pkg/etc/mk.conf` file: