[Pidgin] DbusHowto modified
Pidgin
trac at pidgin.im
Sun Apr 15 03:08:07 EDT 2012
Changed page "DbusHowto" by QuLogic from 70.53.229.129*
Page URL: <http://developer.pidgin.im/wiki/DbusHowto>
Diff URL: <http://developer.pidgin.im/wiki/DbusHowto?action=diff&version=7>
Revision 7
Comment: Fix doxygen links
-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: DbusHowto
=========================================================================
--- DbusHowto (version: 6)
+++ DbusHowto (version: 7)
@@ -26,7 +26,7 @@
[Note that the signal is called "received-im-msg" in the Pidgin documentation but the D-Bus signal is called "!ReceivedImMsg"; do this simple transformation for all signals you see.]
-This registers a function, called `my_func`, which will be called when the signal is emitted. Now you look up the documentation to see what parameters come with the signal, and you define `my_func` to work on those parameters. In this case, the [http://developer.pidgin.im/doxygen/dev/html/conversation-signals.html#received-im-msg documentation] tells you that the parameters are (account, sender, message, conversation, flags), so you define `my_func` accordingly:
+This registers a function, called `my_func`, which will be called when the signal is emitted. Now you look up the documentation to see what parameters come with the signal, and you define `my_func` to work on those parameters. In this case, the [http://developer.pidgin.im/doxygen/dev2.x.y/html/conversation-signals.html#received-im-msg documentation] tells you that the parameters are (account, sender, message, conversation, flags), so you define `my_func` accordingly:
{{{
#!python
def my_func(account, sender, message, conversation, flags):
@@ -60,15 +60,15 @@
But you get the idea.
-Here's a sample list of signals you can receive. For the full list, look in pages named "Signals" in the [http://developer.pidgin.im/doxygen/dev/html/pages.html list of documentation pages].
-
- * [http://developer.pidgin.im/doxygen/dev/html/account-signals.html Account signals]:
+Here's a sample list of signals you can receive. For the full list, look in pages named "Signals" in the [http://developer.pidgin.im/doxygen/dev2.x.y/html/pages.html list of documentation pages].
+
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/account-signals.html Account signals]:
* account-status-changed, account-connecting, account-error-changed, account-authorization-requested
- * [http://developer.pidgin.im/doxygen/dev/html/blist-signals.html Buddy list signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/blist-signals.html Buddy list signals]:
* buddy-status-changed, buddy-idle-changed, buddy-signed-on, buddy-signed-off, buddy-icon-changed
- * [http://developer.pidgin.im/doxygen/dev/html/connection-signals.html Connection signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/connection-signals.html Connection signals]:
* signing-on, signed-on, signing-off, signed-off, connection-error
- * [http://developer.pidgin.im/doxygen/dev/html/conversation-signals.html Conversation signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/conversation-signals.html Conversation signals]:
* These are emitted for events related to conversations you are having. Note that in Pidgin, "im" means a conversation with one person, and "chat" means a conversation with several people.
* writing-im-msg, wrote-im-msg,
* sending-im-msg, sent-im-msg,
@@ -84,25 +84,25 @@
* chat-topic-changed,
* conversation-created, conversation-updated, deleting-conversation,
* conversation-extended-menu
- * [http://developer.pidgin.im/doxygen/dev/html/core-signals.html Core signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/core-signals.html Core signals]:
* quitting
- * [http://developer.pidgin.im/doxygen/dev/html/gtkconv-signals.html GtkConv signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/gtkconv-signals.html GtkConv signals]:
* displaying-im-msg, displayed-im-msg,
* displaying-chat-msg, displayed-chat-msg,
* conversation-switched,
* conversation-hiding, conversation-displayed
- * [http://developer.pidgin.im/doxygen/dev/html/gtkimhtml-signals.html GtkIMHTML signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/gtkimhtml-signals.html GtkIMHTML signals]:
* GtkIMHTML is the widget used for the input area in Pidgin
* url_clicked, format_buttons_update, format_function_clear, format_function_toggle, format_function_update
- * [http://developer.pidgin.im/doxygen/dev/html/notify-signals.html Notification signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/notify-signals.html Notification signals]:
* displaying-userinfo, displaying-email-notification, displaying-emails-notification
- * [http://developer.pidgin.im/doxygen/dev/html/plugin-signals.html Plugin signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/plugin-signals.html Plugin signals]:
* plugin-load, plugin-unload
- * [http://developer.pidgin.im/doxygen/dev/html/savedstatus-signals.html Saved status signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/savedstatus-signals.html Saved status signals]:
* savedstatus-changed
- * [http://developer.pidgin.im/doxygen/dev/html/sound-signals.html Sound signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/sound-signals.html Sound signals]:
* playing-sound-event
- * [http://developer.pidgin.im/doxygen/dev/html/xfer-signals.html File transfer signals]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/xfer-signals.html File transfer signals]:
* file-recv-complete, file-recv-request, file-send-accept, file-send-start, file-send-cancel, file-send-complete
=== Aside: Signals in Pidgin plugins ===
@@ -126,7 +126,7 @@
Your registered callback function in a plugin might also have an effect on Pidgin by changing the values of parameters it gets.
-You can't do any of this in a D-Bus script. Look at [http://developer.pidgin.im/doxygen/dev/html/signal-howto.html Signals HOWTO] to see how to use signals in plugins.
+You can't do any of this in a D-Bus script. Look at [http://developer.pidgin.im/doxygen/dev2.x.y/html/signal-howto.html Signals HOWTO] to see how to use signals in plugins.
Even with read-only plugins, there is a lot you can do:
* When messages are received, notify the user using a system-wide notification system (e.g., [http://growl.info Growl] on OS X, or passing the message through a text-to-speech system and playing it.)
@@ -169,11 +169,11 @@
}}}
And this still does unexpected things when your current status is a complex one.
-The only reference for the available functions is the [http://developer.pidgin.im/doxygen/dev/html/files.html documentation for the header files], so you want to look there to figure out which functions you need to call.
+The only reference for the available functions is the [http://developer.pidgin.im/doxygen/dev2.x.y/html/files.html documentation for the header files], so you want to look there to figure out which functions you need to call.
Here are a few of the useful ones:
- * [http://developer.pidgin.im/doxygen/dev/html/account_8h.html Your accounts]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/account_8h.html Your accounts]:
* Get a particular account: `PurpleAccountsFind(name, protocol)`
* Get all active accounts: `PurpleAccountsGetAllActive()`
* Get an account's username: `PurpleAccountGetUsername(account)`
@@ -182,7 +182,7 @@
* Get its icon: `PurpleAccountGetBuddyIconPath(account)`
* Set its icon: `PurpleAccountSetBuddyIconPath(account, path)`
- * [http://developer.pidgin.im/doxygen/dev/html/blist_8h.html Your buddies]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/blist_8h.html Your buddies]:
* Get list of all buddies: `PurpleFindBuddies(account,screenname)` [Second argument NULL, to search for all]
* Get a particular buddy: `PurpleFindBuddy(account, screenname)`
* Check if a buddy is online: `PurpleBuddyIsOnline(buddy)`
@@ -191,7 +191,7 @@
* Get a buddy's name: `PurpleBuddyGetName(buddy)`
* Get the account a buddy belongs to: `PurpleBuddyGetAccount(buddy)`
- * [http://developer.pidgin.im/doxygen/dev/html/savedstatuses_8h.html Your own status] ([http://developer.pidgin.im/doxygen/dev/html/status_8h.html also]):
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/savedstatuses_8h.html Your own status] ([http://developer.pidgin.im/doxygen/dev2.x.y/html/status_8h.html also]):
* Some constants you can't get through the D-Bus interface yet:
{{{
#!python
@@ -210,7 +210,7 @@
* Set a status message with: `PurpleSavedstatusSetMessage(status, message)`
* Actually set the status with: `PurpleSavedstatusActivate(status)`
- * [http://developer.pidgin.im/doxygen/dev/html/conversation_8h.html Your conversations]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/conversation_8h.html Your conversations]:
* Get all conversations: `PurpleGetConversations()`
* Get all IMs: `PurpleGetIms()`
* Create a new conversation: `PurpleConversationNew(type,account,name)`
@@ -221,11 +221,11 @@
* Get the im of a conversation: `PurpleConvIm(conv)`
* Send an IM message with: `PurpleConvImSend(im, message)`
- * [http://developer.pidgin.im/doxygen/dev/html/prefs_8h.html Preferences]:
+ * [http://developer.pidgin.im/doxygen/dev2.x.y/html/prefs_8h.html Preferences]:
* Get a preference: `PurplePrefsGetBool`, `PurplePrefsGetString`, etc.
* Set a preference: `PurplePrefsSetInt`, `PurplePrefsSetPath`, etc.
-There are other things you can do; see the [http://developer.pidgin.im/doxygen/dev/html/main.html documentation] and the source files.
+There are other things you can do; see the [http://developer.pidgin.im/doxygen/dev2.x.y/html/main.html documentation] and the source files.
== Further reading ==
-------8<------8<------8<------8<------8<------8<------8<------8<--------
* The IP shown here might not mean anything if the user or the server is
behind a proxy.
--
Pidgin <http://pidgin.im>
Pidgin
This is an automated message. Someone at http://pidgin.im added your email
address to be notified of changes on DbusHowto. If it was not you, please
report to .
More information about the Wikiedit
mailing list