Jed,

   Your email was actually very constructive since I had forgotten about this 
convention (and got too tied up with having context specific help messages 
which I think are difficult with this convention, i.e. help messages specific 
to testing only).

   It is incumbent on Scott to add the help message related to make test and 
incumbent on you to make the help message for installs (and at this time the 
help message for test is more important than for installs). My "sadly it is not 
helpful" was actually directed towards Scott, not you.

   Barry

Sorry Scott but you know PETSc folk are blunt bastards.



> On Jun 17, 2017, at 10:57 PM, Jed Brown <[email protected]> wrote:
> 
> Matthew Knepley <[email protected]> writes:
> 
>> On Sat, Jun 17, 2017 at 6:19 PM, Jed Brown <[email protected]> wrote:
>> 
>>> Barry Smith <[email protected]> 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*'

Reply via email to