pidgin/pidgin

Use Meson summary() function.

2021-07-27, Elliott Sales de Andrade
cb640ea0f315
Use Meson summary() function.

Now that we require at least 0.52, we can use Meson's builtin summary printing to display the results of configuration.

Testing Done:
Configured with defaults, and with pixmaps disabled to trigger the warning: https://asciinema.org/a/mV2oxOoVCJNdmrPwgqqUJ3mkU?t=17

Reviewed at https://reviews.imfreedom.org/r/848/
/* purple
*
* Purple is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#if !defined(PURPLE_GLOBAL_HEADER_INSIDE) && !defined(PURPLE_COMPILATION)
# error "only <purple.h> may be included directly"
#endif
#ifndef PURPLE_SMILEY_PARSER_H
#define PURPLE_SMILEY_PARSER_H
/**
* SECTION:smiley-parser
* @include:smiley-parser.h
* @section_id: libpurple-smiley-parser
* @short_description: a efficient smiley processor
* @title: Smiley parser
*
* This module is a fast and easy method for searching (and optionally replacing)
* #PurpleSmiley's in a text. It may use all suitable smiley sets to smileyify
* the message in one step. The priority if always the following: remote
* smileys > local custom smileys > theme smileys.
*/
#include <glib.h>
#include <purpleconversation.h>
#include "smiley.h"
#include "smiley-list.h"
/**
* PurpleSmileyParseCb:
* @out: the message buffer.
* @smiley: found smiley.
* @conv: the conversation of a message (or %NULL, if not passed).
* @ui_data: the data being passed to #purple_smiley_parse.
*
* A replace callback for the found @smiley. It should append a HTML tag
* representing the @smiley to the @out string. It must not modify the
* @out string in other way than appending to its end.
*
* If callback decides not to replace a smiley, it must not modify
* @out in any way.
*
* Returns: %TRUE if the smiley was inserted.
*/
typedef gboolean (*PurpleSmileyParseCb)(GString *out, PurpleSmiley *smiley,
PurpleConversation *conv, gpointer ui_data);
/**
* purple_smiley_parser_smileify:
* @conv: the conversation of a message.
* @html_message: the html message, or escaped plain message.
* @use_remote_smileys: %TRUE if remote smileys of @conv should be parsed.
* @cb: (scope call): The callback to replace smiley text with an image.
* @ui_data: the user data to be passed to @cb and
* #purple_smiley_theme_get_smileys.
*
* Replaces all textual smiley representations with proper smiley images
* configured for libpurple.
*
* The @use_remote_smileys parameter should be %TRUE for incoming messages,
* %FALSE for outgoing.
*
* This function is intended for replacing all smileys before displaying. For
* replacing custom smileys before sending to the other party,
* see #purple_smiley_parser_replace.
*
* Returns: (transfer full): the smileifed message. Should be #g_free'd when
* done using it. Returns %NULL if and only if @html_message was %NULL.
*/
gchar *
purple_smiley_parser_smileify(PurpleConversation *conv, const gchar *html_message,
gboolean use_remote_smileys, PurpleSmileyParseCb cb, gpointer ui_data);
/**
* purple_smiley_parser_replace:
* @smileys: the list of smileys to replace.
* @html_message: the html message, or escaped plain message.
* @cb: (scope call): The callback to replace smiley text with an image.
* @ui_data: (closure cb): The user data to be passed to the callback.
*
* Replaces all textual smiley representations from @smileys list with images.
*
* This function is intended for replacing custom smileys before sending to the
* other party. For replacing all sets of smileys (custom, remote and theme) at
* once (ie. before displaying), use #purple_smiley_parser_smileify.
*
* Returns: (transfer full): the smileifed message. Should be #g_free'd when
* done using it. Returns %NULL if and only if @html_message was %NULL.
*/
gchar *
purple_smiley_parser_replace(PurpleSmileyList *smileys,
const gchar *html_message, PurpleSmileyParseCb cb, gpointer ui_data);
/**
* purple_smiley_parser_find:
* @smileys: the list of smileys to find.
* @message: the message.
* @is_html: %TRUE if the message is HTML, %FALSE if it's plain, unescaped.
*
* Searches for all smileys from the @smileys list present in @message.
* Each smiley is returned only once, regardless how many times it appeared in
* text. However, distinct smileys may share common image file (thus, their
* paths will be the same).
*
* Returns: (element-type PurpleSmiley) (transfer container): the list of found smileys.
*/
GList *
purple_smiley_parser_find(PurpleSmileyList *smileys, const gchar *message,
gboolean is_html);
/**
* _purple_smiley_parser_init: (skip)
*
* Initializes the smileys parser subsystem.
*/
void
_purple_smiley_parser_init(void);
/**
* _purple_smiley_parser_uninit: (skip)
*
* Uninitializes the smileys parser subsystem.
*/
void
_purple_smiley_parser_uninit(void);
#endif /* PURPLE_SMILEY_PARSER_H */