Merge branch 'master' into wdk

This commit is contained in:
Berke Viktor 2012-05-04 21:37:38 +02:00
commit 37ca8b5221
2 changed files with 146 additions and 68 deletions

View File

@ -556,86 +556,117 @@ C<$id> - one of the following case sensitive values
<table border="1"> <table border="1">
<tr style="background-color: #dddddd"> <tr style="background-color: #dddddd">
<td>ID</td> <td>Return value</td> <td>ID</td>
<td>Return value</td>
<td>Associated Command(s)</td>
</tr> </tr>
<tr> <tr>
<td>away</td> <td>away reason or undef if you are not away</td> <td>away</td>
<td>away reason or undef if you are not away</td>
<td>AWAY, BACK</td>
</tr> </tr>
<tr> <tr>
<td>channel</td> <td>current channel name</td> <td>channel</td>
<td>current channel name</td>
<td>SETTAB</td>
</tr> </tr>
<tr> <tr>
<td>charset</td> <td>character-set used in the current context</td> <td>charset</td>
<td>character-set used in the current context</td>
<td>CHARSET</td>
</tr> </tr>
<tr> <tr>
<td>event_text &lt;Event Name&gt;</td> <td>text event format string for &lt;Event name&gt;<br /> <td>event_text &lt;Event Name&gt;</td> <td>text event format string for &lt;Event name&gt;<br />
Example: Example:
<div class="example"> <div class="example">
my $channel_msg_format = Xchat::get_info( "event_text Channel Message" ); my $channel_msg_format = Xchat::get_info( "event_text Channel Message" );
</div> </div>
</td> </td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>host</td> <td>real hostname of the current server</td> <td>host</td>
<td>real hostname of the current server</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>id</td> <td>connection id</td> <td>id</td>
<td>connection id</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>inputbox</td> <td>contents of the inputbox</td> <td>inputbox</td>
<td>contents of the inputbox</td>
<td>SETTEXT</td>
</tr> </tr>
<tr> <tr>
<td>libdirfs</td> <td>libdirfs</td>
<td>the system wide directory where xchat will look for plugins. <td>the system wide directory where xchat will look for plugins.
this string is in the same encoding as the local file system</td> this string is in the same encoding as the local file system</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>modes</td> <td>the current channels modes or undef if not known</td> <td>modes</td>
<td>the current channels modes or undef if not known</td>
<td>MODE</td>
</tr> </tr>
<tr> <tr>
<td>network</td> <td>current network name or undef</td> <td>network</td>
<td>current network name or undef, this value is taken from the Network List</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>nick</td> <td>current nick</td> <td>nick</td>
<td>current nick</td>
<td>NICK</td>
</tr> </tr>
<tr> <tr>
<td>nickserv</td> <td>nickserv password for this network or undef</td> <td>nickserv</td>
<td>nickserv password for this network or undef, this value is taken from the Network List</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>server</td> <td>current server name <br /> <td>server</td> <td>current server name <br />
(what the server claims to be) undef if not connected (what the server claims to be) undef if not connected
</td> </td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>state_cursor</td> <td>state_cursor</td>
<td>current inputbox cursor position in characters</td> <td>current inputbox cursor position in characters</td>
<td>SETCURSOR</td>
</tr> </tr>
<tr> <tr>
<td>topic</td> <td>current channel topic</td> <td>topic</td>
<td>current channel topic</td>
<td>TOPIC</td>
</tr> </tr>
<tr> <tr>
<td>version</td> <td>xchat version number</td> <td>version</td>
<td>xchat version number</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>win_status</td> <td>win_status</td>
<td>status of the xchat window, possible values are "active", "hidden" <td>status of the xchat window, possible values are "active", "hidden"
and "normal"</td> and "normal"</td>
<td>GUI</td>
</tr> </tr>
<tr> <tr>
@ -644,22 +675,30 @@ C<$id> - one of the following case sensitive values
Additionally when you have detached tabs, each of the windows will return a different win_ptr for the different Gtk2::Window objects.<br /> Additionally when you have detached tabs, each of the windows will return a different win_ptr for the different Gtk2::Window objects.<br />
See <a href="http://xchat.cvs.sourceforge.net/viewvc/xchat/xchat2/plugins/perl/char_count.pl?view=markup">char_count.pl</a> for a longer example of a script that uses this to show how many characters you currently have in your input box. See <a href="http://xchat.cvs.sourceforge.net/viewvc/xchat/xchat2/plugins/perl/char_count.pl?view=markup">char_count.pl</a> for a longer example of a script that uses this to show how many characters you currently have in your input box.
</td> </td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>xchatdir</td> <td>xchat config directory encoded in UTF-8<br /> <td>gtkwin_ptr</td>
examples:<br /> <td>similar to win_ptr except it will always be a GtkWindow *</td>
/home/user/.xchat2<br /> <td></td>
C:\Documents and Settings\user\Application Data\X-Chat 2 </tr>
</td> <tr>
<td>xchatdir</td> <td>xchat config directory encoded in UTF-8<br />
examples:<br />
/home/user/.xchat2<br />
C:\Documents and Settings\user\Application Data\X-Chat 2
</td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>xchatdirfs</td> <td>same as xchatdir except encoded in the locale file system encoding</td> <td>xchatdirfs</td> <td>same as xchatdir except encoded in the locale file system encoding</td>
<td></td>
</tr> </tr>
</table> </table>
<p>This function is used to retrieve certain information about the current <p>This function is used to retrieve certain information about the current
context.</p> context. If there is an associated command then that command can be used to change the value for a particular ID.</p>
=end html =end html

