Forums Developers Script Documentation

i know, he said that the help file documentated everything in mirc, i just said it didnt.

ok, i'll explain. COMPREHENSIVE does NOT mean everything and every detail. (example: regex and regsub ARE in the help file, and as i pointed out to you before:" It is beyond the scope of this help file to explain how Regular Expressions work"). Codemastr's obvious intent was what better starting place to find the MOST amount of info in one place.

No help file or FAQ is going to hold your hand and detail every possible thing you might ever want to someday use, in every potential way and with what. That does not mean they are not comprehensive.

.......
it wasnt me who suggested it describe everything, or say that it did.

Regex is PCRE, not mIRC. Thats why the helpfile doesn't document it.

from the help file: Regular expressions are basically a grammar that can be used to perfom complicated pattern matching operations. You should already know how to use Regular expressions before using the identifiers below.

why even put it in the help file then?,he could just put it in the command list on this site.

Are you just looking to drag this argument out or do you honestly not understand why the PCRE documentation isn't included in mIRC?

PCRE's documentation isn't included in mIRC's help file for the same reason that the HTTP protocol documentation isn't included in mIRC's help file for the very same reason that the detailed instructions needed to write a mIRC-compatible DLL to control a robotic arm that I stole from NASA to open up my fridge and deliver me a cold beer upon request aren't included in mIRC's help file.

All three are equally beyond the scope of what mIRC's documentation.

Khaled documents features he's added to let scripters know how he's chosen to implement a certian feature. The burdon falls on the scripters to understand why you'd want to use the feature and what is possible when using the feature. The same is true of every language in existance.

-c

In addition to d00d, features are added in the help file to notify a user of their existance, not teach you how to use them. There are some things you should have previous knowledge about.

If I look in the help file for the "compatability"of sockets, i can find it. Its not there to teach you how to use it, its there to show you how to use it.

Just like something as simple as strtok. I open my compiler and type strtok(, it will give me a popup with the neccisary information. Now, should it give me all the documentation and exaples on how to use it also? No. All it tells me is how parameters should be passed, and what i need to do to get it to work--the rest is knowledge gained.

Examples in the help files are there (IMO) due to the generosity of Khaled. He understands many, many users take it apon themselves to learn the mirc language, and understand peole who have never programmed in thier life will be attemping these functions. The fact that he needs to explain how every supported function, alias, and identifier is used is assinine.

I've said my peace, im done. Sorry for the long post but, eyy.. Ive got some free time to kill.

Thanks. Some of that stuff wil help.

you're welcome

thats not what i said,i said that there's no point putting it in the help file when it doesn't help :tongue:

$regex help from the help file is the same as DLL support. mIRC supports both and the help file performs its role by providing basic help to get people off the starting blocks. There is nothing comprehensive there because, as has been stated, it's outside the thrust of what the help file is for.

LMAO, doesn't help? The only person(s) it doesn't help are those who dont know how to use it in the first place. if you dont know how to use it in the first place, why are you even looking at it? Thats like me trying to learn win api by looking at a function call that (im not sure hows it done yet, but just for example's sake) calls a dialog window. Its not going to happen.

im saying that $regex shouldnt be in the help file if it doesnt help.

So you want the regex identifiers to be undocumented because they don't explain regular expressions?! Should $dll also be undocumented because it doesn't teach you C, C++, C#, VB, Object Pascal, ASM or any other langauge with which a DLL could be made and used with that command?

The regular expressions section of the helpfile does help. It helps people who already know regular expressions to learn how they can use regexes within mIRC.

forget i said anything.
got better things to do than argue with ya;\

you mean "better things to do than [lose an] argument with ya"
EDIT:
Such as increase post count, make pointless ramblings, post code that 90% of the time is wrong and unrelated to the topic... etc etc