Index: chapter.xml
===================================================================
--- chapter.xml (revision 49829)
+++ chapter.xml (working copy)
@@ -1362,6 +1362,115 @@
may be found in its pkg-descr.
+
+ Upgrading Ports Using
+ <application>Synth</application>
+
+
+ synth
+
+
+ ports-mgmt/synth is the newest
+ utility for upgrading ports. It is a custom packge repository
+ builder for &os; and DragonFly.
+
+
+ Synth is currently only
+ available on the i386 and amd64 architectures.
+
+
+ From the ports-mgmt/synth
+ pkg-descr:
+
+ It is intended to replace Portmaster, portupgrade, and poudriere
+ for the average user. It is simple to learn (the powerful options
+ are limited in number) and user-friendly, but it is extremely fast
+ due to its parallel building capability. It will "drop-in" on any
+ system as it leverages the stock &man.pkg.8; facilities. All ports
+ are built in a clean environment, so it is finally safe to build
+ ports as needed on a live system. The default profile is the system
+ itself, not a new jail, which can be a valuable feature for some
+ environments.
+
+ To bring a system up-to-date only requires one command after the
+ ports tree is updated:
+
+ &prompt.root; synth upgrade-system
+
+ During the building process, a curses-based display will show
+ the status of all the builders and the entire bulk run process. A
+ dynamic and searchable web-based report is generated simultaneously.
+ Synth is intended to be grasped and utilized by novice users within
+ minutes, but offers most of the same powerful features as Poudriere
+ for the power users. Synth requires no preparation; it works
+ immediately upon installation.
+
+
+
+ Comparison of Tools To Upgrade Ports
+
+
+ ports
+ upgrading-tools-comparison
+
+
+ Here is a brief overview of how the tools compare. The
+ Advantages and Disadvantages
+ are completely subjective.
+
+
+ Upgrade Tools Comparison
+
+
+
+
+ Tool
+ Type
+ Build Dependencies
+ Advantages
+ Disadvantages
+
+
+
+
+
+ ports-mgmt/portmaster
+ individual port builder
+ None
+ Lightweight
+ Builds in-place, can fail and leave ports broken
+
+
+
+ ports-mgmt/portupgrade
+ individual port builder
+ Ruby
+ Lightweight
+ Builds in-place, can fail and leave ports broken
+
+
+
+ ports-mgmt/poudriere
+ package builder
+ Perl
+ Builds in clean environment
+ More build overhead, no ports config dialogs
+
+
+
+ ports-mgmt/synth
+ package builder
+ Ada
+ Builds in clean environment
+ More build overhead, no ports config dialogs; x86-only
+
+
+
+
+
+
+
+