This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: Cross-test documentation
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.