libpurple/prpl.h

changeset 22251
a7c65a128467
parent 22225
6cd802a8c5ad
child 22398
1a6f172dfbd4
child 22906
26919a723b1e
equal deleted inserted replaced
22248:db9b3bc9d442 22251:a7c65a128467
489 * 489 *
490 * @param type The attention type. 490 * @param type The attention type.
491 * @return The name. 491 * @return The name.
492 * @since 2.4.0 492 * @since 2.4.0
493 */ 493 */
494 const char *purple_attention_type_get_name(PurpleAttentionType *type); 494 const char *purple_attention_type_get_name(const PurpleAttentionType *type);
495 495
496 /** 496 /**
497 * Get the attention type's description shown when the event is received. 497 * Get the attention type's description shown when the event is received.
498 * 498 *
499 * @param type The attention type. 499 * @param type The attention type.
500 * @return The description. 500 * @return The description.
501 * @since 2.4.0 501 * @since 2.4.0
502 */ 502 */
503 const char *purple_attention_type_get_incoming_desc(PurpleAttentionType *type); 503 const char *purple_attention_type_get_incoming_desc(const PurpleAttentionType *type);
504 504
505 /** 505 /**
506 * Get the attention type's description shown when the event is sent. 506 * Get the attention type's description shown when the event is sent.
507 * 507 *
508 * @param type The attention type. 508 * @param type The attention type.
509 * @return The description. 509 * @return The description.
510 * @since 2.4.0 510 * @since 2.4.0
511 */ 511 */
512 const char *purple_attention_type_get_outgoing_desc(PurpleAttentionType *type); 512 const char *purple_attention_type_get_outgoing_desc(const PurpleAttentionType *type);
513 513
514 /** 514 /**
515 * Get the attention type's icon name. 515 * Get the attention type's icon name.
516 * 516 *
517 * @param type The attention type. 517 * @param type The attention type.
518 * @return The icon name or @c NULL if unset/empty. 518 * @return The icon name or @c NULL if unset/empty.
519 * @note Icons are optional for attention events. 519 * @note Icons are optional for attention events.
520 * @since 2.4.0 520 * @since 2.4.0
521 */ 521 */
522 const char *purple_attention_type_get_icon_name(PurpleAttentionType *type); 522 const char *purple_attention_type_get_icon_name(const PurpleAttentionType *type);
523 523
524 /** 524 /**
525 * Get the attention type's unlocalized name; this is useful for some UIs. 525 * Get the attention type's unlocalized name; this is useful for some UIs.
526 * 526 *
527 * @param type The attention type 527 * @param type The attention type
528 * @return The unlocalized name. 528 * @return The unlocalized name.
529 * @since 2.4.0 529 * @since 2.4.0
530 */ 530 */
531 const char *purple_attention_type_get_unlocalized_name(PurpleAttentionType *type); 531 const char *purple_attention_type_get_unlocalized_name(const PurpleAttentionType *type);
532 532
533 /*@}*/ 533 /*@}*/
534 534
535 /**************************************************************************/ 535 /**************************************************************************/
536 /** @name Protocol Plugin API */ 536 /** @name Protocol Plugin API */

mercurial