From owner-svn-doc-projects@FreeBSD.ORG Mon May 20 03:43:17 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id D5055963; Mon, 20 May 2013 03:43:17 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-8.mit.edu (DMZ-MAILSEC-SCANNER-8.MIT.EDU [18.7.68.37]) by mx1.freebsd.org (Postfix) with ESMTP id 6C896A32; Mon, 20 May 2013 03:43:16 +0000 (UTC) X-AuditID: 12074425-b7f986d00000082c-39-51999aa29d0f Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-8.mit.edu (Symantec Messaging Gateway) with SMTP id AC.2B.02092.2AA99915; Sun, 19 May 2013 23:38:10 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH-1.MIT.EDU [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r4K3c8YS012648; Sun, 19 May 2013 23:38:09 -0400 Received: from multics.mit.edu (SYSTEM-LOW-SIPB.MIT.EDU [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r4K3c69i013156 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 19 May 2013 23:38:08 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r4K3c6fc006153; Sun, 19 May 2013 23:38:06 -0400 (EDT) Date: Sun, 19 May 2013 23:38:06 -0400 (EDT) From: Benjamin Kaduk To: Tom Rhodes Subject: Re: svn commit: r41663 - projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports In-Reply-To: <201305181824.r4IIOBcm068566@svn.freebsd.org> Message-ID: References: <201305181824.r4IIOBcm068566@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrDIsWRmVeSWpSXmKPExsUixCmqrbto1sxAg66JbBY/Ph5islh4ZjWz xd8NH1gcmD1mfJrPEsAYxWWTkpqTWZZapG+XwJWx6eZXpoKH0hVL71g1MB4U62Lk5JAQMJFY cOcyC4QtJnHh3nq2LkYuDiGBfYwSuzeuYYVwNjJKTL80Gco5xCSxevM0FgingVHi/sEb7F2M HBwsAtoSZ3aYg4xiE1CRmPlmIxuILQJk3z14mgnEZhawkZjwYAE7iC0skCKxpeUqK4jNKWAl Mat9MVicV8BB4vDCU2C2kIClxPfbi5lBbFEBHYnV+6ewQNQISpyc+YQFYqalxL+1v1gnMArO QpKahSS1gJFpFaNsSm6Vbm5iZk5xarJucXJiXl5qka6FXm5miV5qSukmRlCgsruo7mCccEjp EKMAB6MSD69AwMxAIdbEsuLK3EOMkhxMSqK8/jOBQnxJ+SmVGYnFGfFFpTmpxYcYJTiYlUR4 o7uBcrwpiZVVqUX5MClpDhYlcd4bKTf9hQTSE0tSs1NTC1KLYLIyHBxKErzNIEMFi1LTUyvS MnNKENJMHJwgw3mAhmeB1PAWFyTmFmemQ+RPMSpKifO2gSQEQBIZpXlwvbBE8opRHOgVYd4E kCoeYBKC634FNJgJaPB2S7DBJYkIKakGxljWtaskbz24tqDef9O/0H/fl835mL76wNHrj1IL drNdDMsQcDv4OeKCb8Qr3vnJXU0P9Lp+XhY1dD6+tJ7nhseMLZtr7t6/r84+yXX+ycd6H1ae mKrLrRM285vHq+WZE3POVYnkLVSKe3j5il+pH9PN3pbYCr7bol1emhd2pop2751s+t8475MS S3FGoqEWc1FxIgCqZyoM/wIAAA== Cc: svn-doc-projects@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 20 May 2013 03:43:17 -0000 Apologies if I miss fixes in follow-up commits. On Sat, 18 May 2013, Tom Rhodes wrote: > Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml > ============================================================================== > --- projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat May 18 18:09:00 2013 (r41662) > +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat May 18 18:24:11 2013 (r41663) > @@ -1800,18 +1800,18 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/ > > > > - Use &man.pkg.info.1; to find out which files were > - installed, and where. For example, if you have just > - installed FooPackage version 1.0.0, then this command > + The &man.pkg.info.1; will print all installed "The pkg_info(1)" is quite odd grammar, getting the worst of both worlds between "the pkg_info(1) command" and just "pkg_info(1)". > + files and their location. For example, if the FooPackage > + version 1.0.0 was just installed, then the following > + command will show all the files installed with the > + package. > > &prompt.root; pkg_info -L foopackage-1.0.0 | less > > - will show all the files installed by the package. Pay > - special attention to files located in > - man/, which will be manual pages, > - etc/, which will be configuration > - files, and doc/, which will be more > - comprehensive documentation. > + Configuration files are always installed in the > + /usr/local/etc This "the" is spurious. > + and should definitely be consulted before attempting > + to use the new application. > > To determine which version of the application was > installed: > @@ -1825,17 +1825,18 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/ > > > > - Once you have identified where the application's manual > - pages have been installed, review them using &man.man.1;. > - Review the sample configuration files and any additional > - documentation that may have been provided. > + These commands will also show the names of any manual > + pages installed with the application. This additional > + documentation will now be available to the &man.man.1; > + command. > > > > - If the application has a web site, check it for > - additional documentation, frequently asked questions, and so > - forth. If you are not sure of the web site address it may > - be listed in the output from > + If the application has a web site, consult it for > + additional documentation, frequently asked questions, or > + a forum. If the website is unknown, the following command The comma usage here seems broken, as "a forum" is an alternative to "a web site", and the only things bound to "a web site" are now "additional documentation, frequently asked quesions", which should take "and" with no comma and does not need to be followed by a comma. -Ben > + will be useful to print out this information if it's > + available. > > &prompt.root; pkg_info foopackage-1.0.0 > >