mIRC Home    About    Download    Register    News    Help

Page 1 of 2 1 2 >
Topic Options
#260958 - 09/07/17 12:16 PM Missing Documentation
Protopia Offline
Fjord artisan

Registered: 30/08/03
Posts: 219
Loc: UK
This thread has been started as a place for people to list all the functionality that is not yet documented in the help file:

As a starter (by x-referencing versions.txt since 6.17 with help file):


  • aline / iline / sline / etc. -t
  • $cb(N,u)
  • /setlayer
  • /toolbar -v
  • $window.lb
  • $encode/$decode -celsirznp support for salt/iv
  • $msgstamp
  • $onlineserver / $onlinetotal
  • /timer -z
  • /sockopen -t
  • /list -n
  • $tempfn
  • /rename -f / /copy -f
  • $samepath
  • $chan().iql / $iql()
  • /ialfill
  • $eventid


I don't claim that this list is definitive. Please add any you think are missing.

Perhaps khaled might consider open sourcing the help file on github so that the community can improve the documentation.


Edited by Protopia (09/07/17 01:31 PM)

Top
#260959 - 09/07/17 01:10 PM Re: Missing Documentation [Re: Protopia]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
Probably not a bad idea to start the list, however Khaled stated the best move would be to start an online wiki, which already exists and also has tutorial on all scripting features: https://en.wikichip.org/wiki/mirc
All commands are documented (except for /ialfill) but only half of identifiers are.
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#260961 - 09/07/17 01:34 PM Re: Missing Documentation [Re: Wims]
Protopia Offline
Fjord artisan

Registered: 30/08/03
Posts: 219
Loc: UK
Many of us still use the local help file, and this is also available online and also available through "/help command" - so community updated help would be more generic and convenient than a wiki which is only online and not linked.

Top
#260962 - 09/07/17 01:37 PM Re: Missing Documentation [Re: Wims]
Protopia Offline
Fjord artisan

Registered: 30/08/03
Posts: 219
Loc: UK
Originally Posted By: Wims
All commands are documented (except for /ialfill) but only half of identifiers are.

All commands except /ialfill ... and /setlayer ... and /drawsize and ...


Edited by Protopia (09/07/17 01:38 PM)

Top
#260963 - 09/07/17 01:40 PM Re: Missing Documentation [Re: Protopia]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
Quote:
Many of us still use the local help file, and this is also available online and also available through "/help command" - so community updated help would be more generic and convenient than a wiki which is only online and not linked.
That's why I said this is still a good idea, I myself still ask for the help to be updated.

/setlayer is there, /ialfill and /drawsize are quite new, that's why there aren't, anyone can add them.
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#260964 - 09/07/17 02:19 PM Re: Missing Documentation [Re: Protopia]
Protopia Offline
Fjord artisan

Registered: 30/08/03
Posts: 219
Loc: UK
Comparing the list of commands on the wiki, it appears that the following additional commands are missing from the help file:
  • /ctcp
  • /finger
  • /fsend
  • /hotlink
  • /leave
  • /registration

The wiki is also incomplete and has the following commands missing:
  • /join
  • /kick
  • /nick
  • /nickserv
  • /notice
  • /topic
  • /whois


Edited by Protopia (09/07/17 02:22 PM)

Top
#260965 - 09/07/17 03:41 PM Re: Missing Documentation [Re: Protopia]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
The point of wikichip is to document all the existing identifiers, the removed ones and the deprecated ones, some command and identifier are not documented on purpose in the help file, while some are just undocumented.
/finger is an old things which I believe was removed, (some command support switch which means 'use the finger window'), this shouldn't be documented in the help file.
Wikichip is not missing the commands you listed, there aren't mIRC commands, they are IRC server command, for instance /nickserv is not even a thing, only IRC dealing with nickserv may have this command, it's not even mandatory.
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#260969 - 10/07/17 12:38 AM Re: Missing Documentation [Re: Wims]
Raccoon Offline
Hoopy frood

Registered: 18/02/03
Posts: 2546
/returnex
_________________________
At least I won lunch.
Good philosophy, see good in bad, I like!

Top
#260971 - 10/07/17 01:16 AM Re: Missing Documentation [Re: Protopia]
rockcavera Offline
Ameglian cow

Registered: 05/08/16
Posts: 44
Loc: Brazil
There are some /commands and $identifiers that have no cataloging, neither in help nor in versions.txt

I really do not know why, but some reason exists.

Example: /bdup

Another example refers to this topic
Before I even asked, there was support for the "-a" switch, if I remember correctly, since version 7.42. However, the "-a" switch was only officially cataloged in version 7.48

versions.txt 7.48:

"32.Added -a switch to all binary variable commands that makes them not apply UTF-8 encoding to characters in the range 0-255, as long as the line contains no characters > 255."

The interesting thing would be to catalog everyone in the official mirc help file, but we have the wikichip where users can do it.

I will assist today with the identifier: $regerrstr
Note: I have no idea what it is for. However, by name, it seems to have something to do with regex.
_________________________
rockcavera
#Scripts @ irc.VirtuaLife.com.br

Top
#260974 - 10/07/17 09:49 AM Re: Missing Documentation [Re: Protopia]
TRT Offline
Babel fish

Registered: 22/06/03
Posts: 81
I think this used to be a good starting point:
https://forum.swiftirc.net/viewtopic.php?f=36&t=16859
_________________________
My full script pieces: (COM addons)

Top
#261374 - 16/09/17 05:38 PM Re: Missing Documentation [Re: rockcavera]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
Heh, sadly I remembered from your post that you were saying you couldn't get $regerrstr to work (where in fact you said you had no idea what it's for).
Luckily it came up on IRC and after quick testing it's exactly what the name suggests: it returns the PCRE string version of the error code returned by the different PCRE regex function calls.

