I've tweaked the template to say
"Private (feel free to read the docs to see what this does)"
Seriously though - I prefer to keep templates prompts as concise as is practical because there are so many of them. Trying to "document" each setting in the template leads to a very cluttered, and misunderstood interface.
I knew of your opinion about template prompts. On the other hand please understand our situation. We wade through these masses of template options, search for "something" of which we do not even know its name. Then I find "Private". 'Hmm, what is Private
? What does it mean? Dunno. I have no time now to learn what this option is! I do not need Private, I need to solve my problem. So where is that damned setting? I know it was there once! I know for sure!! Did Bruce remove because nobody ever used it? WHERE is that friggin' option? What can even be its name? Oh my, I better ask in the forum..."
You are right again, RTFM!
But what should I search for in the manual if I do not exactly know what to search for?
I know I want to exlude my method from the publicly visible documentaion.
Search for "documentation nettalk site:capesoft.com
" returns a plethora of results.
And keep in mind many of us are non-native english speakers. Some with less, others with more accent...
I try to make my UI as verbose for users as possible. To help them in their daily work. And template dialogs are the (Clarion-)programmers daily UI.
That said, I have a slightly dofferent approach on template settings.
OTOH I do not write so many templates, so its much easier for me then for you.
But that's what my task is. Making your life difficult.....