Mercurial > pidgin.yaz
comparison libpurple/plugin.h @ 21190:34de8ef19294
Honor a PURPLE_DISABLE_DEPRECATED define to allow plugins to catch
deprecated functions earlier rather than later.
author | Richard Laager <rlaager@wiktel.com> |
---|---|
date | Sat, 06 Oct 2007 22:59:09 +0000 |
parents | d05f79920d50 |
children | 239cb5c2297b |
comparison
equal
deleted
inserted
replaced
21189:d05f79920d50 | 21190:34de8ef19294 |
---|---|
524 * | 524 * |
525 * @return TRUE if plugin support is enabled, or FALSE otherwise. | 525 * @return TRUE if plugin support is enabled, or FALSE otherwise. |
526 */ | 526 */ |
527 gboolean purple_plugins_enabled(void); | 527 gboolean purple_plugins_enabled(void); |
528 | 528 |
529 #ifndef PURPLE_DISABLE_DEPRECATED | |
529 /** | 530 /** |
530 * Registers a function that will be called when probing is finished. | 531 * Registers a function that will be called when probing is finished. |
531 * | 532 * |
532 * @param func The callback function. | 533 * @param func The callback function. |
533 * @param data Data to pass to the callback. | 534 * @param data Data to pass to the callback. |
534 * @deprecated If you need this, ask for a plugin-probe signal to be added. | 535 * @deprecated If you need this, ask for a plugin-probe signal to be added. |
535 */ | 536 */ |
536 void purple_plugins_register_probe_notify_cb(void (*func)(void *), void *data); | 537 void purple_plugins_register_probe_notify_cb(void (*func)(void *), void *data); |
537 | 538 #endif |
539 | |
540 #ifndef PURPLE_DISABLE_DEPRECATED | |
538 /** | 541 /** |
539 * Unregisters a function that would be called when probing is finished. | 542 * Unregisters a function that would be called when probing is finished. |
540 * | 543 * |
541 * @param func The callback function. | 544 * @param func The callback function. |
542 * @deprecated If you need this, ask for a plugin-probe signal to be added. | 545 * @deprecated If you need this, ask for a plugin-probe signal to be added. |
543 */ | 546 */ |
544 void purple_plugins_unregister_probe_notify_cb(void (*func)(void *)); | 547 void purple_plugins_unregister_probe_notify_cb(void (*func)(void *)); |
545 | 548 #endif |
549 | |
550 #ifndef PURPLE_DISABLE_DEPRECATED | |
546 /** | 551 /** |
547 * Registers a function that will be called when a plugin is loaded. | 552 * Registers a function that will be called when a plugin is loaded. |
548 * | 553 * |
549 * @param func The callback function. | 554 * @param func The callback function. |
550 * @param data Data to pass to the callback. | 555 * @param data Data to pass to the callback. |
551 * @deprecated Use the plugin-load signal instead. | 556 * @deprecated Use the plugin-load signal instead. |
552 */ | 557 */ |
553 void purple_plugins_register_load_notify_cb(void (*func)(PurplePlugin *, void *), | 558 void purple_plugins_register_load_notify_cb(void (*func)(PurplePlugin *, void *), |
554 void *data); | 559 void *data); |
555 | 560 #endif |
561 | |
562 #ifndef PURPLE_DISABLE_DEPRECATED | |
556 /** | 563 /** |
557 * Unregisters a function that would be called when a plugin is loaded. | 564 * Unregisters a function that would be called when a plugin is loaded. |
558 * | 565 * |
559 * @param func The callback function. | 566 * @param func The callback function. |
560 * @deprecated Use the plugin-load signal instead. | 567 * @deprecated Use the plugin-load signal instead. |
561 */ | 568 */ |
562 void purple_plugins_unregister_load_notify_cb(void (*func)(PurplePlugin *, void *)); | 569 void purple_plugins_unregister_load_notify_cb(void (*func)(PurplePlugin *, void *)); |
563 | 570 #endif |
571 | |
572 #ifndef PURPLE_DISABLE_DEPRECATED | |
564 /** | 573 /** |
565 * Registers a function that will be called when a plugin is unloaded. | 574 * Registers a function that will be called when a plugin is unloaded. |
566 * | 575 * |
567 * @param func The callback function. | 576 * @param func The callback function. |
568 * @param data Data to pass to the callback. | 577 * @param data Data to pass to the callback. |
569 * @deprecated Use the plugin-unload signal instead. | 578 * @deprecated Use the plugin-unload signal instead. |
570 */ | 579 */ |
571 void purple_plugins_register_unload_notify_cb(void (*func)(PurplePlugin *, void *), | 580 void purple_plugins_register_unload_notify_cb(void (*func)(PurplePlugin *, void *), |
572 void *data); | 581 void *data); |
573 | 582 #endif |
583 | |
584 #ifndef PURPLE_DISABLE_DEPRECATED | |
574 /** | 585 /** |
575 * Unregisters a function that would be called when a plugin is unloaded. | 586 * Unregisters a function that would be called when a plugin is unloaded. |
576 * | 587 * |
577 * @param func The callback function. | 588 * @param func The callback function. |
578 * @deprecated Use the plugin-unload signal instead. | 589 * @deprecated Use the plugin-unload signal instead. |
579 */ | 590 */ |
580 void purple_plugins_unregister_unload_notify_cb(void (*func)(PurplePlugin *, | 591 void purple_plugins_unregister_unload_notify_cb(void (*func)(PurplePlugin *, |
581 void *)); | 592 void *)); |
593 #endif | |
582 | 594 |
583 /** | 595 /** |
584 * Finds a plugin with the specified name. | 596 * Finds a plugin with the specified name. |
585 * | 597 * |
586 * @param name The plugin name. | 598 * @param name The plugin name. |