format of the examples.
[ikiwiki.git] / docs / howtos / HowToDPorts / index.mdwn
index 3926144..0cfe296 100644 (file)
@@ -1,8 +1,8 @@
 # DPorts and pkgng
 
-Dports is DragonFly's own third-party software build system.  It is based on FreeBSD's Ports Collection.  Differences between ports and DPorts are intentionally kept to a minimum, both to maintain familiarity for mutual users of both operating systems and also to leverage the tremendous amount of work the FreeBSD contributors put into ports.  DPorts can and does feature ports unique to DragonFly, so it's truly a native system.
+DPorts is DragonFly's own third-party software build system.  It is based on FreeBSD's Ports Collection.  Differences between ports and DPorts are intentionally kept to a minimum, both to maintain familiarity for mutual users of both operating systems and also to leverage the tremendous amount of work the FreeBSD contributors put into ports.  DPorts can and does feature ports unique to DragonFly, so it's truly a native system.
 
-The __pkgng__ tool called "pkg" is a modern and fast binary package manager.  It was developed for FreeBSD, but PC-BSD used it in production first, followed soon after by DragonFly.  In the future, it will be the only binary package manager on FreeBSD, just it is the only port manager in DPorts.
+The __pkgng__ tool called "pkg" is a modern and fast binary package manager.  It was developed for FreeBSD, but PC-BSD used it in production first, followed soon after by DragonFly.  In the future, __pkgng__ will be the only binary package manager on FreeBSD, just as DPorts is the only port manager on DragonFly.
 
 __pkgng__ is not a replacement for port management tools like `ports-mgmt/portmaster` or `ports-mgmt/portupgrade`. While `ports-mgmt/portmaster` and `ports-mgmt/portupgrade` can install third-party software from both binary packages and DPorts, __pkgng__ installs only binary packages.  On the other hand, many people use __pkgng__ by itself and never install the optional portupgrade or portmaster tools.
 
@@ -38,17 +38,17 @@ Listen to the errors: hash out the packagesite line, save the file, and move on.
 
 There will be two lines in the file like this:
 
-    # Default Dports package server (California)
+    # Default DPorts package server (California)
     PACKAGESITE: http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST
 
 Hash out the offending line:
 
-    # Default Dports package server (California)
+    # Default DPorts package server (California)
     # PACKAGESITE: http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST
 
 Note that, as of time of writing, there are two working package repositories:
 
-    # Default Dports package server (California)
+    # Default DPorts package server (California)
     # PACKAGESITE: http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST
     
     # European mirrors
@@ -80,7 +80,7 @@ Test their performance---we will be using the fastest one.  This may, or may not
     19 packets transmitted, 19 packets received, 0.0% packet loss
     round-trip min/avg/max/stddev = 208.013/264.017/334.180/31.549 ms
 
-Now, navigate to `/usr/local/etc/pkg/repos/` and rename one of the configuration file samples you find there.  Edit the one you renamed:
+Now, navigate to `/usr/local/etc/pkg/repos/` and rename one of the configuration file samples you find there. `df-latest.conf` will make pkg use the newest available binaries while `df-release.conf` points to binaries built at the time of the release. The latter is frozen so you will not get any updates. Edit the one you renamed:
 
     # cd /usr/local/etc/pkg/repos/
     # ls
@@ -89,18 +89,18 @@ Now, navigate to `/usr/local/etc/pkg/repos/` and rename one of the configuration
     df-latest.conf.sample -> df-latest.conf
     # chmod -v 644 df-latest.conf
     df-latest.conf
-    # vim df-latest.conf
+    # vi df-latest.conf
 
-Enable whichever server was faster (Avalon is American, SchlundTech is German), and pkg+ to the url and mirror_type to SRV:
+Enable whichever server was faster (Avalon is American, SchlundTech is German), and pkg+ to the url and SRV to mirror_type:
 
     Avalon: {
-        url             : http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST,
+        url             : pkg+http://mirror-master.dragonflybsd.org/dports/${ABI}/LATEST,
         mirror_type     : SRV
         [...]
         enabled         : no
     }
     SchlundTech: {
-        url             : http://dfly.schlundtech.de/dports/${ABI}/LATEST,
+        url             : pkg+http://dfly.schlundtech.de/dports/${ABI}/LATEST,
         mirror_type     : SRV
         [...]
         enabled         : yes