The hard part is knowing which parts of the language use “IndexOf” - as far as I know, the online language reference can’t be globally searched for all instances of “IndexOf” to find those things that need changing.
If Xojo would make a conversion table that shows all of the old syntaxes next to the new, it would be much simpler to go down the list and, change by change, go through our code to find everything that needs modifying, in an organized way. IMHO, simply having that comparative list (which would not include things that haven’t changed) could go a long way towards cooling the heat around this subject.
I think the only thing it changed on is strings when InStr was eliminated in favor of IndexOf. And that makes sense. I don’t know if anything else that went from 1 to 0. Maybe I missed them?
I think most things were 0 based anyway API just fixed the few stragglers that were not
Not really sure if going from 1 based to 0 based would cause anyone to stress and give up on any project moving towards API 2
In general I don’t mind the API2 improvements. I think forcing us to use them in certain instances is not good (ie: mobile - but mobile never existed before API2 so maybe they have an excuse). My biggest issue is with all the different control names and the fact that everything is fragmented. I don’t like the fact that event names changed, etc. That I can live with. But the multitude of different controls we now have to contend with and the documentation headaches that follow are my biggest issues.
Oh gosh no! While I don’t mind things like String.IndexOf instead of InStr (but hey - that was one of the first BASIC functions I learned in the 1980s…) and Integer.FromString instead of VAL, other things are necessary. VAR instead of DIM (which I continue to use), MessageBox instead of the much shorter MsgBox, etc. And Opening instead of Open and similar were frankly unnecessary.
I agree! When I first learned PHP, it was the user comments at the bottom of each page of the documentation that often taught me more than anything else.
I was actually thinking of going one step further: letting volunteers update entries that need it. Xojo would probably want to limit that to certain people who apply to do so, as opposed to commentators being anyone with an account. And I’m sure Xojo would want to have final say over approving/publishing any changes. But I bet people would volunteer and it would get the documentation up to speed much sooner.
I must be an API2 “antivaxer” because I too plan to stick with API1. I tried to upgrade a large project to API2 and after two days of solid work, gave up. But I wonder why you say API1 is useless? Am I missing something?