Notetab Control Structures Tutorial - error #introclipwritingtutorial


Thomas Gruber
 

Hi Art,
there's a trivial error in the tutorial from Wayne M. VanWeerthuizen, in the sample clip in lines 43ff in the .otl file:

the label :_YES is missing - and it's not optional as stated in the text. Maybe a change in NoteTab (I'm using "pro") since this was published? using NEXT instead works.
Also, the messages in the 2 cases are misleading.
This is a very old clipbook, from 2003 - I'm reluctant to update it just because of this, what do you think?
Thomas


joy8388608
 

On Mon, Dec 23, 2019 at 05:24 AM, Thomas Gruber wrote:
There's a trivial error in the tutorial from Wayne M. VanWeerthuizen

Wow. Someone read it? And in detail? I've been wondering myself if it's worth it to enhance the logic processing section in that tutorial similar to the stuff I wrote about in message 25168. There seemed to be no interest at that time and Flo confirmed it. I could take that text and add to it (that would go in a tips, hints and techniques guide) but am just not sure if there is enough interest.

Hmm. Another poll?

Joy


Thomas Gruber
 

Hi Joy,
The little tutorial looks nice to me and has some interesing info for people reasonably familiar with other programming languages, but not with the clip language (like how to build a loop). I like the approach of using a meta-language with common programming concepts and then showing how this can be translated into clip language.
It is however not complete, parts of it are fragments (heading only but no text), so I believe for a beginner it would need completion to be useful. And it should be verified that the examples given really work :-) - for a beginner, almost nothing is more confusing than wrong (non working) examples.
I can’t judge the amount of interest of course. I like it, and I have enough experience with both clip language and programming in general so that I can distinguish between errors I made myself and errors in the example - usually :-) .
Happy to provide some text for a few of the empty headings, and/or do some testing, if we want to build on that tutorial.
Thomas

Am 23.12.2019 um 18:03 schrieb joy8388608 via Groups.Io <mycroftj@...>:

On Mon, Dec 23, 2019 at 05:24 AM, Thomas Gruber wrote:
There's a trivial error in the tutorial from Wayne M. VanWeerthuizen

Wow. Someone read it? And in detail? I've been wondering myself if it's worth it to enhance the logic processing section in that tutorial similar to the stuff I wrote about in message 25168. There seemed to be no interest at that time and Flo confirmed it. I could take that text and add to it (that would go in a tips, hints and techniques guide) but am just not sure if there is enough interest.

Hmm. Another poll?

Joy



Art Kocsis
 

On 12-23-2019 05:24, Thomas Gruber wrote:
Hi Art,
there's a trivial error in the tutorial from Wayne M. VanWeerthuizen, in the sample clip in lines 43ff in the .otl file:

the label :_YES is missing - and it's not optional as stated in the text. Maybe a change in NoteTab (I'm using "pro") since this was published? using NEXT instead works.
Also, the messages in the 2 cases are misleading.
This is a very old clipbook, from 2003 - I'm reluctant to update it just because of this, what do you think?
I'm with you there. No, the original should not be edited. What I would suggest, if you want to take on the task, is to create a file listing the changes and then uploading it to the same folder and with the same name but appending "Addendum", "Corrections" or "Edited". Alternately, edit a copy of the file with your comments and corrections and upload it as above but append "Revised" or "Edited". In either case, include comments in your file as to what you did and why.

What this also means is that a simple folder tree convention of each member's uploads being stored in his/her unique member folder will not be sufficient. There needs to be a TOC with some cross referencing which will require date stamps in each file name. Nobody said that life would be simple but this job was supposed to be over once transfer was complete.

Art


Wayne VanWeerthuizen
 

Anything I can help with? I've not looked at that file for years, but I could give it another look and see what needs revised.

"I like the approach of using a meta-language with common programming concepts and then showing how this can be translated into clip language."

It makes me happy that you appreciated what I was trying to do. The lack of better control flow statements within the clip language had really annoyed me back then. I had intended the "meta-language" as a proof of concept (for Erik to see). My hope was that eventually Erik would add the new control flow commands I suggested into NoteTab natively and make my meta-language obsolete. Sadly, I don't think that ever happened.


Wayne VanWeerthuizen
 

Thomas. you've encouraged me, seventeen years after I first shared it, to release a updated version of the tutorial.

Mainly, I want to update my contact information in it. Also, fix the error you mentioned. I'll retest all the examples using NoteTab Pro 7.2. Not sure if I'll actually add any new content.

Thanks for your feedback. Please, let me know any other ways I can improve the tutorial. I am not giving myself any deadline for this, so it may be days or weeks before I have the new version uploaded.


Wayne VanWeerthuizen
 

"Wow. Someone read it? And in detail?"

At this point I don't know if I should laugh or cry at that sentiment. If the tutorial helped anyone, that makes me happy.

Anyway, looking back on it now, I see years ago I had never actually finished the document how I had intended. It has been so long, I don't remember if I had gotten discouraged from lack of interest, or if I just got busy with other things.
I may have written the "New Clip Commands" clipbook, around the same year, as a different approach to mitigating many of the issues I talked about in the tutorial. I think now that the tutorial outline, and the New Commands clipbook should have been distributed together in one ZIP file, and the tutorial should have added sections on how to use New Clip Commands.

Maybe we turn finishing these old projects of mine into a collaborative project. I'm really rusty and out of practice with lip programming.