From owner-svn-doc-all@freebsd.org Thu Aug 16 13:18:31 2018 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 44E20105B345; Thu, 16 Aug 2018 13:18:31 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id E754F817B0; Thu, 16 Aug 2018 13:18:30 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id C7DD219DB1; Thu, 16 Aug 2018 13:18:30 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w7GDIUPa076909; Thu, 16 Aug 2018 13:18:30 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w7GDIUle076908; Thu, 16 Aug 2018 13:18:30 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <201808161318.w7GDIUle076908@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Thu, 16 Aug 2018 13:18:30 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r52134 - head/en_US.ISO8859-1/books/handbook/ports X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/handbook/ports X-SVN-Commit-Revision: 52134 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 16 Aug 2018 13:18:31 -0000 Author: bcr Date: Thu Aug 16 13:18:30 2018 New Revision: 52134 URL: https://svnweb.freebsd.org/changeset/doc/52134 Log: Wrap overlong lines in the ports chapter, cleanup trailing whitespace on a sentence break, and change the capitalization of a title. Found by: textproc/igor 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 Thu Aug 16 12:45:32 2018 (r52133) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Thu Aug 16 13:18:30 2018 (r52134) @@ -71,7 +71,8 @@ Unpack the software from its distribution format. This is typically a tarball compressed with a program such as - &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or &man.xz.1;. + &man.compress.1;, &man.gzip.1;, &man.bzip2.1; or + &man.xz.1;. @@ -104,11 +105,11 @@ on &os;, the source code might need editing in order for it to install and run properly. - However, over - &os.numports; - third-party applications have already been - ported to &os;. When feasible, these applications are made - available for download as pre-compiled packages. + However, over &os.numports; + third-party applications have already been ported to &os;. When + feasible, these applications are made available for download as + pre-compiled packages. Packages can be manipulated with the &os; package management @@ -277,10 +278,10 @@ subversion-static-1.8.8_2 subversion16-1.6.23_4 subversion17-1.7.16_2 - Package names include the version number and, in the case of - ports based on python, the version number of the version of - python the package was built with. Some ports also have - multiple versions available. In the case of + Package names include the version number and, in the + case of ports based on python, the version number of the + version of python the package was built with. Some ports + also have multiple versions available. In the case of Subversion, there are different versions available, as well as different compile options. In this case, the statically linked version of @@ -409,9 +410,9 @@ Info: Lists information about open files (similar to from the &os; mirrors, managing packages with pkg can be sufficient. - However, for those sites building from source or using - their own repositories, a separate - port management tool + However, for those sites building from source or using their + own repositories, a separate port management tool will be needed. Since pkg only works with @@ -741,17 +742,17 @@ Deinstalling ca_root_nss-3.15.1_1... done The Ports Collection is a set of Makefiles, patches, and description files. - Each set of these files is used to compile and install an individual - application on &os;, and is called a port. + Each set of these files is used to compile and install an + individual application on &os;, and is called a + port. - By default, the Ports Collection itself is stored as a subdirectory - of /usr/ports. + By default, the Ports Collection itself is stored as a + subdirectory of /usr/ports. - Before an - application can be compiled using a port, the Ports Collection - must first be installed. If it was not installed during the - installation of &os;, use one of the following methods to - install it: + Before an application can be compiled using a port, the + Ports Collection must first be installed. If it was not + installed during the installation of &os;, use one of the + following methods to install it: Portsnap Method @@ -1001,15 +1002,14 @@ Deinstalling ca_root_nss-3.15.1_1... done options, or allow for other customizations. Examples include www/firefox, security/gpgme, and - mail/sylpheed-claws. - If the port depends upon other ports which have configurable - options, it may pause several times for user interaction - as the default behavior is to prompt the user to select - options from a menu. To avoid this and do all of the configuration - in one batch, run make config-recursive - within the port skeleton. Then, run make - install [clean] to compile and install the - port. + mail/sylpheed-claws. If the port depends + upon other ports which have configurable options, it may + pause several times for user interaction as the default + behavior is to prompt the user to select options from a + menu. To avoid this and do all of the configuration in one + batch, run make config-recursive within + the port skeleton. Then, run make install + [clean] to compile and install the port. When using @@ -1171,15 +1171,16 @@ The deinstallation will free 229 kB - Tools To Upgrade And Manage Ports + Tools to Upgrade and Manage Ports ports upgrading-tools - The Ports Collection contains several utilities to perform - the actual upgrade. Each has its strengths and weaknesses. + The Ports Collection contains several utilities to + perform the actual upgrade. Each has its strengths and + weaknesses. Historically, most installations used either Portmaster or @@ -1188,9 +1189,10 @@ The deinstallation will free 229 kB alternative. - The choice of which tool is best for a particular system - is up to the system administrator. It is recommended practice - to back up your data before using any of these tools. + The choice of which tool is best for a particular + system is up to the system administrator. It is + recommended practice to back up your data before using any + of these tools. @@ -1297,8 +1299,9 @@ The deinstallation will free 229 kB &prompt.root; portmaster shells/bash - More information about ports-mgmt/portmaster - may be found in its pkg-descr. + More information about + ports-mgmt/portmaster may be found in its + pkg-descr. @@ -1308,11 +1311,11 @@ The deinstallation will free 229 kB portupgrade - ports-mgmt/portupgrade is - another utility that can be used to upgrade ports. It - installs a suite of applications - which can be used to manage ports. However, it is dependent - upon Ruby. To install the port: + ports-mgmt/portupgrade is another + utility that can be used to upgrade ports. It installs a + suite of applications which can be used to manage ports. + However, it is dependent upon Ruby. To install the + port: &prompt.root; cd /usr/ports/ports-mgmt/portupgrade &prompt.root; make install clean @@ -1358,8 +1361,9 @@ The deinstallation will free 229 kB information on all of the available switches, refer to the manual page for portupgrade. - More information about ports-mgmt/portupgrade - may be found in its pkg-descr. + More information about + ports-mgmt/portupgrade may be found in + its pkg-descr. @@ -1453,9 +1457,9 @@ The deinstallation will free 229 kB other configuration values are adequate. The number of processor cores detected is used to define how - many builds will run in parallel. Supply enough virtual - memory, either with RAM or swap space. If - virtual memory runs out, the compilation jails will stop and be torn + many builds will run in parallel. Supply enough virtual memory, + either with RAM or swap space. If virtual + memory runs out, the compilation jails will stop and be torn down, resulting in weird error messages. @@ -1701,7 +1705,8 @@ ports-mgmt/pkg list. Many, but not all, of these addresses look like freebsd-listname@FreeBSD.org. - Please take this into account when sending an email. + Please take this into account when sending an + email. In particular, ports maintained by ports@FreeBSD.org are not