Moves the portupgrade section to below portmaster. The patch to follow
will include a note to show that portupgrade is deprecated.
Index: ports/chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml,v
retrieving revision 1.297
diff -u -r1.297 chapter.sgml
--- ports/chapter.sgml 20 Feb 2012 19:09:35 -0000 1.297
+++ ports/chapter.sgml 12 Apr 2012 08:08:39 -0000
@@ -1182,60 +1182,6 @@
read here, UPDATING takes precedence.
-
- Upgrading Ports Using Portupgrade
-
-
- portupgrade
-
-
- The portupgrade utility is designed
- to easily upgrade installed ports. It is available from the ports-mgmt/portupgrade port. Install it like
- any other port, using the make install
- clean command:
-
- &prompt.root; cd /usr/ports/ports-mgmt/portupgrade
-&prompt.root; make install clean
-
- Scan the list of installed ports with the pkgdb
- -F command and fix all the inconsistencies it reports. It is
- a good idea to do this regularly, before every upgrade.
-
- When you run portupgrade -a,
- portupgrade will begin to upgrade all the
- outdated ports installed on your system. Use the
- flag if you want to be asked for confirmation of every individual
- upgrade.
-
- &prompt.root; portupgrade -ai
-
- If you want to upgrade only a
- certain application, not all available ports, use portupgrade
- pkgname. Include the
- flag if portupgrade
- should first upgrade all the ports required by the given
- application.
-
- &prompt.root; portupgrade -R firefox
-
- To use packages instead of ports for installation, provide
- flag. With this option
- portupgrade searches
- the local directories listed in PKG_PATH, or
- fetches packages from remote site if it is not found locally.
- If packages can not be found locally or fetched remotely,
- portupgrade will use ports.
- To avoid using ports, specify .
-
- &prompt.root; portupgrade -PP gnome2
-
- To just fetch distfiles (or packages, if
- is specified) without building or
- installing anything, use .
- For further information see &man.portupgrade.1;.
-
-
Upgrading Ports Using Portmanager
@@ -1369,6 +1315,60 @@
Please see &man.portmaster.8; for more information.
+
+
+ Upgrading Ports Using Portupgrade
+
+
+ portupgrade
+
+
+ The portupgrade utility is designed
+ to easily upgrade installed ports. It is available from the ports-mgmt/portupgrade port. Install it like
+ any other port, using the make install
+ clean command:
+
+ &prompt.root; cd /usr/ports/ports-mgmt/portupgrade
+&prompt.root; make install clean
+
+ Scan the list of installed ports with the pkgdb
+ -F command and fix all the inconsistencies it reports. It is
+ a good idea to do this regularly, before every upgrade.
+
+ When you run portupgrade -a,
+ portupgrade will begin to upgrade all the
+ outdated ports installed on your system. Use the
+ flag if you want to be asked for confirmation of every individual
+ upgrade.
+
+ &prompt.root; portupgrade -ai
+
+ If you want to upgrade only a
+ certain application, not all available ports, use portupgrade
+ pkgname. Include the
+ flag if portupgrade
+ should first upgrade all the ports required by the given
+ application.
+
+ &prompt.root; portupgrade -R firefox
+
+ To use packages instead of ports for installation, provide
+ flag. With this option
+ portupgrade searches
+ the local directories listed in PKG_PATH, or
+ fetches packages from remote site if it is not found locally.
+ If packages can not be found locally or fetched remotely,
+ portupgrade will use ports.
+ To avoid using ports, specify .
+
+ &prompt.root; portupgrade -PP gnome2
+
+ To just fetch distfiles (or packages, if
+ is specified) without building or
+ installing anything, use .
+ For further information see &man.portupgrade.1;.
+