I'll revisit my previous suggestion. In real life... * a "sample" is a real object you can hold. You ask a supplier to "send you a sample" of their product so you can inspect it before you buy lots. In an industrial factory, you "take a sample" to take an item from the process stream to the lab to analyse. Both of these are real objects you can hold. In addition, Digital Signal Processing does sampling, it doesn't do exampling.
* an "example" is one step removed from real life objects. The maths teacher works through an example. Someone's behaviour can set a good example. A programming script can provide an example of how to do something. People say "for example, how about my hypothetical** situation". None of these refer to a real object. Now you can use "example" to refer to real objects, but usually second hand when you are describing a general characteristic. It doesn't have the same concrete semantic of a real object as "sample". There were other suggestions that were reasonable. It might be better to have one pragma that is parameterized by what sort of example it is. cheers -ben ** Consider for a moment, what would the world be like without hypothetical situations? On Mon, Jun 22, 2015 at 6:49 PM, Nicolai Hess <nicolaih...@web.de> wrote: > > > 2015-06-22 12:03 GMT+02:00 Peter Uhnák <i.uh...@gmail.com>: >> >> Hi, >> >> there was a long discussion about the meaning of example* methods and >> <example> pragmas, however I do not know what was the final resolution. >> >> Basically I am interested in two use-cases >> >> 1. executable example (the one where Nautilus shows nice play icon) >> This is as I understand only through example* naming (on class-side). > > > Yes, but I would like to use a pragma again and don't rely naming > convention, we just wasn't able to agree on one. > >> >> >> 2. returning examples (example that returns some value that I can reuse) >> Is this what <example> pragma is for? How would I go about naming it >> considering that having play icon there would be counter-productive (user >> would be clicking on it and nothing would happen). > > > Inspector and spotter use gtExample* names in addition to an <gtExample> > pragma. > <gtExample> -> for finding those methods > gtExample*name -> for not getting the play icon. > > This is less than perfect. > >> >> >> Thanks, >> Peter > >
