From owner-freebsd-doc@FreeBSD.ORG Sun Mar 23 03:00:09 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8E45F1065671 for ; Sun, 23 Mar 2008 03:00:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 7E9E28FC1C for ; Sun, 23 Mar 2008 03:00:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m2N309PK078892 for ; Sun, 23 Mar 2008 03:00:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m2N309pX078891; Sun, 23 Mar 2008 03:00:09 GMT (envelope-from gnats) Date: Sun, 23 Mar 2008 03:00:09 GMT Message-Id: <200803230300.m2N309pX078891@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: John Ferrell Cc: Subject: Re: docs/121838: [patch] add portmaster(8) section to ports chapter of the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: John Ferrell List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 23 Mar 2008 03:00:09 -0000 The following reply was made to PR docs/121838; it has been noted by GNATS. From: John Ferrell To: bug-followup@FreeBSD.org, jdferrell3@yahoo.com, dougb@FreeBSD.org Cc: Subject: Re: docs/121838: [patch] add portmaster(8) section to ports chapter of the handbook Date: Sat, 22 Mar 2008 22:25:01 -0400 Doug, Thanks for reviewing the portmaster section. I have revised the diff based on your comments. And thanks for developing a great utility! John --- chapter.sgml.orig 2008-03-11 12:46:26.000000000 -0400 +++ chapter.sgml 2008-03-22 11:48:15.000000000 -0400 @@ -1293,6 +1293,97 @@ For further information see &man.portmanager.1;. + + + Upgrading Ports using Portmaster + + + portmaster + + + Portmaster is another utility for + upgrading installed ports. Portmaster + was designed make use of the tools found in the base + system (it does not depend upon any other ports) and uses the + information in /var/db/pkg/ + to determine which ports to upgrade. It is available from the + ports-mgmt/portmaster port: + + &prompt.root; cd /usr/ports/ports-mgmt/portmaster +&prompt.root; make install clean + + Portmaster groups ports into four + categories: + + + + Root ports (no dependencies, not depended on) + + + Trunk ports (no dependencies, are depended on) + + + Branch ports (have dependencies, are depended on) + + + Leaf ports (have dependencies, not depended on) + + + + You can list all the installed ports and search + for updates using the option: + +&prompt.root; portmaster -L +===>>> Root ports (No dependencies, not depended on) +===>>> ispell-3.2.06_18 +===>>> screen-4.0.3 + ===>>> New version available: screen-4.0.3_1 +===>>> tcpflow-0.21_1 +===>>> 7 root ports +... +===>>> Branch ports (Have dependencies, are depended on) +===>>> apache-2.2.3 + ===>>> New version available: apache-2.2.8 +... +===>>> Leaf ports (Have dependencies, not depended on) +===>>> automake-1.9.6_2 +===>>> bash-3.1.17 + ===>>> New version available: bash-3.2.33 +... +===>>> 32 leaf ports + +===>>> 137 total installed ports + ===>>> 83 have new versions available + + + All the installed ports can be upgraded using this simple + command: + + &prompt.root; portmaster -a + + By default, Portmaster + will make a backup package before deleting the existing port. If + the installation of the new version is successful, + Portmaster will delete the backup. + Using the will instruct + Portmaster not to automatically delete + the backup. Also, adding the option will start + Portmaster in interactive mode, prompting + you before upgrading each port. + + If you encounter errors during the upgrade process, you can use + the option to upgrade/rebuild all ports: + + &prompt.root; portmaster -af + + You can also use Portmaster to + install new ports on the system, upgrading all dependencies + before building and installing the new port: + + &prompt.root; portmaster shells/bash + + Please see &man.portmaster.8; from more information. +