From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 30298 invoked by alias); 14 May 2006 20:21:03 -0000 Received: (qmail 30244 invoked by uid 22791); 14 May 2006 20:21:00 -0000 X-Spam-Check-By: sourceware.org Received: from romy.inter.net.il (HELO romy.inter.net.il) (192.114.186.66) by sourceware.org (qpsmtpd/0.31) with ESMTP; Sun, 14 May 2006 20:20:12 +0000 Received: from HOME-C4E4A596F7 (IGLD-83-130-244-207.inter.net.il [83.130.244.207]) by romy.inter.net.il (MOS 3.7.3-GA) with ESMTP id EEM31764 (AUTH halo1); Sun, 14 May 2006 23:20:06 +0300 (IDT) Date: Sun, 14 May 2006 22:06:00 -0000 Message-Id: From: Eli Zaretskii To: Sandra Loosemore CC: gdb-patches@sourceware.org In-reply-to: <44676486.8090002@codesourcery.com> (message from Sandra Loosemore on Sun, 14 May 2006 13:10:30 -0400) Subject: Re: PATCH: copy-edit File-I/O section of manual Reply-to: Eli Zaretskii References: <4465ED4D.4020505@codesourcery.com> <446659B7.3040306@codesourcery.com> <446730A4.60300@codesourcery.com> <4465ED4D.4020505@codesourcery.com> <446659B7.3040306@codesourcery.com> <20060514150059.GA29094@nevyn.them.org> <44676486.8090002@codesourcery.com> X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-05/txt/msg00321.txt.bz2 > Date: Sun, 14 May 2006 13:10:30 -0400 > From: Sandra Loosemore > > Thanks, Daniel. On reflection, I think Eli and I are just thinking at > cross-purposes here. Eli is worried about what has changed at a line-by-line > level, while I have been thinking in terms of the "big picture" of bringing the > writing in this section as a whole up to an acceptable standard of quality for a > professional document. If you can present the patch in a way that makes this big picture show, it might help me review the patch sooner. Based on my experience, such a presentation will need to use something other than Diff, though. > That's why I suggested applying the patch and proofreading the > resulting text. You are asking me to proofread a large portion of text, instead of concentrating on the relatively small differences. This is precisely the large job which I'm trying to avoid as much as possible, because it takes so much more time. That is why I prefer small, isolated diffs that can be approved without re-reading entire chapters. By contrast, significant changes that rearrange the material absolutely _require_ to consider the overall effect of the structural changes, which means I need to read, or at least skim, across large portions of the manual, and consider didactic issues in addition to purely linguistic, grammatic, and markup-related aspects.