From owner-svn-doc-head@FreeBSD.ORG Thu Feb 13 04:37:41 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 736D24EE; Thu, 13 Feb 2014 04:37:41 +0000 (UTC) Received: from dmz-mailsec-scanner-5.mit.edu (dmz-mailsec-scanner-5.mit.edu [18.7.68.34]) by mx1.freebsd.org (Postfix) with ESMTP id C028F1621; Thu, 13 Feb 2014 04:37:40 +0000 (UTC) X-AuditID: 12074422-f79526d000000c47-10-52fc4ae0613b Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) (using TLS with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP id B1.DA.03143.1EA4CF25; Wed, 12 Feb 2014 23:32:33 -0500 (EST) 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 s1D4WWBH011507; Wed, 12 Feb 2014 23:32:32 -0500 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 s1D4WUYY017507 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 12 Feb 2014 23:32:31 -0500 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id s1D4WTML005168; Wed, 12 Feb 2014 23:32:29 -0500 (EST) Date: Wed, 12 Feb 2014 23:32:29 -0500 (EST) From: Benjamin Kaduk X-X-Sender: kaduk@multics.mit.edu To: Dru Lavigne Subject: Re: svn commit: r43887 - head/en_US.ISO8859-1/books/handbook/mirrors In-Reply-To: <201402122100.s1CL0xpL085737@svn.freebsd.org> Message-ID: References: <201402122100.s1CL0xpL085737@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrNIsWRmVeSWpSXmKPExsUixCmqrfvQ60+QwZ+FrBY/Ph5isuhqUrW4 sWg/k8Xu/l5mBxaPGZ/mswQwRnHZpKTmZJalFunbJXBlHP14gL1gn1BFb4t5A+MXvi5GTg4J AROJ1neb2CBsMYkL99YD2VwcQgKzmSRmLHzIDOFsZJRoO/SABcI5xCRx9/BiqEwDo8TXxx1M XYwcHCwC2hKf1huDjGITUJN4vLeZFWKsosTmU5OYQWwRIPvp172MIDazQJTEnqWNYDXCAv4S 066vAjuDU8BK4mDfVyYQm1fAQeLc0XvMIOOFBCwlfjTpgYRFBXQkVu+fwgJRIihxcuYTFoiR lhLn/lxnm8AoNAtJahaS1AJGplWMsim5Vbq5iZk5xanJusXJiXl5qUW6pnq5mSV6qSmlmxhB YczuorSD8edBpUOMAhyMSjy8GjN+BwmxJpYVV+YeYpTkYFIS5dV3/hMkxJeUn1KZkVicEV9U mpNafIhRgoNZSYRXRgIox5uSWFmVWpQPk5LmYFES5621+BUkJJCeWJKanZpakFoEk5Xh4FCS 4A33BGoULEpNT61Iy8wpQUgzcXCCDOcBGl4BUsNbXJCYW5yZDpE/xagoJc57ACQhAJLIKM2D 64WlmVeM4kCvCPNyAJOOEA8wRcF1vwIazAQ0ODXqN8jgkkSElFQDY37eqZyfnMU3T13ONTjt Vbp4/tPMevW5YZp83EouvW+PT/UK0r4eW+aToNBwvXbaJmWXvmN78u2yPI8EvpUWcD2+efKk cNafonoadk+2lgnkyCxi+VNZX3nvl8aE5293Gmb6sZ9fr/aK8b6Z/nuGjU6iGetrpFtnneC6 L/brxOTLfdcOfTpyQImlOCPRUIu5qDgRAEUpE20OAwAA 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.17 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: Thu, 13 Feb 2014 04:37:41 -0000 On Wed, 12 Feb 2014, Dru Lavigne wrote: > Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Wed Feb 12 19:38:42 2014 (r43886) > +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Wed Feb 12 21:00:59 2014 (r43887) > + > + Multiple deltas can be applied at one time as they > + will be processed one at a time and any deltas that are already > + applied will be ignored. CTM understands deltas which > + have been put through gzip, which saves disk > space. "can be applied at one time" doesn't match with "one at a time"; I think "can be applied with a single command" is more likely to be correct (but I don't use CTM, so who knows!). "which have been put through gzip" is a strange phrasing; "which have been compressed using gzip" should be better. > + To > + verify a delta without applying it, include . I think this would be "include -c in the command line" or "add -c". > + CTM will not actually touch s/touch/modify/ ? > + the local tree but will instead verify the integrity of the delta > + to see if it would apply cleanly. Refer to &man.ctm.1; for > + more information about available switches and an overview of I sort of have the impression that we're moving away from using "switch" to describe options to utilities (and that "option" would be better), but don't have a citation. > + Once applied, it is recommended to not delete the deltas if it is a burden to download > + them again. This way, a local copy is available in case > + something bad happens. "something bad happens" is a bit informal; maybe "they are needed for future disaster recovery" or something similar. > + > + To backup all of the files that > + would be changed by a CTM > + update, specify . This option ? -Ben > + tells CTM to backup all files > + touched by the applied > CTM delta to > backup-file.