Les
(KiX Master)
2006-01-08 09:57 PM
Suggestion for the manual

I suggest that you dedicate an entire page to the GOTO command. Feel free to go on at great length why it should not be used. Make it a single-sided page of carry the sermon to the other side so that we can then suggest to users that they rip the page out of the manual and not lose parts of GOSUB and IF ELSE ENDIF.

Hmmm... maybe GOSUB should be included.


LonkeroAdministrator
(KiX Master Guru)
2006-01-09 01:17 AM
Re: Suggestion for the manual

lol.
I think the MS word would suite well:
GOTO (deprecated)

GOSUB (deprecated, use UDF's instead, see FUNCTION)


Wizard
(Hey THIS is FUN)
2006-01-09 04:03 PM
Re: Suggestion for the manual

What about just removing from the Manual?
If you can't see it, it's not there!


Radimus
(KiX Supporter)
2006-01-09 04:07 PM
Re: Suggestion for the manual

you can teach the language, but programming is a skill

I'd go with Les... Goto and gosubs are a crutch for sloppy thinking


Radimus
(KiX Supporter)
2006-01-09 06:12 PM
Re: Suggestion for the manual

Here you go Lonk... set up a wiki server here, and we can write our own manual, instead of pointing everyone to SL's online manual

Radimus
(KiX Supporter)
2006-01-09 06:47 PM
Re: Suggestion for the manual

I was screwing around and made an Article on wikipedia

http://en.wikipedia.org/wiki/Kixtart

and the Talk forums for commands

Go get em'


NTDOCAdministrator
(KiX Master)
2006-01-09 07:11 PM
Re: Suggestion for the manual

Wow, did you see the costs of running Wikipedia? Last year was like 3/4 Million dollars.


The Wikimedia Foundation Inc. is the parent organization of Wikipedia, Wiktionary, Wikiquote, Wikibooks (including Wikijunior and Wikiversity), Wikisource, In Memoriam 9/11, Wikimedia Commons, Wikispecies, and Wikinews. It is a non-profit corporation based in St. Petersburg, Florida, USA, and organized under the laws of Florida. Its existence was officially announced by Wikia CEO and Wikipedia founder Jimmy Wales on June 20, 2003


LonkeroAdministrator
(KiX Master Guru)
2006-01-10 12:58 AM
Re: Suggestion for the manual

rad, your commandlist stops and for each
what's up with that?

also, just copying the batch scripting line from the manual is not considered correct, nor best practise nor cool.


LonkeroAdministrator
(KiX Master Guru)
2006-01-10 01:16 AM
Re: Suggestion for the manual

hmmm...
think the wikipedia discussion went of topic.
and rad, there is online manual on kixtart.org too.
altough, it's the SL manual, but I dropped making my own version of it as there is no point.

the problem is not having a manual, but the problem can be the stuff in it.
anyways, the SL docs don't differ that much from the original.
and they even miss some valuable info.

but.
instead of worrying about GOTO or GOSUB being a dinosaur commands, I think we should concentrate on fixing/removing/replacing commands like addProgramItem()
imho.


Radimus
(KiX Supporter)
2006-01-10 01:59 AM
Re: Suggestion for the manual

The point is, that each item can be edited and updated quicker and easier than the word doc, examples can be made and commentary on best practices added at will, by anyone willing to do the work.

Les can denigrate GOTO as much as he likes and provide details of WHY it shouldn't be used... stuff that couldn't be done in any "official" manual

Pointers to specific UDFs can be added to specific commands that exemplify or "replace" them.. like DIR, there are a dozen UDFs that make handling the DIR cmd easier. etc....


LonkeroAdministrator
(KiX Master Guru)
2006-01-10 02:10 AM
Re: Suggestion for the manual

well, the possibility is there already and haven't seen nobody doing nothing about it.
except one member who's currently working on compiler help file.


Bryce
(KiX Supporter)
2006-01-10 02:41 PM
Re: Suggestion for the manual

I played with the wiki idea a little wile ago... never got anywhere with it.

http://wiki.isorg.com