From owner-svn-doc-projects@FreeBSD.ORG Tue May 21 19:25:06 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id E391B8A8; Tue, 21 May 2013 19:25:06 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from hapkido.dreamhost.com (hapkido.dreamhost.com [66.33.216.122]) by mx1.freebsd.org (Postfix) with ESMTP id BEDCC879; Tue, 21 May 2013 19:25:06 +0000 (UTC) Received: from homiemail-a72.g.dreamhost.com (caiajhbdcbbj.dreamhost.com [208.97.132.119]) by hapkido.dreamhost.com (Postfix) with ESMTP id 29F7F38064; Tue, 21 May 2013 12:25:06 -0700 (PDT) Received: from homiemail-a72.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a72.g.dreamhost.com (Postfix) with ESMTP id A29216B007C; Tue, 21 May 2013 12:24:49 -0700 (PDT) Received: from lab (ip72-219-240-45.dc.dc.cox.net [72.219.240.45]) (Authenticated sender: trhodes@fbsdsecure.org) by homiemail-a72.g.dreamhost.com (Postfix) with ESMTPA id 81A706B008D; Tue, 21 May 2013 12:24:29 -0700 (PDT) Date: Tue, 21 May 2013 15:24:27 -0400 From: Tom Rhodes To: Benjamin Kaduk Subject: Re: svn commit: r41663 - projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports Message-Id: <20130521152427.25a28ecc.trhodes@FreeBSD.org> In-Reply-To: References: <201305181824.r4IIOBcm068566@svn.freebsd.org> X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; x86_64-unknown-linux-gnu) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: svn-doc-projects@freebsd.org, trhodes@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: Tue, 21 May 2013 19:25:07 -0000 On Sun, 19 May 2013 23:38:06 -0400 (EDT) Benjamin Kaduk wrote: > 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. I kind of disagree - forums can be separate or part of a main site. It really depends and I'm not going to debate how to word it out proper - I've just removed forum. Cheers, -- Tom Rhodes