Changeset b890626 for doc/user-guide

Timestamp:

2010-08-08T13:42:57Z (14 years ago)

Author:

Wilmer van der Gaast <wilmer@…>

Branches:

master

Children:

2528cda, f32c14c

Parents:

203a2d2

Message:

Add a few more commands (including RT) and the ability to send replies.
That's it for now, this is already not very pretty, but just offers the bare
basic functionality.

File:

• doc/user-guide/commands.xml (modified) (2 diffs)

doc/user-guide/commands.xml

@@ -495 +495 @@
         </bitlbee-setting>
 
+        <bitlbee-setting name="auto_reply_timeout" type="integer" scope="account">
+                <default>10800</default>
+
+                <description>
+                        <para>
+                                For Twitter accounts: If you respond to Tweets IRC-style (like "nickname: reply"), this will automatically be converted to the usual Twitter format ("@screenname reply").
+                        </para>
+
+                        <para>
+                                By default, BitlBee will then also add a reference to that person's most recent Tweet, unless that message is older than the value of this setting in seconds.
+                        </para>
+
+                        <para>
+                                If you want to disable this feature, just set this to 0. Alternatively, if you want to write a message once that is <emphasis>not</emphasis> a reply, use the Twitter reply syntax (@screenname).
+                        </para>
+                </description>
+        </bitlbee-setting>
+
         <bitlbee-setting name="away" type="string" scope="both">
                 <description>
@@ -598 +616 @@
                         <para>
                                 For setting up named chatrooms, it's currently easier to just use the <emphasis>chat add</emphasis> command.
+                        </para>
+                </description>
+        </bitlbee-setting>
+
+        <bitlbee-setting name="commands" type="boolean" scope="account">
+                <default>true</default>
+
+                <description>
+                        <para>
+                                With this setting enabled, you can use some commands in your Twitter channel/query. The commands are simple and not documented in too much detail:
+                        </para>
+
+                        <variablelist>
+                                <varlistentry><term>undo [&lt;id&gt;]</term><listitem><para>Delete your last Tweet (or one with the given ID)</para></listitem></varlistentry>
+                                <varlistentry><term>rt &lt;screenname|id&gt;</term><listitem><para>Retweet someone's last Tweet (or one with the given ID)</para></listitem></varlistentry>
+                                <varlistentry><term>follow &lt;screenname&gt;</term><listitem><para>Start following a person</para></listitem></varlistentry>
+                                <varlistentry><term>unfollow &lt;screenname&gt;</term><listitem><para>Stop following a person</para></listitem></varlistentry>
+                                <varlistentry><term>post &lt;message&gt;</term><listitem><para>Post a tweet</para></listitem></varlistentry>
+                        </variablelist>
+
+                        <para>
+                                Anything that doesn't look like a command will be treated as a tweet. Watch out for typos! :-)
                         </para>
                 </description>