annotate doc/log-signals.dox @ 21033:9347a942b7cd

This is the first step toward rationalizing our Makefiles to reduce the number of directories we have to traverse. This commit removes all Makefiles under pidgin/pixmaps which don't actually do anything -- if it contained nothing but SUBDIRS and/or EXTRA_DIST, it's gone now. This almost certainly breaks Windows builds. I believe they can be (mostly?) fixed by simply removing intermediate Makefile.mingws (corresponding to removed Makefile.ams; both from their locations and from pidgin/pixmaps/Makefile.am), but as I can't test it, I didn't mess with them. Note that even this simple reduction cut out 31 directories from the build process. Similar changes can probably be made in other places in the tree, above pidgin/pixmaps/. Next step: directories which install files, but have no rules.

/** @page log-signals Log Signals

 @signals
  @signal log-timestamp
 @endsignals

 @see log.h

 <hr>

 @signaldef log-timestamp
  @signalproto
char *(*log_timestamp)(PurpleLog *log, time_t when);
  @endsignalproto
  @signaldesc
   Emitted to allow plugins to customize the timestamp on a message
   being logged.
  @param log The log the message belongs to.
  @param when The time to be converted to a string.
  @return A textual representation of the time, or @c NULL to use a
          default format.
  @note Plugins must be careful of logs with a type of PURPLE_LOG_SYSTEM.
 @endsignaldef

*/
// vim: syntax=c.doxygen tw=75 et