- Introduce another way for upgrading packages and ports using bpkg(8).

Submitted by:	Andy Kosela

en_US.ISO8859-1/books/handbook/ports/chapter.sgml

@@ -1258,8 +1258,43 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
 
 	<screen>&prompt.root; <userinput>portmanager <replaceable>graphics/gimp</replaceable> -f</userinput></screen>
 
-	<para>For more information see
-	  <application>Portmanager</application>'s manual page.</para>
+	<para>For further information see &man.portmanager.1;.</para>
+      </sect3>
+
+      <sect3 id="bpkg">
+	<title>Upgrading Packages and Ports using Bpkg</title>
+
+	<indexterm>
+	  <primary>bpkg</primary>
+	</indexterm>
+
+	<para><application>Bpkg</application> is a simple yet powerful tool
+	  written in &man.sh.1; by Andy Kosela.  It was designed with the goal
+	  to provide one universal tool for packages/ports management.
+	  <application>Bpkg</application> can deal with binary packages
+	  and ports, making it real useful for people who use both.  It is 
+	  available from the <filename role="package">ports-mgmt/bpkg
+	  </filename> port:</para>
+
+	<screen>&prompt.root; <userinput>cd <filename role="directory">/usr/ports/ports-mgmt/bpkg</filename></userinput>
+&prompt.root; <userinput>make install clean</userinput></screen>
+
+	<para>All the installed ports can be upgraded with interactive
+	  mode using this simple command:</para>
+
+	<screen>&prompt.root; <userinput>bpkg -a</userinput></screen>
+
+	<para>All the installed ports can be upgraded with non-interactive
+	  mode using this simple command:</para>
+
+	<screen>&prompt.root; <userinput>bpkg -A</userinput></screen>
+
+	<para>You can also display most recently installed packages:</para>
+
+	<screen>&prompt.user; <userinput>bpkg -t | head</userinput></screen>
+
+	<para>For further information see 
+	  <application>Bpkg</application>'s manual page.</para>
       </sect3>
     </sect2>