| 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 */ |