cvs: phpdoc /en/reference/ircg reference.xml /en/reference/ircg/functions ircg-channel-mode.xml ircg-disconnect.xml ircg-fetch-error-msg.xml
ircg-get-username.xml ircg-html-encode.xml ircg-ignore-add.xml ircg-ignore-del.xml ircg-is-conn-alive.xml ircg-join.xml
ircg-lookup-format-messages.xml ircg-msg.xml ircg-nick.xml ircg-nickname-escape.xml ircg-notice.xml ircg-pconnect.xml
ircg-register-format-messages.xml ircg-set-current.xml ircg-set-on-die.xml ircg-whois.xml
| From: | Sascha Schumann | Date: | Wed, 27 Nov 2002 16:50:10 +0000 |
| Subject: | cvs: phpdoc /en/reference/ircg reference.xml /en/reference/ircg/functions ircg-channel-mode.xml ircg-disconnect.xml ircg-fetch-error-msg.xml ircg-get-username.xml ircg-html-encode.xml ircg-ignore-add.xml ircg-ignore-del.xml ircg-is-conn-alive.xml ircg-join.xml ircg-lookup-format-messages.xml ircg-msg.xml ircg-nick.xml ircg-nickname-escape.xml ircg-notice.xml ircg-pconnect.xml ircg-register-format-messages.xml ircg-set-current.xml ircg-set-on-die.xml ircg-whois.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969349976@lists.php.net to get a copy of this message | ||
sas Wed Nov 27 11:50:10 2002 EDT
Modified files:
/phpdoc/en/reference/ircg reference.xml
/phpdoc/en/reference/ircg/functions ircg-channel-mode.xml
ircg-disconnect.xml
ircg-fetch-error-msg.xml
ircg-get-username.xml
ircg-html-encode.xml
ircg-ignore-add.xml
ircg-ignore-del.xml
ircg-is-conn-alive.xml
ircg-join.xml
ircg-lookup-format-messages.xml
ircg-msg.xml ircg-nick.xml
ircg-nickname-escape.xml
ircg-notice.xml
ircg-pconnect.xml
ircg-register-format-messages.xml
ircg-set-current.xml
ircg-set-on-die.xml
ircg-whois.xml
Log:
some improvements here and there
Index: phpdoc/en/reference/ircg/reference.xml diff -u phpdoc/en/reference/ircg/reference.xml:1.3 phpdoc/en/reference/ircg/reference.xml:1.4 --- phpdoc/en/reference/ircg/reference.xml:1.3 Sun Jul 21 12:17:16 2002 +++ phpdoc/en/reference/ircg/reference.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.ircg"> <title>IRC Gateway Functions</title> <titleabbrev>IRC Gateway</titleabbrev> @@ -8,11 +8,16 @@ <section id="ircg.intro"> &reftitle.intro; <para> - With ircg you can build powerful, fast and scalable webchat - solutions in conjunction with dedicated or public IRC servers. + With IRCG you can rapidly stream XML data to thousands of concurrently + connected users. This can be used to build powerful, extensible + interactive platforms such as online games and webchats. + IRCG also features support for a non-streaming mode where a helper + application reformats incoming data and supplies static file snippets in + special formats such as cHTML (i-mode) or WML (WAP). These static files + are then delivered by the high-performance web server. </para> <para> - IRCG runs under tis platforms: + Up to v3, IRCG runs under these platforms: <itemizedlist> <listitem><para>AIX</para></listitem> <listitem><para>FreeBSD</para></listitem> @@ -25,35 +30,12 @@ </para> </section> - <section id="ircg.requirements"> - &reftitle.required; - <para> - To install and use IRCG you need the following software: - <orderedlist> - <listitem> - <para> - <ulink url="&url.ircg;">IRCG-Library</ulink> from Sascha Schumann. - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.st-threads;">SGI Static Threads Library</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.thttpd;">thttpd</ulink> webserver - </para> - </listitem> - </orderedlist> - </para> - </section> - <section id="ircg.install"> &reftitle.install; <para> - A detailed installation instruction can be found - <ulink url="&url.ircg-install;">here</ulink>. + Detailed installation instructions can be found + <ulink url="&url.ircg-install;">here</ulink>. We urge you to use + the provided installation script. </para> </section> Index: phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml diff -u phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml:1.2 Wed Apr 17 02:39:33 2002 +++ phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-channel-mode"> <refnamediv> @@ -24,10 +24,10 @@ the user specified by <parameter>nick</parameter>. </para> <para> - Mode flags are set or cleared by specifind a mode character and - prepending it with a plus or minus character + Mode flags are set or cleared by specifying a mode character and + prepending it with a plus or minus character, respectively. E.g. operator mode is granted by '+o' and revoked - by '-o' passed as <parameter>mode_spec</parameter>. + by '-o', as passed as <parameter>mode_spec</parameter>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-disconnect.xml diff -u phpdoc/en/reference/ircg/functions/ircg-disconnect.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-disconnect.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-disconnect.xml:1.2 Wed Apr 17 02:39:34 2002 +++ phpdoc/en/reference/ircg/functions/ircg-disconnect.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-disconnect"> <refnamediv> @@ -18,7 +18,7 @@ <para> <function>ircg_disconnect</function> will close a <parameter>connection</parameter> to a server previously - established with <function>ircg-pconnect</function>. + established with <function>ircg_pconnect</function>. </para> <para> See also: <function>ircg_pconnect</function>. Index: phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml diff -u phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml:1.2 Wed Apr 17 02:39:34 2002 +++ phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.7 --> <refentry id="function.ircg-fetch-error-msg"> <refnamediv> <refname>ircg_fetch_error_msg</refname> <refpurpose> - Returns the error from previous ircg operation + Returns the error from previous IRCG operation </refpurpose> </refnamediv> <refsect1> @@ -16,11 +16,13 @@ </methodsynopsis> <para> <function>ircg_fetch_error_msg</function> returns the error from - the last called ircg function. + a failed connection. </para> <note> <para> - Errorcode is stored in first array element, errortext in second. + Error code is stored in first array element, error text in second. + The error code is equivalent to IRC reply codes as defined by + RFC 2812. </para> </note> <para> @@ -30,7 +32,7 @@ <![CDATA[ if (!ircg_join ($id, "#php")) { $error = ircg_fetch_error_msg($id); - print ("Can't join channel #php. Errorcode: + print ("Can't join channel #php. Error code: $error[0] Description: $error[1]"); } ]]> Index: phpdoc/en/reference/ircg/functions/ircg-get-username.xml diff -u phpdoc/en/reference/ircg/functions/ircg-get-username.xml:1.3 phpdoc/en/reference/ircg/functions/ircg-get-username.xml:1.4 --- phpdoc/en/reference/ircg/functions/ircg-get-username.xml:1.3 Sun Jul 21 12:16:49 2002 +++ phpdoc/en/reference/ircg/functions/ircg-get-username.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id='function.ircg-get-username'> <refnamediv> @@ -16,7 +16,7 @@ </methodsynopsis> <para> Function <function>ircg_get_username</function> returns the - username for specified connection <parameter>connection</parameter>. + username for the specified connection <parameter>connection</parameter>. Returns &false; if <parameter>connection</parameter> died or is not valid. </para> Index: phpdoc/en/reference/ircg/functions/ircg-html-encode.xml diff -u phpdoc/en/reference/ircg/functions/ircg-html-encode.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-html-encode.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-html-encode.xml:1.2 Wed Apr 17 02:39:34 2002 +++ phpdoc/en/reference/ircg/functions/ircg-html-encode.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-html-encode"> <refnamediv> @@ -16,8 +16,10 @@ </methodsynopsis> <para> Encodes a HTML string <parameter>html_string</parameter> for - output. This feature could be usable, e.g. if someone wants to - discuss about an html problem. + output. This exposes the interface which the IRCG extension + uses internally to reformat data coming from an IRC link. + The function causes IRC color/font codes to be encoded in + HTML and escapes certain entities. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml diff -u phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-ignore-add"> <refnamediv> @@ -16,10 +16,10 @@ <methodparam><type>string</type><parameter>nick</parameter></methodparam> </methodsynopsis> <para> - This function will add user <parameter>nick</parameter> to your - ignore list on the server connected to by - <parameter>connection</parameter>. By doing so you will suppress - all messages from this user from being send to you. + This function adds user <parameter>nick</parameter> to the + ignore list of connection + <parameter>connection</parameter>. Afterwards, IRCG will suppress + all messages from this user through the associated connection. </para> <para> See also: <function>ircg_ignore_del</function>. Index: phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml diff -u phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-ignore-del"> <refnamediv> @@ -16,9 +16,8 @@ <methodparam><type>string</type><parameter>nick</parameter></methodparam> </methodsynopsis> <para> - This function remove user <parameter>nick</parameter> from your - ignore list on the server connected to by - <parameter>connection</parameter>. + This function removes user <parameter>nick</parameter> from the IRCG + ignore list associated with <parameter>connection</parameter>. </para> <para> See also: <function>ircg_ignore_add</function>. Index: phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml diff -u phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-is-conn-alive"> <refnamediv> @@ -17,7 +17,7 @@ <para> <function>ircg_is_conn_alive</function> returns &true; if <parameter>connection</parameter> is still alive and working or - &false; if the server no longer talks to us. + &false;, if the connection has died for some reason. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-join.xml diff -u phpdoc/en/reference/ircg/functions/ircg-join.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-join.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-join.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-join.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-join"> <refnamediv> @@ -14,10 +14,12 @@ <type>boolean</type><methodname>ircg_join</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>channel</parameter></methodparam> + <methodparam type="opt"><type>string</type><parameter>key</parameter></methodparam> </methodsynopsis> <para> Join the channel <parameter>channel</parameter> on the server - connected to by <parameter>connection</parameter>. + connected to by <parameter>connection</parameter>. IRCG will + optionally pass the room key <parameter>key</parameter>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml diff -u phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-lookup-format-messages"> <refnamediv> <refname>ircg_lookup_format_messages</refname> <refpurpose> - Select a set of format strings for display of IRC messages + Check for the existence of a format message set </refpurpose> </refnamediv> <refsect1> @@ -15,10 +15,11 @@ <methodparam><type>string</type><parameter>name</parameter></methodparam> </methodsynopsis> <para> - Select the set of format strings to use for display of IRC - messages and events. Sets may be registered with + Check for the existence of the format message set + <parameter>name</parameter>. Sets may be registered with <function>ircg_register_format_messages</function>, a default set - named <literal>ircg</literal> is always available. + named <literal>ircg</literal> is always available. Returns &true;, + if the set exists and &false; otherwise. </para> <para> See also: <function>ircg_register_format_messages</function> Index: phpdoc/en/reference/ircg/functions/ircg-msg.xml diff -u phpdoc/en/reference/ircg/functions/ircg-msg.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-msg.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-msg.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-msg.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-msg"> <refnamediv> @@ -29,7 +29,9 @@ <para> Setting the optional parameter <parameter>suppress</parameter> to a &true; value will suppress output of your message to your own - <parameter>connection</parameter>. + <parameter>connection</parameter>. This so-called loopback is + necessary, because the IRC server does not echo PRIVMSG commands + back to us. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-nick.xml diff -u phpdoc/en/reference/ircg/functions/ircg-nick.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-nick.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-nick.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-nick.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-nick"> <refnamediv> @@ -18,7 +18,7 @@ <para> Change your nickname on the given <parameter>connection</parameter> to the one given in - <parameter>nick</parameter> if possible. + <parameter>nick</parameter>, if possible. </para> <para> Will return &true; on success and &false; on failure. Index: phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml diff -u phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id='function.ircg-nickname-escape'> <refnamediv> @@ -15,7 +15,7 @@ <methodparam><type>string</type><parameter>nick</parameter></methodparam> </methodsynopsis> <para> - Function <function>ircg_nickname_escape</function> returns a decoded + Function <function>ircg_nickname_escape</function> returns an encoded nickname specified by <parameter>nick</parameter> wich is IRC-compliant. </para> <para> Index: phpdoc/en/reference/ircg/functions/ircg-notice.xml diff -u phpdoc/en/reference/ircg/functions/ircg-notice.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-notice.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-notice.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-notice.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-notice"> <refnamediv> @@ -19,9 +19,9 @@ <para> This function will send the <parameter>message</parameter> text to the user <parameter>nick</parameter> on the server connected - to by <parameter>connection</parameter>. Query your IRC - documentation of choice for the exact difference between a MSG - and a NOTICE. + to by <parameter>connection</parameter>. IRC servers and other + software will not automatically generate replies to NOTICEs + in contrast to other message types. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-pconnect.xml diff -u phpdoc/en/reference/ircg/functions/ircg-pconnect.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-pconnect.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-pconnect.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-pconnect.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-pconnect"> <refnamediv> @@ -34,25 +34,28 @@ <para> For now parameter <parameter>server_ip</parameter> will not do any hostname lookups and will only accept IP addresses in - numerical form. - </para> - <para> - Currently <function>ircg_pconnect</function> always returns a valid - handle, even if the connection failed. + numerical form. DNS lookups are expensive and should be done in the + context of IRCG. </para> </note> </para> <para> You can customize the output of IRC messages and events by - selection a format string set previously created with - <function>ircg_register_format_messages</function> by specifing - the sets name in <parameter>msg_format</parameter>. + selecting a format message set previously created with + <function>ircg_register_format_messages</function> by specifying + the set's name in <parameter>msg_format</parameter>. </para> <para> - <parameter>ctcp_messages</parameter> + If you want to handle CTCP messages such as ACTION (/me), you need to + define a mapping from CTCP type (e.g. ACTION) to a custom format + string. Do this by passing an associative array as + <parameter>ctcp_messages</parameter>. The keys of the array + are the CTCP type and the respective value is the format message. </para> <para> - <parameter>user_settings</parameter> + You can define "ident", "password", and "realname" tokens which + are sent to the IRC server by setting these in an associative + array. Pass that array as <parameter>user_settings</parameter>. </para> <para> See also: <function>ircg_disconnect</function>, Index: phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml diff -u phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id="function.ircg-register-format-messages"> <refnamediv> <refname>ircg_register_format_messages</refname> <refpurpose> - Register a set of format strings for display of IRC messages + Register a format message set </refpurpose> </refnamediv> <refsect1> @@ -17,9 +17,8 @@ </methodsynopsis> <para> With <function>ircg_register_format_messages</function> you can - customize the way your IRC output looks like. You can even - register different format string sets and switch between them on - the fly with <function>ircg_lookup_format_messages</function>. + customize the way your IRC output looks like or which script + functions are invoked on the client side. </para> <para> <itemizedlist> Index: phpdoc/en/reference/ircg/functions/ircg-set-current.xml diff -u phpdoc/en/reference/ircg/functions/ircg-set-current.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-set-current.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-set-current.xml:1.2 Wed Apr 17 02:39:38 2002 +++ phpdoc/en/reference/ircg/functions/ircg-set-current.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-set-current"> <refnamediv> @@ -15,16 +15,14 @@ <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> - Select the current connection for output in this execution + Select the current HTTP connection for output in this execution context. Every output sent from the server connected to by <parameter>connection</parameter> will be copied to standard - output while using default formatting or a format string set - specified by <function>ircg_register_format_messages</function> - and selected by <function>ircg_lookup_format_messages</function>. + output while using default formatting or a format message set + specified by <function>ircg_register_format_messages</function>. </para> <para> - See also: <function>ircg_register_format_messages</function> and - <function>ircg_lookup_format_messages</function>. + See also: <function>ircg_register_format_messages</function>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml diff -u phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml:1.3 phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml:1.4 --- phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml:1.3 Sun Jul 21 12:16:50 2002 +++ phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id='function.ircg-set-on-die'> <refnamediv> <refname>ircg_set_on_die</refname> <refpurpose> - Set hostaction to be execute when connection dies + Set action to be executed when connection dies </refpurpose> </refnamediv> <refsect1> @@ -24,7 +24,10 @@ IRCG does not resolve host-names due to blocking issues), send <parameter>data</parameter> to the new host connection and will wait until the remote part closes connection. This can be used to - trigger a php script for example. + trigger a PHP script for example. + </para> + <para> + This feature requires IRCG 3. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-whois.xml diff -u phpdoc/en/reference/ircg/functions/ircg-whois.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-whois.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-whois.xml:1.2 Wed Apr 17 02:39:40 2002 +++ phpdoc/en/reference/ircg/functions/ircg-whois.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-whois"> <refnamediv> <refname>ircg_whois</refname> <refpurpose> - Query user information for nick on server + Query server for user information </refpurpose> </refnamediv> <refsect1> @@ -17,7 +17,7 @@ </methodsynopsis> <para> Sends a query to the connected server - <parameter>connection</parameter> to send information for the + <parameter>connection</parameter> to ask for information about the specified user <parameter>nick</parameter>. </para> </refsect1>
Index: phpdoc/en/reference/ircg/reference.xml diff -u phpdoc/en/reference/ircg/reference.xml:1.3 phpdoc/en/reference/ircg/reference.xml:1.4 --- phpdoc/en/reference/ircg/reference.xml:1.3 Sun Jul 21 12:17:16 2002 +++ phpdoc/en/reference/ircg/reference.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <reference id="ref.ircg"> <title>IRC Gateway Functions</title> <titleabbrev>IRC Gateway</titleabbrev> @@ -8,11 +8,16 @@ <section id="ircg.intro"> &reftitle.intro; <para> - With ircg you can build powerful, fast and scalable webchat - solutions in conjunction with dedicated or public IRC servers. + With IRCG you can rapidly stream XML data to thousands of concurrently + connected users. This can be used to build powerful, extensible + interactive platforms such as online games and webchats. + IRCG also features support for a non-streaming mode where a helper + application reformats incoming data and supplies static file snippets in + special formats such as cHTML (i-mode) or WML (WAP). These static files + are then delivered by the high-performance web server. </para> <para> - IRCG runs under tis platforms: + Up to v3, IRCG runs under these platforms: <itemizedlist> <listitem><para>AIX</para></listitem> <listitem><para>FreeBSD</para></listitem> @@ -25,35 +30,12 @@ </para> </section> - <section id="ircg.requirements"> - &reftitle.required; - <para> - To install and use IRCG you need the following software: - <orderedlist> - <listitem> - <para> - <ulink url="&url.ircg;">IRCG-Library</ulink> from Sascha Schumann. - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.st-threads;">SGI Static Threads Library</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="&url.thttpd;">thttpd</ulink> webserver - </para> - </listitem> - </orderedlist> - </para> - </section> - <section id="ircg.install"> &reftitle.install; <para> - A detailed installation instruction can be found - <ulink url="&url.ircg-install;">here</ulink>. + Detailed installation instructions can be found + <ulink url="&url.ircg-install;">here</ulink>. We urge you to use + the provided installation script. </para> </section> Index: phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml diff -u phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml:1.2 Wed Apr 17 02:39:33 2002 +++ phpdoc/en/reference/ircg/functions/ircg-channel-mode.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-channel-mode"> <refnamediv> @@ -24,10 +24,10 @@ the user specified by <parameter>nick</parameter>. </para> <para> - Mode flags are set or cleared by specifind a mode character and - prepending it with a plus or minus character + Mode flags are set or cleared by specifying a mode character and + prepending it with a plus or minus character, respectively. E.g. operator mode is granted by '+o' and revoked - by '-o' passed as <parameter>mode_spec</parameter>. + by '-o', as passed as <parameter>mode_spec</parameter>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-disconnect.xml diff -u phpdoc/en/reference/ircg/functions/ircg-disconnect.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-disconnect.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-disconnect.xml:1.2 Wed Apr 17 02:39:34 2002 +++ phpdoc/en/reference/ircg/functions/ircg-disconnect.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-disconnect"> <refnamediv> @@ -18,7 +18,7 @@ <para> <function>ircg_disconnect</function> will close a <parameter>connection</parameter> to a server previously - established with <function>ircg-pconnect</function>. + established with <function>ircg_pconnect</function>. </para> <para> See also: <function>ircg_pconnect</function>. Index: phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml diff -u phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml:1.2 Wed Apr 17 02:39:34 2002 +++ phpdoc/en/reference/ircg/functions/ircg-fetch-error-msg.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.7 --> <refentry id="function.ircg-fetch-error-msg"> <refnamediv> <refname>ircg_fetch_error_msg</refname> <refpurpose> - Returns the error from previous ircg operation + Returns the error from previous IRCG operation </refpurpose> </refnamediv> <refsect1> @@ -16,11 +16,13 @@ </methodsynopsis> <para> <function>ircg_fetch_error_msg</function> returns the error from - the last called ircg function. + a failed connection. </para> <note> <para> - Errorcode is stored in first array element, errortext in second. + Error code is stored in first array element, error text in second. + The error code is equivalent to IRC reply codes as defined by + RFC 2812. </para> </note> <para> @@ -30,7 +32,7 @@ <![CDATA[ if (!ircg_join ($id, "#php")) { $error = ircg_fetch_error_msg($id); - print ("Can't join channel #php. Errorcode: + print ("Can't join channel #php. Error code: $error[0] Description: $error[1]"); } ]]> Index: phpdoc/en/reference/ircg/functions/ircg-get-username.xml diff -u phpdoc/en/reference/ircg/functions/ircg-get-username.xml:1.3 phpdoc/en/reference/ircg/functions/ircg-get-username.xml:1.4 --- phpdoc/en/reference/ircg/functions/ircg-get-username.xml:1.3 Sun Jul 21 12:16:49 2002 +++ phpdoc/en/reference/ircg/functions/ircg-get-username.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id='function.ircg-get-username'> <refnamediv> @@ -16,7 +16,7 @@ </methodsynopsis> <para> Function <function>ircg_get_username</function> returns the - username for specified connection <parameter>connection</parameter>. + username for the specified connection <parameter>connection</parameter>. Returns &false; if <parameter>connection</parameter> died or is not valid. </para> Index: phpdoc/en/reference/ircg/functions/ircg-html-encode.xml diff -u phpdoc/en/reference/ircg/functions/ircg-html-encode.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-html-encode.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-html-encode.xml:1.2 Wed Apr 17 02:39:34 2002 +++ phpdoc/en/reference/ircg/functions/ircg-html-encode.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-html-encode"> <refnamediv> @@ -16,8 +16,10 @@ </methodsynopsis> <para> Encodes a HTML string <parameter>html_string</parameter> for - output. This feature could be usable, e.g. if someone wants to - discuss about an html problem. + output. This exposes the interface which the IRCG extension + uses internally to reformat data coming from an IRC link. + The function causes IRC color/font codes to be encoded in + HTML and escapes certain entities. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml diff -u phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-ignore-add.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-ignore-add"> <refnamediv> @@ -16,10 +16,10 @@ <methodparam><type>string</type><parameter>nick</parameter></methodparam> </methodsynopsis> <para> - This function will add user <parameter>nick</parameter> to your - ignore list on the server connected to by - <parameter>connection</parameter>. By doing so you will suppress - all messages from this user from being send to you. + This function adds user <parameter>nick</parameter> to the + ignore list of connection + <parameter>connection</parameter>. Afterwards, IRCG will suppress + all messages from this user through the associated connection. </para> <para> See also: <function>ircg_ignore_del</function>. Index: phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml diff -u phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-ignore-del.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-ignore-del"> <refnamediv> @@ -16,9 +16,8 @@ <methodparam><type>string</type><parameter>nick</parameter></methodparam> </methodsynopsis> <para> - This function remove user <parameter>nick</parameter> from your - ignore list on the server connected to by - <parameter>connection</parameter>. + This function removes user <parameter>nick</parameter> from the IRCG + ignore list associated with <parameter>connection</parameter>. </para> <para> See also: <function>ircg_ignore_add</function>. Index: phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml diff -u phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-is-conn-alive.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-is-conn-alive"> <refnamediv> @@ -17,7 +17,7 @@ <para> <function>ircg_is_conn_alive</function> returns &true; if <parameter>connection</parameter> is still alive and working or - &false; if the server no longer talks to us. + &false;, if the connection has died for some reason. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-join.xml diff -u phpdoc/en/reference/ircg/functions/ircg-join.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-join.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-join.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-join.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-join"> <refnamediv> @@ -14,10 +14,12 @@ <type>boolean</type><methodname>ircg_join</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>channel</parameter></methodparam> + <methodparam type="opt"><type>string</type><parameter>key</parameter></methodparam> </methodsynopsis> <para> Join the channel <parameter>channel</parameter> on the server - connected to by <parameter>connection</parameter>. + connected to by <parameter>connection</parameter>. IRCG will + optionally pass the room key <parameter>key</parameter>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml diff -u phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-lookup-format-messages.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-lookup-format-messages"> <refnamediv> <refname>ircg_lookup_format_messages</refname> <refpurpose> - Select a set of format strings for display of IRC messages + Check for the existence of a format message set </refpurpose> </refnamediv> <refsect1> @@ -15,10 +15,11 @@ <methodparam><type>string</type><parameter>name</parameter></methodparam> </methodsynopsis> <para> - Select the set of format strings to use for display of IRC - messages and events. Sets may be registered with + Check for the existence of the format message set + <parameter>name</parameter>. Sets may be registered with <function>ircg_register_format_messages</function>, a default set - named <literal>ircg</literal> is always available. + named <literal>ircg</literal> is always available. Returns &true;, + if the set exists and &false; otherwise. </para> <para> See also: <function>ircg_register_format_messages</function> Index: phpdoc/en/reference/ircg/functions/ircg-msg.xml diff -u phpdoc/en/reference/ircg/functions/ircg-msg.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-msg.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-msg.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-msg.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-msg"> <refnamediv> @@ -29,7 +29,9 @@ <para> Setting the optional parameter <parameter>suppress</parameter> to a &true; value will suppress output of your message to your own - <parameter>connection</parameter>. + <parameter>connection</parameter>. This so-called loopback is + necessary, because the IRC server does not echo PRIVMSG commands + back to us. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-nick.xml diff -u phpdoc/en/reference/ircg/functions/ircg-nick.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-nick.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-nick.xml:1.2 Wed Apr 17 02:39:35 2002 +++ phpdoc/en/reference/ircg/functions/ircg-nick.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-nick"> <refnamediv> @@ -18,7 +18,7 @@ <para> Change your nickname on the given <parameter>connection</parameter> to the one given in - <parameter>nick</parameter> if possible. + <parameter>nick</parameter>, if possible. </para> <para> Will return &true; on success and &false; on failure. Index: phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml diff -u phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-nickname-escape.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id='function.ircg-nickname-escape'> <refnamediv> @@ -15,7 +15,7 @@ <methodparam><type>string</type><parameter>nick</parameter></methodparam> </methodsynopsis> <para> - Function <function>ircg_nickname_escape</function> returns a decoded + Function <function>ircg_nickname_escape</function> returns an encoded nickname specified by <parameter>nick</parameter> wich is IRC-compliant. </para> <para> Index: phpdoc/en/reference/ircg/functions/ircg-notice.xml diff -u phpdoc/en/reference/ircg/functions/ircg-notice.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-notice.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-notice.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-notice.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-notice"> <refnamediv> @@ -19,9 +19,9 @@ <para> This function will send the <parameter>message</parameter> text to the user <parameter>nick</parameter> on the server connected - to by <parameter>connection</parameter>. Query your IRC - documentation of choice for the exact difference between a MSG - and a NOTICE. + to by <parameter>connection</parameter>. IRC servers and other + software will not automatically generate replies to NOTICEs + in contrast to other message types. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-pconnect.xml diff -u phpdoc/en/reference/ircg/functions/ircg-pconnect.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-pconnect.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-pconnect.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-pconnect.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-pconnect"> <refnamediv> @@ -34,25 +34,28 @@ <para> For now parameter <parameter>server_ip</parameter> will not do any hostname lookups and will only accept IP addresses in - numerical form. - </para> - <para> - Currently <function>ircg_pconnect</function> always returns a valid - handle, even if the connection failed. + numerical form. DNS lookups are expensive and should be done in the + context of IRCG. </para> </note> </para> <para> You can customize the output of IRC messages and events by - selection a format string set previously created with - <function>ircg_register_format_messages</function> by specifing - the sets name in <parameter>msg_format</parameter>. + selecting a format message set previously created with + <function>ircg_register_format_messages</function> by specifying + the set's name in <parameter>msg_format</parameter>. </para> <para> - <parameter>ctcp_messages</parameter> + If you want to handle CTCP messages such as ACTION (/me), you need to + define a mapping from CTCP type (e.g. ACTION) to a custom format + string. Do this by passing an associative array as + <parameter>ctcp_messages</parameter>. The keys of the array + are the CTCP type and the respective value is the format message. </para> <para> - <parameter>user_settings</parameter> + You can define "ident", "password", and "realname" tokens which + are sent to the IRC server by setting these in an associative + array. Pass that array as <parameter>user_settings</parameter>. </para> <para> See also: <function>ircg_disconnect</function>, Index: phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml diff -u phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml:1.2 Wed Apr 17 02:39:36 2002 +++ phpdoc/en/reference/ircg/functions/ircg-register-format-messages.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id="function.ircg-register-format-messages"> <refnamediv> <refname>ircg_register_format_messages</refname> <refpurpose> - Register a set of format strings for display of IRC messages + Register a format message set </refpurpose> </refnamediv> <refsect1> @@ -17,9 +17,8 @@ </methodsynopsis> <para> With <function>ircg_register_format_messages</function> you can - customize the way your IRC output looks like. You can even - register different format string sets and switch between them on - the fly with <function>ircg_lookup_format_messages</function>. + customize the way your IRC output looks like or which script + functions are invoked on the client side. </para> <para> <itemizedlist> Index: phpdoc/en/reference/ircg/functions/ircg-set-current.xml diff -u phpdoc/en/reference/ircg/functions/ircg-set-current.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-set-current.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-set-current.xml:1.2 Wed Apr 17 02:39:38 2002 +++ phpdoc/en/reference/ircg/functions/ircg-set-current.xml Wed Nov 27 11:50:10 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-set-current"> <refnamediv> @@ -15,16 +15,14 @@ <methodparam><type>resource</type><parameter>connection</parameter></methodparam> </methodsynopsis> <para> - Select the current connection for output in this execution + Select the current HTTP connection for output in this execution context. Every output sent from the server connected to by <parameter>connection</parameter> will be copied to standard - output while using default formatting or a format string set - specified by <function>ircg_register_format_messages</function> - and selected by <function>ircg_lookup_format_messages</function>. + output while using default formatting or a format message set + specified by <function>ircg_register_format_messages</function>. </para> <para> - See also: <function>ircg_register_format_messages</function> and - <function>ircg_lookup_format_messages</function>. + See also: <function>ircg_register_format_messages</function>. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml diff -u phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml:1.3 phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml:1.4 --- phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml:1.3 Sun Jul 21 12:16:50 2002 +++ phpdoc/en/reference/ircg/functions/ircg-set-on-die.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.17 --> <refentry id='function.ircg-set-on-die'> <refnamediv> <refname>ircg_set_on_die</refname> <refpurpose> - Set hostaction to be execute when connection dies + Set action to be executed when connection dies </refpurpose> </refnamediv> <refsect1> @@ -24,7 +24,10 @@ IRCG does not resolve host-names due to blocking issues), send <parameter>data</parameter> to the new host connection and will wait until the remote part closes connection. This can be used to - trigger a php script for example. + trigger a PHP script for example. + </para> + <para> + This feature requires IRCG 3. </para> </refsect1> </refentry> Index: phpdoc/en/reference/ircg/functions/ircg-whois.xml diff -u phpdoc/en/reference/ircg/functions/ircg-whois.xml:1.2 phpdoc/en/reference/ircg/functions/ircg-whois.xml:1.3 --- phpdoc/en/reference/ircg/functions/ircg-whois.xml:1.2 Wed Apr 17 02:39:40 2002 +++ phpdoc/en/reference/ircg/functions/ircg-whois.xml Wed Nov 27 11:50:10 2002 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/ircg.xml, last change in rev 1.1 --> <refentry id="function.ircg-whois"> <refnamediv> <refname>ircg_whois</refname> <refpurpose> - Query user information for nick on server + Query server for user information </refpurpose> </refnamediv> <refsect1> @@ -17,7 +17,7 @@ </methodsynopsis> <para> Sends a query to the connected server - <parameter>connection</parameter> to send information for the + <parameter>connection</parameter> to ask for information about the specified user <parameter>nick</parameter>. </para> </refsect1>