From owner-svn-doc-head@FreeBSD.ORG Mon Nov 12 22:50:26 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id D985B4F2 for ; Mon, 12 Nov 2012 22:50:26 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-lb0-f182.google.com (mail-lb0-f182.google.com [209.85.217.182]) by mx1.freebsd.org (Postfix) with ESMTP id 4B74F8FC0C for ; Mon, 12 Nov 2012 22:50:25 +0000 (UTC) Received: by mail-lb0-f182.google.com with SMTP id gg13so1727538lbb.13 for ; Mon, 12 Nov 2012 14:50:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type; bh=gjBpsdRt4R2cFEnZiqa+CCHuzkhrJP0+NNhPZPbKeUE=; b=RPMMNpXe0/rIiqDjo2OjAJIfxZX8N9JqhMl14ObGClqUx8I0CmsN8O/BZRMsHNENF6 +ru6AvzSrrxMGJMdxL/rjTFfLboXmUR3wg1rdcjPm1xSqBurx1Skz3xCPIsfDXBP57Ef T1WnZiPPO9qMlqpzHiTyb0F/0i2JKwssWdkIo= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :x-gm-message-state; bh=gjBpsdRt4R2cFEnZiqa+CCHuzkhrJP0+NNhPZPbKeUE=; b=oAsClIUBj871ExBhJvb4NR+IvZ1jQWu37OEW4/RJwkLCWKZmkAlDyO2vpLTC+3PyAX HRLzSLc67aLyAKmh6faYEpOGBu+W6KWo3P4bJ3Cip4o4E0hAP80+SCG+3YbghBp+nTrj aiklgn7TUDGZEoYFGhoP/jm5wdL1NVKFNQ1VVYf9+XgBZkwBrsI7jKyN55BbZ+tCn/+k 8paHGmHxoERAyG1nSiusIquiHTTh95fRM8Fxs9xom21FrCE1AsZHVogwIQuYBGeVvaqy UWwW5DGKHSbWEjButOrcSTXdUghcwTagc1HJ0XYt380HHoP0VVQai874VUdjAE4IzF5L 2CMg== Received: by 10.112.37.7 with SMTP id u7mr8507696lbj.30.1352760624945; Mon, 12 Nov 2012 14:50:24 -0800 (PST) MIME-Version: 1.0 Sender: lists@eitanadler.com Received: by 10.112.25.166 with HTTP; Mon, 12 Nov 2012 14:49:54 -0800 (PST) In-Reply-To: References: <201211112229.qABMT1il009287@svn.freebsd.org> From: Eitan Adler Date: Mon, 12 Nov 2012 17:49:54 -0500 X-Google-Sender-Auth: XRiXFjmJZD4ftgtJOuJt6R6QJ4s Message-ID: Subject: Re: svn commit: r39981 - head/en_US.ISO8859-1/books/faq To: Benjamin Kaduk Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQny5xB9YG9O+RfSLWJOpmnx22rkQ4avSCX5szOOh1SrHZa2lkxVrf0ieySSVzlpEiV9LXgs Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 12 Nov 2012 22:50:26 -0000 On 12 November 2012 14:58, Benjamin Kaduk wrote: > On Sun, 11 Nov 2012, Eitan Adler wrote: > >> Author: eadler >> Date: Sun Nov 11 22:29:01 2012 >> New Revision: 39981 >> URL: http://svnweb.freebsd.org/changeset/doc/39981 >> >> Log: >> Reduce redundant markup and word and other minor problems reported by >> igor. Limited additional checking was done of the surrounding content. >> >> Approved by: jkois (mentor, before merge conflict resolution) >> >> Modified: >> head/en_US.ISO8859-1/books/faq/book.xml >> >> Modified: head/en_US.ISO8859-1/books/faq/book.xml >> >> ============================================================================== >> --- head/en_US.ISO8859-1/books/faq/book.xml Sun Nov 11 21:42:32 2012 >> (r39980) >> +++ head/en_US.ISO8859-1/books/faq/book.xml Sun Nov 11 22:29:01 2012 >> (r39981) >> @@ -923,7 +923,7 @@ >> Where the format is >> html-split, the files are bundled >> up using &man.tar.1;. The resulting >> - .tar file is then compressed >> + .tar is then compressed > > > This would seem like a candidate where the "redundant" use of "file" > actually is helpful, since there is not a specific file name given. Perhaps. I'll send a patch to bcr & jkois. >> - the close lcp command (a following >> - term command) will reconnect you to the >> + close lcp (a following >> + term) will reconnect you to the > > > I have trouble making sense of this sentence; perhaps the close paren is > misplaced? Not a bug in your change, but I would have expected it to be > noticed in pre-commit review. Note the commit message: ""Limited additional checking was done of the surrounding content."" I noticed quite a few things, but few of which I felt I wanted to fix in this iteration. >> >> - The option does a >> + does a > > > My understanding was that we did not like to start sentences with markup. I did not know this. Can you propose some alternative wording? -- Eitan Adler Source, Ports, Doc committer Bugmeister, Ports Security teams