Mercurial > pidgin.yaz
view doc/notify-signals.dox @ 21621:b2aa68cdc8b9
I had used memcpy to copy the struct tm to where the caller wants it, but
this assumes all callers provide their own allocated struct, which is not
necessarily always the case.
If callers want to keep the values of this struct tm across multiple calls
to purple_str_to_time, they had better copy it themselves. (which is
essentially the same as it was before when we were returning the pointer
to the struct as returned by localtime(), which is also statically
allocated)
author | Stu Tomlinson <stu@nosnilmot.com> |
---|---|
date | Fri, 23 Nov 2007 19:41:44 +0000 |
parents | 4511d15a8f80 |
children | 6e1967b0f90b 1a5861622794 |
line wrap: on
line source
/** @page notify-signals Notification Signals @signals @signal displaying-userinfo @signal displaying-email-notification @signal displaying-emails-notification @endsignals @see notify.h @signaldef displaying-userinfo @signalproto void (*displaying_userinfo)(PurpleAccount *account, const char *who, PurpleNotifyUserInfo *user_info); @endsignalproto @signaldesc Emitted before userinfo is handed to the UI to display. @a user_info can be manipulated via the PurpleNotifyUserInfo API in notify.c. @note If adding a PurpleNotifyUserInfoEntry, be sure not to free it -- PurpleNotifyUserInfo assumes responsibility for its objects. @param account The account on which the info was obtained. @param who The screen name of the user whose info is to be displayed. @param user_info The information to be displayed, as PurpleNotifyUserInfoEntry objects @endsignaldef @signaldef displaying-email-notification @signalproto void (*displaying_email_notification)(const char *subject, const char *from, const char *to, const char *url); @endsignalproto @signaldesc Emitted before email notification is handed to the UI to display. @param subject Subject of email being notified of. @param from Who the email is from. @param to Who the email is to. @param url A url to view the email. @since 2.1.0 @endsignaldef @signaldef displaying-emails-notification @signalproto void (*displaying_emails_notification)(const char **subjects, const char **froms, const char **tos, const char **urls, guint count); @endsignalproto @signaldesc Emitted before notification of multiple emails is handed to the UI to display. @param subjects Subjects of emails being notified of. @param froms Who the emails are from. @param tos Who the emails are to. @param urls The urls to view the emails. @param count Number of emails being notified of. @since 2.1.0 @endsignaldef */ // vim: syntax=c.doxygen tw=75 et