Re: Cross-test documentation

["Carlos O'Donell" <carlos at systemhalted dot org>]

On Wed, Oct 31, 2012 at 1:32 PM, Joseph S. Myers
<joseph@codesourcery.com> wrote:
> On Wed, 31 Oct 2012, Carlos O'Donell wrote:
>
>> I would still however prefer a patch that ascribed a purpose to the
>> wrapper if only to help orient the reader. As a neophyte I'd be asking
>> myself "What purpose does this functionality serve?"
>
> A neophyte would have read the previous paragraph first.  The previous
> paragraph says specifically how to use test-wrapper for testing over SSH,
> then the proposed new paragraph says "In general,", and goes on to discuss
> how you might use a test-wrapper that isn't cross-test-ssh.sh and what the
> requirements are if writing your own wrapper.  I think the previous
> paragraph gives the required orientation.

I agree that taken together the two paragraphs do orient the reader
sufficiently that additional wording about the test-wrapper is superfluous.

Thanks for reminding me about the larger context.

Cheers,
Carlos.