@Khaled: I don't know why $regerrstr is undocumented but it is pretty useful to know if a pattern fails because of an error or because there is no match found. Please document this identifier.
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#261400 - 23/09/17 09:37 AM Re: Missing Documentation [Re: Wims]
rockcavera Offline
Ameglian cow

Registered: 05/08/16
Posts: 44
Loc: Brazil
I saw it on the channel.

Thank you.
_________________________
rockcavera
#Scripts @ irc.VirtuaLife.com.br

Top
#262625 - 02/03/18 03:18 PM Re: Missing Documentation [Re: Wims]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
The new on hotlink syntax with $hotlink and /hotlink aren't documented: https://forums.mirc.com/ubbthreads.php/ubb/showflat/Number/260721/

The new -p switch on /var and /set isn't documented

The new /fupdate isn't documented
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#262965 - 27/04/18 10:23 PM Re: Missing Documentation [Re: Protopia]
Erasimus Offline
Babel fish

Registered: 26/04/18
Posts: 58
2 that are currently bugging me are to do with the Dialog List 'control' and, in particluar, the styles size and extsel,

Both are mentioned in mIRC Help as far as their existance -
'list id, x y w h, style (sort, extsel, multsel, size, vsbar, hsbar, check, radio)'

but no explation.

WikiChip has extsel with -
'Allows extra selection support',
but nothing further. What extra selction support ?

So what do they do ?

Top
#262966 - 27/04/18 10:30 PM Re: Missing Documentation [Re: Erasimus]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
it means you can control how you select item in the list, namely using the control key and clicking

I edited the wikichip explanation to illustrate the difference using the word 'consecutive'.


Edited by Wims (27/04/18 10:33 PM)
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#262967 - 28/04/18 05:17 AM Re: Missing Documentation [Re: Wims]
Erasimus Offline
Babel fish

Registered: 26/04/18
Posts: 58
I think I saw that explanation, but to me that sounds like a description of the style multsel which allows multiple entries to be selected using the control key and click together.

Isn't that what you just said about extsel ? or have I mixed the 2 styles up ?

Top
#262971 - 28/04/18 10:25 AM Re: Missing Documentation [Re: Erasimus]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
That's right, sorry, feel free to edit back on wikichip if you want, I'll do it later if not done.
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#263266 - 24/06/18 02:40 AM Re: Missing Documentation [Re: Protopia]
KindOne Offline
Fjord artisan

Registered: 23/02/11
Posts: 310
05/09/2000 - mIRC v5.8
Quote:

128.Added hash table support for scripting. A hash table can be
created/destroyed/modified using:
...
/hsave also supports -o to overwite an existing file, and -a to
append to an existing file.


Missing the -o.
_________________________
irc.swiftirc.net #msl (mIRC Scripting Language)

Top
#263267 - 24/06/18 11:11 AM Re: Missing Documentation [Re: KindOne]
Khaled Offline


Planetary brain

Registered: 04/12/02
Posts: 4344
Loc: London, UK
Thanks, however the -o switch was made the default in later versions, so it was no longer needed.

Top
#263276 - 26/06/18 04:36 AM Re: Missing Documentation [Re: Khaled]
westor Offline
Hoopy frood

Registered: 27/12/08
Posts: 1511
Loc: Greece
Missing details from help file.

/fupdate hole command informations.
-p parameter from /set command.


Edited by westor (26/06/18 04:52 AM)
_________________________
Need Online mIRC help or an mIRC Scripting Freelancer? -> http://westor.ucoz.com/contact <-

Top
#263508 - 13/08/18 04:26 PM Re: Missing Documentation [Re: Khaled]
Wims Offline
Planetary brain

Registered: 31/07/06
Posts: 3468
Loc: France
$window().cx $window().cy, $mouse.cx and $mouse.cy are missing from the help file.
_________________________
Looking for a good help channel about mIRC? Check #mircscripting @ irc.swiftirc.net

Top
#264586 - 16/12/18 11:49 PM Re: Missing Documentation [Re: Wims]
maroon Offline
Hoopy frood

Registered: 12/01/04
Posts: 1062
7.52's /fupdate and 7.53's $caller not documented in /help

also, if the /fupdate setting isn't going to be saved to mirc.ini [options], could there be something like an $fupdate identifier which returns the 0-100 value shown by /fupdate? This would allow scripts to save/restore the existing value, so they could change it during a specific burst of output.

Top
#265048 - Today at 06:59 AM Re: Missing Documentation [Re: maroon]
maroon Offline
Hoopy frood

Registered: 12/01/04
Posts: 1062
/help /dll says:

Quote:

Note: The data and parms variables can each hold 900 chars maximum.


Could the dll page be updated from '900 chars' to indicate the current max limit in bytes, now that Unicode means chars and bytes aren't the same thing?

Most DLL's won't care as long as the length is longer than 8292, but the info would be useful for a DLL which needs to support languages from the unicode codepoints above 2047 where each 'char' requires 3 bytes.

I've only tested 'data but not 'parms', but 900 appears to be an obsolete number from older 6.x versions which had that shorter line length. I tested to see how long of a text string of hex digits could be written into 'data' for sending back to mIRC, before it crashes mIRC. The byte length in 6.35 seems to be a few dozen bytes longer than than the 4150 limit. In 7.52 the byte length limit was somewhere around 8400 bytes, I'm assuming this extra length is for supporting multi-byte unicode characters. And now that the line length limit has doubled, the valid string bytes-length has doubled above 16k.

Top
Page 1 of 2 1 2 >