--- |
-
/setkey [nick or #channel] password+ +To delete the given nick or channel from the configuration file: + +
/delkey nick-or-#channeldiff --git a/share/doc/hexchat-text.md b/share/doc/hexchat-text.md new file mode 100644 index 00000000..30d91a31 --- /dev/null +++ b/share/doc/hexchat-text.md @@ -0,0 +1,3 @@ +# HexChat-Text + +HexChat-Text is an experimental text frontend for HexChat. If anyone wants to add ncurses support, they are welcome to. diff --git a/plugins/perl/hexchat-perl.html b/share/doc/perl.html similarity index 100% rename from plugins/perl/hexchat-perl.html rename to share/doc/perl.html diff --git a/plugins/plugin20.html b/share/doc/plugins.html similarity index 100% rename from plugins/plugin20.html rename to share/doc/plugins.html diff --git a/plugins/python/hexchat-python.md b/share/doc/python.md similarity index 99% rename from plugins/python/hexchat-python.md rename to share/doc/python.md index bc4c6cdc..d998f9d3 100644 --- a/plugins/python/hexchat-python.md +++ b/share/doc/python.md @@ -1,4 +1,4 @@ -% HexChat Python Interface +# HexChat Python Interface Features -------- diff --git a/share/doc/tcl.html b/share/doc/tcl.html new file mode 100644 index 00000000..e4fed393 --- /dev/null +++ b/share/doc/tcl.html @@ -0,0 +1,3675 @@ + + +
This file includes names, descriptions and examples of added commands and TCL language extensions for XChat IRC Client. + +
Tcl Plugin XChat Commands:
+/reload, /source, /tcl
+
Tcl Plugin TCL Commands:
+alias,
+away,
+channel,
+channels,
+chats,
+command,
+complete,
+dcclist,
+findcontext,
+getcontext,
+getinfo,
+getlist,
+host,
+ignores,
+killtimer,
+me,
+network,
+nickcmp,
+off,
+on,
+print,
+queries,
+raw,
+server,
+servers,
+setcontext,
+timer,
+timerexists,
+timers,
+topic,
+users,
+version,
+xchatdir
+
| Name: | +/reload - Clear and reload all tcl scripts. | +
| Synopsis: | +/reload |
+
| Description: | +Clears out and reloads all tcl scripts. Any variables defined and any open files are lost. | +
| See Also: | +/source | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +/source - Load a specific tcl script file. | +
| Synopsis: | +/source filename |
+
| Description: | +Loads a tcl script into XChat. | +
| See Also: | +/reload | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +/tcl - Execute any tcl command | +
| Synopsis: | +/tcl command ?args? |
+
| Description: | +Allows for the immediate execution of any tcl command. | +
| Example: | +/tcl puts "Hello, XChat World!" +/tcl xchatdir |
+
| Downloads: | +Download recommended Tcl plugin support scripts. | +
+ +
| Name: | +alias - Creates a new xchat command. | +||||
| Synopsis: | +alias name { script } |
+||||
| Description: | +Creates a new xchat command and executes script when that command is entered.
+ + +Upon executing the alias, the following variables will be set: + + + +
+ + +You can also hook all text (non-commands) sent to any given tab/window by pre-pending the name of any tab with an '@'. |
+||||
| Example: | +# do 'ls -al' command on any directory
+alias ls {
+ print "[eval "exec ls -al $_rest"]"
+ complete
+}
+
+# uppercase everything I say in #somechannel
+alias @#somechannel {
+ /say [string toupper $_rest]
+ complete
+}
+
+# brag about my uptime
+alias uptime {
+ /say [bold][me]'s Uptime:[bold] [string trim [exec uptime]]
+} |
+||||
| See Also: | +complete, on | +||||
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +away - Returns your /away message. | +
| Synopsis: | +away ?server|context? |
+
| Description: | +Returns your /away message. If no server or context is omitted, the current server is assumed. | +
| Example: | +set awaymsg [away] |
+
| See Also: | +findcontext, getcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +channel - Return the current query/channel name. | +
| Synopsis: | +channel ?context? |
+
| Description: | +Returns the name of the current channel or query. You may also specify a specific context to get the name of. | +
| Example: | +set thischannel [channel] |
+
| See Also: | +channels, findcontext, getcontext, server, servers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +channels - Returns of list of all channels you are in. | +
| Synopsis: | +channels ?server|context? |
+
| Description: | +Returns a list of all channels you are in. If server or context is omitted, the current server is assumed. | +
| Example: | +alias mychannels {
+ foreach s [servers] {
+ print "Server: $s"
+ foreach c [channels $s] {
+ print " - Channel: $c - [topic $s $c]"
+ }
+ }
+ complete
+} |
+
| See Also: | +channel, findcontext, getcontext, server, servers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +chats - Returns a list of opened dcc chats. | +
| Synopsis: | +chats |
+
| Description: | +Returns the name of the current active dcc chats. | +
| Example: | +set mychats [chats] +print "I am directly connected to [join $mychats ", "]" |
+
| See Also: | +channels, dcclist, queries | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +command - Simulate a command entered into xchat. | +
| Synopsis: | +command ?server|context? ?channel|nick? text |
+
| Description: | +Executes any internal or external chat command as if it had been typed into xchat directly. If server or channel|nick are omitted, the current ones are assumed. | +
| Example: | +command "whois [me]" +command #mychannel "me wonders what this does." +command irc.myserver.com #thatchannel "say Hello, World!" +command irc.nyserver.com "away I'm gone" |
+
| See Also: | +findcontext, getcontext, raw | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +complete - Set return mode of an 'on' or 'alias' script | +||||||||
| Synopsis: | +complete ?retcode? |
+||||||||
| Description: | +Similar to TCL's return command, complete halts further processing of an on or alias script and sets a return value.
+ + + +
+ |
+||||||||
| Example: | +on XC_TABOPEN whatever {
+ print "Hello from [channel]"
+ complete
+}
+
+alias bar {
+ /me has been on irc long enough to still be traumatized by !bar scripts.
+ complete
+} |
+||||||||
| See Also: | +alias, on | +||||||||
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +dcclist - Returns detailed information about all dcc chats and files transfers. | +||||||||||||||||||||
| Synopsis: | +dcclist |
+||||||||||||||||||||
| Description: | +Returns a list of all dcc chats and transfers.
+ + + +Each list entry is made up of the following elements: + + + +
+ |
+||||||||||||||||||||
| Example: | +foreach entry [dcclist] {
+ print "$entry"
+} |
+||||||||||||||||||||
| See Also: | +chats | +||||||||||||||||||||
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +findcontext - Finds a context based on a channel and/or server name. | +
| Synopsis: | +findcontext ?server? ?channel|nick? |
+
| Description: | +Finds a context based on a channel and/or server name. If the server is omitted, it finds any channel (or query) by the given name on the current server. If channel|nick is omitted, it finds the default server tab for that server. + | +
| Example: | +set context [findcontext irc.whatever.com] +set context [findcontext #mychannel] +set context [findcontext irc.whatever.com #thatchannel] +set context [findcontext] |
+
| Notes: | +This function is not normally needed with the tclplugin. It is included only to add completeness with the XChat C API. | +
| See Also: | +getcontext, setcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +getcontext - Returns the current context for your plugin. | +
| Synopsis: | +getcontext |
+
| Description: | +Returns the current context for your plugin. You can use this later with setcontext. | +
| Example: | +set context [getcontext] |
+
| Notes: | +This function is not normally needed with the tclplugin. It is included only to add completeness with the XChat C API. | +
| See Also: | +findcontext, setcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +getinfo - Returns information based on your current context. | +||||||||||||||||||
| Synopsis: | +getinfo field |
+||||||||||||||||||
| Description: | +Provides direct access to XChat C API command xhat_get_info. Most of these have replacement tcl plugin commands that offer more functionality.
+ + + +The following fields are currently defined: + + + +
+ |
+||||||||||||||||||
| Example: | +print "I am using XChat [getinfo version]" |
+||||||||||||||||||
| See Also: | +away, channel, host, me, network, server, topic, version, xchatdir | +||||||||||||||||||
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +getlist - Returns information from XChats list of lists | +
| Synopsis: | +getlist ?listname? |
+
| Description: | +Returns a list of information from XChat's internal list of lists. If listname is omitted, the names of all the available lists are returned.
+ + + +The first entry in the list is the names of all the fields for that list. The rest of list are the actual list entries. |
+
| See Also: | +channels, dcclist, ignores, queries, servers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +host - Returns the hostname of the server. | +
| Synopsis: | +host ?server|context? |
+
| Description: | +Returns the hostname of the server you connected to. If you connected to a networks round-robin name, e.g. irc.openprojects.org, irc.newnet.net, etc., it will return that name. If server is omitted, the current one is assumed. | +
| Example: | +print "I attempted to connect to [host] on [network]." +print "I am actually connected to [server]." |
+
| Notes: | +If you want to know the exact server name, use server. | +
| See Also: | +findcontext, getcontext, network, server | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +ignores - Returns list of ignored hosts. | +
| Synopsis: | +ignores |
+
| Description: | +Returns a list of all ignored hosts.
+ + + +Each list entry is made up the hostmask being ignored, followed by a sub-list of the types of ignores on that mask. |
+
| Example: | +set ignorelist [ignores]
+foreach entry $ignorelist {
+ print "Ignoring:"
+ print "[lindex $entry 0]: [lindex $entry 1]"
+} |
+
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +killtimer - Kills the specified timer. | +
| Synopsis: | +killtimer timerID |
+
| Description: | +Removes the specified timerID from the timer queue. | +
| See Also: | +timer, timerexists, timers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +me - Returns your nick. | +
| Synopsis: | +me ?server|context? |
+
| Description: | +Returns your current nick. If server is omitted, the current one is used by default. | +
| See Also: | +findcontext, getcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +network - Returns the name of the network. | +
| Synopsis: | +network ?server|context? |
+
| Description: | +Returns the name of the network, relative to the server list, that you are connected to. If no serveris omitted, the current one current one is used by default. | +
| Example: | +print "I attempted to connect to [host] on [network]." +print "I am actually connected to [server]." |
+
| See Also: | +findcontext, getcontext, host, server | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +nickcmp - Performs an RFC1459 compliant string compare. | +
| Synopsis: | +nickcmp string1 string2 |
+
| Description: | +This command performs an RFC1459 compliant string compare. Use this to compare channels and nicknames. The function works the same way as strcasecmp.
+ + + +Because of IRC's scandanavian origin, the characters {}| are considered to be the lower case equivalents of the characters [], respectively. This is a critical issue when determining the equivalence of two nicknames. |
+
| Returns: | +An integer less than, equal to, or greater than zero if string1 is found, respectively, to be less than, to match, or be greater than string2. | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +off - Removes a script previously assigned with on | +
| Synopsis: | +off token ?label? |
+
| Description: | +Removes a script from the specified XChat token and label. If label is omitted, all scripts for that token are removed. | +
| See Also: | +on | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +on - Execute a command on an irc event | +||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Synopsis: | +on token label { script | procname } |
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Description: | +Whenever token is triggered, script will be executed. label is some descriptive word that identifies which script is being executed when you have multiple scripts assigned to the same event. It is suggested that you use your initials or the name of your script as the 'label'.
+ + + +The token can be any server token or an internal XChat event. When executing your script, the following variables will be set: + + + +
+ + +You may further use splitsrc command to create the additional variables: + + + +
+ + +For channel management scripts, you may use any word with '!' in front (e.g. !pingme") as the token. Any time someone uses that command in a channel or in a private message, the script will be executed. + + + +The following custom XChat internal token are also available: + + + +
+ |
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Example: | +on PRIVMSG example {
+ if { [string match -nocase "*[me]*" $_rest] } {
+ play mynick.wav
+ complete
+ }
+}
+
+on !opme example {
+ splitsrc
+ /op $_nick
+ complete
+}
+
+on XC_TABOPEN example {
+ switch [string index [channel] 0] {
+ "#" -
+ "&" -
+ "(" -
+ "" { return }
+ }
+ play attention.wav
+ print "Now in private conversation with [channel]."
+ complete
+} |
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Notes: | +All events starting with XC_ correspond to the events listed in the Settings->Lists->EventTexts window in XChat. All parameters are appended to $_raw, e.g:
+ + arg1 is [lindex $_raw 1] + arg2 is [lindex $_raw 2] + arg3 is [lindex $_raw 3] + arg4 is [lindex $_raw 4] |
+||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| See Also: | +alias, off | +||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +print - Print text to an xchat window/tab | +
| Synopsis: | +print ?server|context? ?channel|nick? text |
+
| Description: | +Prints text to a window. If a channel|nick is included, the text is printed to that channel/nick. You may also include a specific server. | +
| Example: | +# print text to the current window +print "Hello, World!" + +# print text to the channel or nick window +print #channel "Hello, World!" + +# print text to the channel window +# belonging to a specific server. +print irc.blahblah.com #channel "Hello, World!" |
+
| See Also: | +findcontext, getcontext, puts | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +queries - Returns a list of private queries. | +
| Synopsis: | +queries ?server|context? |
+
| Description: | +Returns a list of all private queries. If server is omitted, the server belonging to the current server is used by default. | +
| Example: | +alias myqueries {
+ foreach s [servers] {
+ print "Server: $s"
+ foreach q [queries $s] {
+ print " - Query: $q"
+ }
+ }
+ complete
+} |
+
| See Also: | +channels, chats, findcontext, getcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +raw - Send a line directly to the server. | +
| Synopsis: | +raw ?server|context? ?channel|nick? text |
+
| Description: | +This command sends text directly to the server without further processing or interpretation by xchat. If server or channel|nick name is omitted, the current ones are used by default. | +
| Example: | +raw "PRIVMSG bubba :Howdy Bubba!" |
+
| See Also: | +command, findcontext, getcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +server - Return the current server. | +
| Synopsis: | +server ?context? |
+
| Description: | +Returns the current server name (what the server claims to be). | +
| Example: | +print "I attempted to connect to [host] on [network]." +print "I am actually connected to [server]." |
+
| See Also: | +findcontext, getcontext, host | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +servers - Returns of list of all servers you are on. | +
| Synopsis: | +servers |
+
| Description: | +Returns a list of all servers you are currently connected to. | +
| Example: | +alias mychannels {
+ foreach s [servers] {
+ print "Server: $s"
+ foreach c [channels $s] {
+ print " - Channel: $c - [topic $s $c]"
+ }
+ }
+ complete
+} |
+
| See Also: | +channel, channels, server | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +setcontext - Changes your current context to the one given. | +
| Synopsis: | +setcontext context |
+
| Description: | +Changes your current context to the one given. The argument context must have been returned by getcontext or findcontext. | +
| Example: | +set context [findcontext #channel] +setcontext $context |
+
| Notes: | +This function is not normally needed with the tclplugin. It is included only to add completeness with the XChat C API. | +
| See Also: | +findcontext, getcontext | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +timer - Executes tcl command after a certain number of seconds have passed. | +
| Synopsis: | +timer ?-repeat? ?-count times? seconds {script | procname ?args?} |
+
| Description: | +Executes a tcl command or script after a certain number of seconds have passed.
+ + + +If the -repeat flag is included, it will will keep repeating until killed with killtimer. If the -count flag is added, it will repeat the number of times specified after the flag. In all other cases, it is executed only once. |
+
| Example: | +timer 5 { /say Times up! } |
+
| Returns: | +timer ID code is to identify the timer with for use with other timer commands. | +
| See Also: | +killtimer, timerexists, timers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +timerexists - Returns 1 if the specified timer exists. | +
| Synopsis: | +timerexists timerID |
+
| Description: | +Determines of the specified timerID exists. | +
| Returns: | +1 if the specified timer exists, 0 otherwise | +
| See Also: | +killtimer, timer, timers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +timers - Returns a list of timers currently active. | +
| Synopsis: | +timers |
+
| Description: | +Returns a list of active timers; each entry in the list contains the timerID, the number of seconds left till activation, the command that will be executed, the number of seconds specified, and the number of times left to be executed. | +
| Example: | +timer 5 { print "Important message coming soon!" }
+timer 10 { print "It is now 10 seconds later! Yay!!!!!" }
+print "[timers]" |
+
| See Also: | +killtimer, timer, timerexists | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +topic - Returns the topic of a channel. | +
| Synopsis: | +topic ?server|context? ?channel? |
+
| Description: | +Returns the channel topic from the current channel or from a specific server and channel. | +
| Example: | +alias mychannels {
+ foreach s [servers] {
+ print "Server: $s"
+ foreach c [channels $s] {
+ print " - Channel: $c - [topic $s $c]"
+ }
+ }
+ complete
+} |
+
| See Also: | +channel, channels, findcontext, getcontext, users | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +users - Returns a list of users in a channel. | +
| Synopsis: | +users ?server|context? ?channel? |
+
| Description: | +Returns a list of all the users in a channel. The list consists of 4 elements; nick, hostmask, channel status and selected. | +
| Example: | +alias listusers {
+ print "- --------------- ----------------------------------------"
+ foreach user [users] {
+ print "[format "%-1s" [lindex $user 2]] [format "%-15s" [lindex $user 0]] [lindex $user 1]"
+ }
+} |
+
| See Also: | +channels, findcontext, getcontext, getlist, servers | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +version - Returns XChat version number. | +
| Synopsis: | +version |
+
| Description: | +Returns the full XChat version number. | +
| Example: | +print "I am using XChat version [version]" |
+
| See Also: | +xchatdir | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
| Name: | +xchatdir - Returns the current xchat config directory. | +
| Synopsis: | +xchatdir |
+
| Description: | +Returns the current xchat config dir within your own user space. | +
| Example: | +print "My XChat config directory is [xchatdir]" |
+
| See Also: | +version | +
| Downloads: | +Download recommended Tcl plugin support scripts. | +
+ + + + diff --git a/src/common/dbus/README b/src/common/dbus/README deleted file mode 100644 index d61cf4e0..00000000 --- a/src/common/dbus/README +++ /dev/null @@ -1,198 +0,0 @@ -For more help you can see the xchat plugin interface documentation. -http://www.xchat.org/docs/plugin20.html -WARNING: The dbus interface may change in the future. - -You can use the "/org/xchat/Remote" object with interface "org.xchat.plugin", -but his context can be changed by other clients at any moment and -you may receive signal asked by other clients. So for more complex usage it's -better to get your own remote object. Using "Connect" method on interface -"org.xchat.connection" - -Available methods on org.xchat.connection interface: - -"Connect" - - Parameters: - - gchar*: filename - - gchar*: name - - gchar*: description - - gchar*: version - - Returns: - - gchar*: Your own object's path. - -"Disconnect" - No parameter, no return value. It frees your remote object. - -Available methods on org.xchat.plugin interface: - -"Command" - - Parameters: - - gchar*: the command name without the "/". (e.g. "nick pseudo") - -"Print" - - Parameters: - - gchar*: text to print on the xchat window. - -"FindContext" - - Parameters: - - gchar*: the server name. Can be NULL. - - gchar*: the channel name. Can be NULL. - - Returns: - - guint: context ID - -"GetContext" - - Returns: - - guint: current context's ID - -"SetContext" - - Parameters: - - guint: context ID to switch, returned by "FindContext" or "GetContext" - - Returns: - - gboolean: 1 for success, 0 for failure. - -"GetInfo" - - Parameters: - - gchar*: ID of the information you want. - - Returns: - - gchar*: information you requested. - -"GetPrefs" - - Parameters: - - gchar*: Setting name required. - - Returns: - - int: 0-Failed 1-Returned a string 2-Returned an Integer - 3-Returned a Boolean. - - gchar*: the information requested if it's a string. - - int: the information requested if it's a integer or boolean. - -"HookCommand" - - Parameters: - - gchar*: Name of the command (without the forward slash). - - int: Priority of this command. - - gchar*: String of text to display when the user executes /help - for this command. May be NULL if you're lazy. - - int: Value to returns when the command is catched. See XCHAT_EAT_*. - - Returns: - - guint: The ID of the hook. - -"HookServer" - - Parameters: - - gchar*: Name of the server event. - - int: Priority of this command. - - int: Value to returns when the command is catched. See XCHAT_EAT_*. - - Returns: - - guint: The ID of the hook. - -"HookPrint" - - Parameters: - - gchar*: Name of the print event. - - int: Priority of this command. - - int: Value to returns when the command is catched. See XCHAT_EAT_*. - - Returns: - - guint: The ID of the hook. - -"Unhook" - - Parameters: - - guint: ID of the hook to unhook. - (the return value of "HookCommand", "HookServer" or "HookPrint") - -"ListGet" - - Parameters: - - gchar*: The list name. - - Returns: - - guint: List ID. - -"ListNext" - - Parameters: - - guint: List ID returned by "ListGet". - - Returns: - - gboolean: says if there is no more item in the list. - -"ListStr" - - Parameters: - - guint: List ID returned by "ListGet". - - gchar*: Name of the information needed. - - Returns: - - gchar*: The information requested. -Warning: "context" attribut of "channels" list should be get with "ListInt" - -"ListInt" - - Parameters: - - guint: List ID returned by "ListGet". - - gchar*: Name of the information needed. - - Returns: - - guint: The information requested. - -"ListTime" - - Parameters: - - guint: List ID returned by "ListGet". - - gchar*: Name of the information needed. - - Returns: - - guint64: The information requested. - -"ListFields" - - Parameters: - - gchar*: The list name. - - Returns: - - gchar**: information names in this list. - -"ListFree" - - Parameters: - - guint: List ID returned by "ListGet". - -"EmitPrint" - - Parameters: - - gchar*: Text event to print. - - gchar**: NULL terminated array of string. - - Returns: - - gboolean: 1-Success 0-Failure. - -"Nickcmp" - - Parameters: - - gchar*: String to compare. - - gchar*: String to compare. - - Returns: - - int: An integer less than, equal to, or greater than zero if s1 is found, - respectively, to be less than, to match, or be greater than s2. - -"Strip" - - Parameters: - - gchar*: String to strip. - - int: Length of the string (or -1 for NULL terminated). - - int: Bit-field of flags: 0-Strip mIRC colors, 1-Strip text attributes. - - Returns: - - gchar*: striped string. - -"SendModes" - - Parameters: - - gchar**: NULL terminated array of targets (strings). The names of people - whom the action will be performed on. - - int: Maximum modes to send per line. - - gchar: Mode sign, '-' or '+'. - - gchar: Mode char, e.g. 'o' for Ops. - - -Available signals: - -"ServerSignal" - - Parameters: - - gchar**: word returned by xchat. - - gchar**: word_eol returned bu xchat. - - guint: the ID of the hook. (the return value of "HookServer"). - - guint: the ID of the context where the event come from. - -"CommandSignal" - - Parameters: - - gchar**: word returned by xchat. - - gchar**: word_eol returned bu xchat. - - guint: the ID of the hook. (the return value of "HookCommand"). - - guint: the ID of the context where the event come from. - -"PrintSignal" - - Parameters: - - gchar**: word returned by xchat. - - guint: the ID of the hook. (the return value of "HookPrint"). - - guint: the ID of the context where the event come from. - -"UnloadSignal" - emited when the user asks to unload your program. - Please exit(0); when received ! diff --git a/src/fe-text/README b/src/fe-text/README deleted file mode 100644 index bb760aae..00000000 --- a/src/fe-text/README +++ /dev/null @@ -1,5 +0,0 @@ -fe-text README -~~~~~~~~~~~~~~ - -This is an experimental text frontend for X-Chat. -If anyone wants to add ncurses support, they are welcome to.