View File

@ -578,75 +578,114 @@ a context cannot be found.</p>
</li> </li>
</ul> </ul>
<table border="1"> <tr style="background-color: #dddddd"> <table border="1"> <tr style="background-color: #dddddd">
<td>ID</td> <td>Return value</td> <td>ID</td>
<td>Return value</td>
<td>Associated Command(s)</td>
</tr> <tr> </tr> <tr>
<td>away</td> <td>away reason or undef if you are not away</td> <td>away</td>
<td>away reason or undef if you are not away</td>
<td>AWAY, BACK</td>
</tr> <tr> </tr> <tr>
<td>channel</td> <td>current channel name</td> <td>channel</td>
<td>current channel name</td>
<td>SETTAB</td>
</tr> <tr> </tr> <tr>
<td>charset</td> <td>character-set used in the current context</td> <td>charset</td>
<td>character-set used in the current context</td>
<td>CHARSET</td>
</tr> <tr> </tr> <tr>
<td>event_text &lt;Event Name&gt;</td> <td>text event format string for &lt;Event name&gt;<br /> <td>event_text &lt;Event Name&gt;</td> <td>text event format string for &lt;Event name&gt;<br />
Example: Example:
<div class="example synNormal"><div class='line_number'> <div class="example synNormal"><div class='line_number'>
<div>1</div> <div>1</div>
</div> </div>
<div class='content'><pre><span class="synStatement">my</span> <span class="synIdentifier">$channel_msg_format</span> = Xchat::get_info( <span class="synStatement">&quot;</span><span class="synConstant">event_text Channel Message</span><span class="synStatement">&quot;</span> ); <div class='content'><pre><span class="synStatement">my</span> <span class="synIdentifier">$channel_msg_format</span> = Xchat::get_info( <span class="synStatement">&quot;</span><span class="synConstant">event_text Channel Message</span><span class="synStatement">&quot;</span> );
</pre></div> </pre></div>
</div> </div>
</td> </td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>host</td> <td>real hostname of the current server</td> <td>host</td>
<td>real hostname of the current server</td>
<td></td>
</tr><tr> </tr><tr>
<td>id</td> <td>connection id</td> <td>id</td>
<td>connection id</td>
<td></td>
</tr><tr> </tr><tr>
<td>inputbox</td> <td>contents of the inputbox</td> <td>inputbox</td>
<td>contents of the inputbox</td>
<td>SETTEXT</td>
</tr><tr> </tr><tr>
<td>libdirfs</td> <td>libdirfs</td>
<td>the system wide directory where xchat will look for plugins. <td>the system wide directory where xchat will look for plugins.
this string is in the same encoding as the local file system</td> this string is in the same encoding as the local file system</td>
<td></td>
</tr><tr> </tr><tr>
<td>modes</td> <td>the current channels modes or undef if not known</td> <td>modes</td>
<td>the current channels modes or undef if not known</td>
<td>MODE</td>
</tr><tr> </tr><tr>
<td>network</td> <td>current network name or undef</td> <td>network</td>
<td>current network name or undef, this value is taken from the Network List</td>
<td></td>
</tr><tr> </tr><tr>
<td>nick</td> <td>current nick</td> <td>nick</td>
<td>current nick</td>
<td>NICK</td>
</tr><tr> </tr><tr>
<td>nickserv</td> <td>nickserv password for this network or undef</td> <td>nickserv</td>
<td>nickserv password for this network or undef, this value is taken from the Network List</td>
<td></td>
</tr><tr> </tr><tr>
<td>server</td> <td>current server name <br /> <td>server</td> <td>current server name <br />
(what the server claims to be) undef if not connected (what the server claims to be) undef if not connected
</td> </td>
<td></td>
</tr><tr> </tr><tr>
<td>state_cursor</td> <td>state_cursor</td>
<td>current inputbox cursor position in characters</td> <td>current inputbox cursor position in characters</td>
<td>SETCURSOR</td>
</tr><tr> </tr><tr>
<td>topic</td> <td>current channel topic</td> <td>topic</td>
<td>current channel topic</td>
<td>TOPIC</td>
</tr><tr> </tr><tr>
<td>version</td> <td>xchat version number</td> <td>version</td>
<td>xchat version number</td>
<td></td>
</tr><tr> </tr><tr>
<td>win_status</td> <td>win_status</td>
<td>status of the xchat window, possible values are "active", "hidden" <td>status of the xchat window, possible values are "active", "hidden"
and "normal"</td> and "normal"</td>
<td>GUI</td>
</tr><tr> </tr><tr>
<td>win_ptr</td> <td>native window pointer, GtkWindow * on Unix, HWND on Win32.<br /> <td>win_ptr</td> <td>native window pointer, GtkWindow * on Unix, HWND on Win32.<br />
On Unix if you have the Glib module installed you can use my $window = Glib::Object->new_from_pointer( Xchat::get_info( "win_ptr" ) ); to get a Gtk2::Window object.<br /> On Unix if you have the Glib module installed you can use my $window = Glib::Object->new_from_pointer( Xchat::get_info( "win_ptr" ) ); to get a Gtk2::Window object.<br />
Additionally when you have detached tabs, each of the windows will return a different win_ptr for the different Gtk2::Window objects.<br /> Additionally when you have detached tabs, each of the windows will return a different win_ptr for the different Gtk2::Window objects.<br />
See <a href="http://xchat.cvs.sourceforge.net/viewvc/xchat/xchat2/plugins/perl/char_count.pl?view=markup">char_count.pl</a> for a longer example of a script that uses this to show how many characters you currently have in your input box. See <a href="http://xchat.cvs.sourceforge.net/viewvc/xchat/xchat2/plugins/perl/char_count.pl?view=markup">char_count.pl</a> for a longer example of a script that uses this to show how many characters you currently have in your input box.
</td> </td>
<td></td>
</tr> </tr>
<tr> <tr>
<td>xchatdir</td> <td>xchat config directory encoded in UTF-8<br /> <td>gtkwin_ptr</td>
examples:<br /> <td>similar to win_ptr except it will always be a GtkWindow *</td>
/home/user/.xchat2<br /> <td></td>
C:\Documents and Settings\user\Application Data\X-Chat 2 </tr>
</td> <tr>
<td>xchatdir</td> <td>xchat config directory encoded in UTF-8<br />
examples:<br />
/home/user/.xchat2<br />
C:\Documents and Settings\user\Application Data\X-Chat 2
</td>
<td></td>
</tr><tr> </tr><tr>
<td>xchatdirfs</td> <td>same as xchatdir except encoded in the locale file system encoding</td> <td>xchatdirfs</td> <td>same as xchatdir except encoded in the locale file system encoding</td>
<td></td>
</tr> </tr>
</table><p>This function is used to retrieve certain information about the current </table><p>This function is used to retrieve certain information about the current
context.</p><p> context. If there is an associated command then that command can be used to change the value for a particular ID.</p><p>
</p> </p>
<h3><a name="xchat_get_prefs" /><code>Xchat::get_prefs( $name )</code></h3> <h3><a name="xchat_get_prefs" /><code>Xchat::get_prefs( $name )</code></h3>
<ul> <ul>