some improvements here and there

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@106028 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Sascha Schumann 2002-11-27 16:50:10 +00:00
parent b0fd77d2b6
commit 196b0776f8
20 changed files with 96 additions and 103 deletions

View file

@ -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>

View file

@ -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>.

View file

@ -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]");
}
]]>

View file

@ -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>

View file

@ -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>

View file

@ -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>.

View file

@ -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>.

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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.

View file

@ -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>

View file

@ -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>

View file

@ -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>,

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>

View file

@ -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>