From sources-request at octave dot org Fri Jun 18 09:18:19 2004 Subject: Re: Patch for documentation From: David Bateman To: "John W. Eaton" Cc: Federico Zenith , sources@octave.org Date: Fri, 18 Jun 2004 16:14:04 +0200 According to John W. Eaton (on 06/18/04): > Sorry, I'm sure my original message was not clear. It's not that I > want 109 patches (i.e., one for each file that was touched) vs. one > large patch for all changes in all files. What is easiest to handle > is a patch that only solves one problem. So, if you want to fix the > appearance of H_\infty or H_2, etc., one patch to do that in all files > is best. If a patch attempts to solve several problems at once, and > for some reason part of the patch should not be applied, then it is > much harder to identify the sections of diffs that should not be > applied. Ok, so there is between 2 and 10 different things addressed by this one patch, depending on whether you consider "Prettify Poscript Documentation" to be a single item or not. A more realistic split would be * Various minor typographical and spelling fixes (eg "A,B" -> "A, B", spelling of gramians use of at acronym and @var) * Replace "x^T" with "x^{ \rm T }" and use {\cal H} for H-infinity and H-2 in tex documentation * Remove documentation of prefer_one_zero_indexing * More complete description of c2d, obsv and is_digital function * Change definition of the vander function If you can accept the first two as a single change, then the other three only touch a total of 5 files, and would be ease enough to split out.... > Also, I don't care about ChangeLog entries for the docs, only the code > changes. Sorry again if that was not clear from my earlier posting. So the only changelog entry is for vander... Much easier on Federico... Cheers David -- David Bateman David dot Bateman at motorola dot com Motorola CRM +33 1 69 35 48 04 (Ph) Parc Les Algorithmes, Commune de St Aubin +33 1 69 35 77 01 (Fax) 91193 Gif-Sur-Yvette FRANCE The information contained in this communication has been classified as: [x] General Business Information [ ] Motorola Internal Use Only [ ] Motorola Confidential Proprietary