annotate doc/cipher-signals.dox @ 26713:baa3867f2281

Don't call jabber_parser_close_stream in jabber_close, it papers over a real issue. As the comment notes and Will pointed out, we should be waiting for the server to send us a </stream:stream> (or a short-ish timeout) before closing the connection. That's both non-trivial and probably requires a major bump.

/** @page cipher-signals Cipher Signals

 @signals
  @signal cipher-added
  @signal cipher-removed
 @endsignals

 @see cipher.h

 <hr>

 @signaldef cipher-added
  @signalproto
void (*cipher_added)(PurpleCipher *cipher);
  @endsignalproto
  @signaldesc
   Emitted when a cipher is added.
  @param cipher The cipher that was added.
 @endsignaldef

 @signaldef cipher-removed
  @signalproto
void (*cipher_removed)(PurpleCipher *cipher);
  @endsignalproto
  @signaldesc
   Emitted when a cipher is removed.
  @param cipher The cipher that was removed.
 @endsignaldef

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