[petsc-dev] make -f gmakefile test needs a proper help message of some sort

[Matthew Knepley]

On Tue, Jun 20, 2017 at 5:23 PM, Scott Kruger <kruger at txcorp.com> wrote:

>
>
> On 6/17/17 9:57 PM, Jed Brown wrote:
>
>> Matthew Knepley <knepley at gmail.com> writes:
>>
>> On Sat, Jun 17, 2017 at 6:19 PM, Jed Brown <jed at jedbrown.org> wrote:
>>>
>>> Barry Smith <bsmith at mcs.anl.gov> writes:
>>>>
>>>>    Thanks, sadly it is not helpful.
>>>>>
>>>>
>>>> I wasn't saying it worked now, but that it was the target that should be
>>>> used to print help.
>>>>
>>>
>>>
>>> <insert broken fingers message>
>>>
>>
>> Barry's original message was addressed to Scott.  I was merely pointing
>> out a convention that is more discoverable than Barry's suggestion.  I
>> claim this was a constructive comment, not bikeshedding.  Yes, I could
>> make this change, but so could you, Barry, or anyone else.  I don't
>> think it's productive to lob the "broken fingers" criticism around.
>> It's educational and likely more accurate for the person who wrote a
>> component to maintain the docs for that component and the person making
>> the suggestion might have the 30 seconds at that moment to make a
>> constructive suggestion, but not the 10 minutes to implement it.
>>
>> where are the current docs for it that we move to this place?
>>>
>>
>> gmakefile has this comment.
>>
>> # Tests can be generated by searching
>> # Percent is a wildcard (only one allowed):
>> #    make -f gmakefile test search=sys%ex2
>> # To match internal substrings (matches *ex2*):
>> #    make -f gmakefile test searchin=ex2
>> # Search and searchin can be combined:
>> #    make -f gmakefile test search='sys%' searchin=ex2
>> # For args:
>> #    make -f gmakefile test argsearch=cuda
>> # For general glob-style searching using python:
>> # NOTE: uses shell which is possibly slower and is possibly more brittle
>> #    make -f gmakefile test pysearch='sys*ex2*'
>>
>
> I'll also note that per request, there is documentation
> in the developers latex manual.  AFAICT, it's only use
> has been to show that I can check off requests.


I read it :) But of course, then I forgot where it was.

   Matt


>
> Scott
>
>
> --
> Tech-X Corporation               kruger at txcorp.com
> 5621 Arapahoe Ave, Suite A       Phone: (720) 974-1841
> Boulder, CO 80303                Fax:   (303) 448-7756
>



-- 
What most experimenters take for granted before they begin their
experiments is infinitely more interesting than any results to which their
experiments lead.
-- Norbert Wiener

http://www.caam.rice.edu/~mk51/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-dev/attachments/20170620/2a32e782/attachment.html>