Date: Wed, 2 Oct 2013 12:38:20 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42802 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <201310021238.r92CcKjB047993@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dru Date: Wed Oct 2 12:38:20 2013 New Revision: 42802 URL: http://svnweb.freebsd.org/changeset/doc/42802 Log: Minor word-smith patch which also: - introduces the term porting - adds mention of traditional and pkgng formats Approved by: gjb (mentor) Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Wed Oct 2 11:47:11 2013 (r42801) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Wed Oct 2 12:38:20 2013 (r42802) @@ -67,14 +67,14 @@ <procedure> <step> - <para>Download the software, which might be distributed in - source code format, or as a binary.</para> + <para>Find and download the software, which might be distributed in + source code format or as a binary.</para> </step> <step> - <para>Unpack the software from its distribution format - (typically a tarball compressed with &man.compress.1;, - &man.gzip.1;, or &man.bzip2.1;).</para> + <para>Unpack the software from its distribution format. This + is typically a tarball compressed with &man.compress.1;, + &man.gzip.1;, or &man.bzip2.1;.</para> </step> <step> @@ -87,8 +87,8 @@ <step> <para>If the software was distributed in source format, compile it. This may involve editing a - <filename>Makefile</filename>, or running a - <command>configure</command> script, and other work.</para> + <filename>Makefile</filename> or running a + <command>configure</command> script.</para> </step> <step> @@ -96,19 +96,20 @@ </step> </procedure> - <para>If you are installing a software package that was not - deliberately ported to &os; you may even have to go in and edit - the code to make it work properly.</para> - - <para>&os; provides two technologies which perform these steps for - you. At the time of writing, over &os.numports; third-party - applications are available.</para> + <para>If the software package was not + deliberately ported, or tested to work, on &os;, the source code may need editing + in order for it to install and run properly. At the time of + this writing, over &os.numports; third-party + applications have been ported to &os;.</para> + + <para>&os; provides two technologies which automate these steps.</para> <para>A &os; package contains pre-compiled copies of all the commands for an application, as well as any configuration files - and documentation. A package can be manipulated with &os; - package management commands, such as &man.pkg.add.1;, - &man.pkg.delete.1;, and &man.pkg.info.1;.</para> + and documentation. A package can be manipulated with the traditional &os; + package management commands, such as &man.pkg.add.1;, or using + the newer <application>pkgng</application> commands, such as + <command> pkg install</command>.</para> <para>A &os; port is a collection of files designed to automate the process of compiling an application from source code. The @@ -121,12 +122,12 @@ commands.</para> <para>Both packages and ports understand - <emphasis>dependencies</emphasis>. If &man.pkg.add.1; or the - Ports Collection is used to install an application and a + dependencies. If a package or port + is used to install an application and a dependent library is not already installed, the library will automatically be installed first.</para> - <para>While the two technologies are quite similar, packages and + <para>While the two technologies are similar, packages and ports each have their own strengths. Select the technology that meets your requirements for installing a particular application.</para> @@ -145,7 +146,7 @@ applications, such as <application>Mozilla</application>, <application>KDE</application>, or - <application>GNOME</application> this can be important, + <application>GNOME</application>, this can be important on a slow system.</para> </listitem> @@ -156,7 +157,7 @@ </itemizedlist> <itemizedlist> - <title>Ports Benefits</title> + <title>Port Benefits</title> <listitem> <para>Packages are normally compiled with conservative @@ -184,7 +185,7 @@ <listitem> <para>The licensing conditions of some software forbid binary - distribution. These must be distributed as source code + distribution. Such software must be distributed as source code which must be compiled by the end-user.</para> </listitem> @@ -195,8 +196,8 @@ </listitem> <listitem> - <para>If you have local patches, you will need the source in - order to apply them.</para> + <para>Source code is needed in + order to apply custom patches.</para> </listitem> </itemizedlist>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310021238.r92CcKjB047993>