Replace empty string comparison with null character comparison
[pidgin-git.git] / doc / log-signals.dox
blob62692d3f4319cb23bdd30db0c280c676f44d8a2a
1 /** @page log-signals Log Signals
3  @signals
4   @signal log-timestamp
5  @endsignals
7  @see log.h
9  <hr>
11  @signaldef log-timestamp
12   @signalproto
13 char *(*log_timestamp)(PurpleLog *log, time_t when, gboolean show_date);
14   @endsignalproto
15   @signaldesc
16    Emitted to allow plugins to customize the timestamp on a message
17    being logged.
18   @param log       The log the message belongs to.
19   @param when      The time to be converted to a string.
20   @param show_date Whether the date should be displayed.
21   @return A textual representation of the time, or @c NULL to use a
22           default format.
23   @note Plugins must be careful of logs with a type of PURPLE_LOG_SYSTEM.
24  @endsignaldef
27 // vim: syntax=c.doxygen tw=75 et