add BXR.SU
[ikiwiki.git] / docs / newhandbook / pkgsrc / index.mdwn
index c9c6669..5f30425 100644 (file)
@@ -1,8 +1,6 @@
-
-
 # Installing Applications using NetBSD's pkgsrc framework 
 
-
+[[!toc  levels=3]]
 <!-- XXX: possibly also mention pkgin and other fancy stuff. -->
 
 
@@ -435,7 +433,7 @@ For users which cannot be connected all the time, the `bmake fetch` option is pr
 
 
 
-In some rare cases, users may need to acquire the tarballs from a site other than the `MASTER_SITES` (the location where files are downloaded from). You can override the `MASTER_SORT`, `MASTER_SORT_REGEX` and `INET_COUNTRY` options either within the `/etc/mk.conf`.
+In some rare cases, users may need to acquire the tarballs from a site other than the `MASTER_SITES` (the location where files are downloaded from). You can override the `MASTER_SORT`, `MASTER_SORT_REGEX` and `INET_COUNTRY` options either within the `/usr/pkg/etc/mk.conf`.
 
 
 
@@ -451,7 +449,7 @@ In some rare cases, users may need to acquire the tarballs from a site other tha
 
 
 
- To change the build process, either change the values of PKG_DEFAULT_OPTIONS or PKG_OPTIONS.`***PackageName***` in `/etc/mk.conf` or on the commandline as so:
+ To change the build process, either change the values of PKG_DEFAULT_OPTIONS or PKG_OPTIONS.`***PackageName***` in `/usr/pkg/etc/mk.conf` or on the commandline as so:
 
 
 
@@ -509,20 +507,28 @@ Using the pkgsrc collection can definitely eat up your disk space. For this reas
 
  **Note:** Once you have updated your pkgsrc collection, before attempting a package upgrade, you should check the `/usr/pkgsrc/UPDATING` file. This file describes various issues and additional steps users may encounter and need to perform when updating a port.
 
+There are multiple ways to upgrade your installed packages.
 
+ **Traditional way:** 
 
 Keeping your packages up to date can be a tedious job. For instance, to upgrade a package you would go to the package directory, build the package, deinstall the old package , install the new package, and then clean up after the build. Imagine doing that for five packages, tedious right? This was a large problem for system administrators to deal with, and now we have utilities which do this for us. For instance the `pkg_chk` utility will do everything for you!
 
-
+ **Using `pkg_chk` utility:** (from both _source_ & _binary_ packages)
 
 pkg_chk requires a few steps in order to work correctly. They are listed here.
 
     # pkg_chk -g # make initial list of installed packages
     # pkg_chk -r  # remove all packages that are not up to date and packages that depend on them
-    # pkg_chk -a  # install all missing packages (use binary packages, this is the default
+    # pkg_chk -a  # install all missing packages (use binary packages, this is the default)
     # pkg_chk -as # install all missing packages (build from source)
 
-The above process removes all packages at once and installs the missing packages one by one.This can cause longer disruption of services when the removed package has to wait a long time for its turn to get installed. "pkg_rolling-replace" replaces packages one by one and one can use it for a better way of package management. You can install "pkg_rolling-replace" by the following procedure.
+The above process removes all packages at once and installs the missing packages one by one.This can cause longer disruption of services when the removed package has to wait a long time for its turn to get installed. 
+
+ **Using `pkg_rolling-replace` utility:** (from only _source_)
+
+"pkg_rolling-replace" replaces packages one by one and one can use it for a better way of package management. You can install "pkg_rolling-replace" by the following procedure.
+
+Actually it does `make replace` on one package at a time, sorting the packages being replaced according to their interdependencies, which avoids most duplicate rebuilds.
 
     # cd /usr/pkgsrc/pkgtools/pkg_rolling-replace/
     # bmake install
@@ -533,7 +539,7 @@ Once pkg_rolling-replace is installed you can update the packages through the fo
     # pkg_rolling-replace -u
 
 If some package like "bmake" does not get updated and throws an error during the above steps you can update it manually.
-Inside the packages directory (devel/bmake in this case)
+Inside the packages directory (/usr/pkgsrc/devel/bmake in this case)
 
     # env USE_DESTDIR=full bmake package
     # bmake clean-depends clean
@@ -542,14 +548,22 @@ 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).
 
-Also you can use "pkgin" to update software using binary packages just like apt or yum.
+ **Using `pkgin` utility:** (from only _binary packages_)
+
+You can also use "pkgin" to update software using binary packages just like apt or yum.
 
     # cd /usr/pkgsrc/pkgtools/pkgin/
     # bmake install
 
 Once "pkgin" is installed edit "/usr/pkg/etc/pkgin/repositories.conf" to contain the line ( for i386 packages ).
 
-    http://avalon.dragonflybsd.org/packages/i386/DragonFly-2.5/stable/All
+    http://avalon.dragonflybsd.org/packages/i386/DragonFly-2.6/stable/All
+
+and
+
+    http://avalon.dragonflybsd.org/packages/x86_64/DragonFly-2.6/stable/All/
+
+( for x86_64 packages )
 
 Then you can run the following commands to get the packages updated.