diff --git a/include/linphone/address.h b/include/linphone/address.h index b5f0f55f9..3ad35fa5c 100644 --- a/include/linphone/address.h +++ b/include/linphone/address.h @@ -110,6 +110,7 @@ LINPHONE_PUBLIC void linphone_address_clean(LinphoneAddress *uri); /** * Returns true if address refers to a secure location (sips) * @deprecated use linphone_address_get_secure() + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC bool_t linphone_address_is_secure(const LinphoneAddress *addr); @@ -219,6 +220,7 @@ LINPHONE_PUBLIC const char * linphone_address_get_uri_param(const LinphoneAddres /** * Destroys a LinphoneAddress object (actually calls linphone_address_unref()). * @deprecated Use linphone_address_unref() instead + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_address_destroy(LinphoneAddress *u); diff --git a/include/linphone/call.h b/include/linphone/call.h index 8d5985274..242fac2eb 100644 --- a/include/linphone/call.h +++ b/include/linphone/call.h @@ -303,6 +303,7 @@ LINPHONE_PUBLIC void linphone_call_cancel_dtmfs(LinphoneCall *call); * @param call #LinphoneCall * @return TRUE if part of a conference. * @deprecated Use linphone_call_get_conference() instead. + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_call_is_in_conference(const LinphoneCall *call); diff --git a/include/linphone/call_log.h b/include/linphone/call_log.h index 7ed668913..914fab331 100644 --- a/include/linphone/call_log.h +++ b/include/linphone/call_log.h @@ -211,8 +211,9 @@ LINPHONE_PUBLIC void linphone_call_log_unref(LinphoneCallLog *cl); * Destroy a LinphoneCallLog. * @param cl LinphoneCallLog object * @deprecated Use linphone_call_log_unref() instead. + * @donotwrap */ -LINPHONE_PUBLIC void linphone_call_log_destroy(LinphoneCallLog *cl); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_call_log_destroy(LinphoneCallLog *cl); /** * @} diff --git a/include/linphone/call_params.h b/include/linphone/call_params.h index f9517b66d..2220f595c 100644 --- a/include/linphone/call_params.h +++ b/include/linphone/call_params.h @@ -441,6 +441,7 @@ LINPHONE_PUBLIC void linphone_call_params_clear_custom_sdp_media_attributes(Linp * Destroy a LinphoneCallParams object. * @param[in] cp LinphoneCallParams object * @deprecated Use linphone_call_params_unref() instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_call_params_destroy(LinphoneCallParams *cp); diff --git a/include/linphone/chat.h b/include/linphone/chat.h index fc78c9ce9..954d55611 100644 --- a/include/linphone/chat.h +++ b/include/linphone/chat.h @@ -39,8 +39,9 @@ extern "C" { * @param status LinphoneChatMessageState * @param ud application user data * @deprecated Use LinphoneChatMessageCbsMsgStateChangedCb instead. + * @donotwrap */ -typedef void (*LinphoneChatMessageStateChangedCb)(LinphoneChatMessage* msg,LinphoneChatMessageState state,void* ud); +LINPHONE_DEPRECATED typedef void (*LinphoneChatMessageStateChangedCb)(LinphoneChatMessage* msg,LinphoneChatMessageState state,void* ud); /** * Call back used to notify message delivery status @@ -80,6 +81,7 @@ typedef void (*LinphoneChatMessageCbsFileTransferProgressIndicationCb)(LinphoneC * Destroy a LinphoneChatRoom. * @param cr #LinphoneChatRoom object * @deprecated Use linphone_chat_room_unref() instead. + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_chat_room_destroy(LinphoneChatRoom *cr); /** @@ -150,6 +152,7 @@ LINPHONE_PUBLIC const LinphoneAddress* linphone_chat_room_get_peer_address(Linph * @deprecated Use linphone_chat_room_send_chat_message() instead. * @param cr #LinphoneChatRoom object * @param msg message to be sent + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_chat_room_send_message(LinphoneChatRoom *cr, const char *msg); @@ -162,6 +165,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_chat_room_send_message(Linphon * @deprecated Use linphone_chat_room_send_chat_message() instead. * @note The LinphoneChatMessage must not be destroyed until the the callback is called. * The LinphoneChatMessage reference is transfered to the function and thus doesn't need to be unref'd by the application. + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_chat_room_send_message2(LinphoneChatRoom *cr, LinphoneChatMessage* msg,LinphoneChatMessageStateChangedCb status_cb,void* ud); @@ -172,6 +176,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_chat_room_send_message2(Linpho * The state of the message sending will be notified via the callbacks defined in the LinphoneChatMessageCbs object that can be obtained * by calling linphone_chat_message_get_callbacks(). * The LinphoneChatMessage reference is transfered to the function and thus doesn't need to be unref'd by the application. + * @donotwrap */ LINPHONE_PUBLIC void linphone_chat_room_send_chat_message(LinphoneChatRoom *cr, LinphoneChatMessage *msg); @@ -244,6 +249,7 @@ LINPHONE_PUBLIC int linphone_chat_room_get_unread_messages_count(LinphoneChatRoo /** * Returns back pointer to #LinphoneCore object. * @deprecated use linphone_chat_room_get_core() + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneCore* linphone_chat_room_get_lc(LinphoneChatRoom *cr); @@ -426,6 +432,7 @@ LINPHONE_PUBLIC void linphone_chat_message_set_to_be_stored(LinphoneChatMessage * @param status_cb LinphoneChatMessageStateChangeCb status callback invoked when file is downloaded or could not be downloaded * @param ud user data * @deprecated Use linphone_chat_message_download_file() instead. + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_chat_message_start_file_download(LinphoneChatMessage* message, LinphoneChatMessageStateChangedCb status_cb, void* ud); @@ -444,6 +451,7 @@ LINPHONE_PUBLIC void linphone_chat_message_cancel_file_transfer(LinphoneChatMess /** * Resend a chat message if it is in the 'not delivered' state for whatever reason. * @param[in] msg LinphoneChatMessage object + * @donotwrap */ LINPHONE_PUBLIC void linphone_chat_message_resend(LinphoneChatMessage *msg); diff --git a/include/linphone/conference.h b/include/linphone/conference.h index a5e3e8890..1334da06c 100644 --- a/include/linphone/conference.h +++ b/include/linphone/conference.h @@ -61,6 +61,7 @@ LINPHONE_PUBLIC void linphone_conference_params_unref(LinphoneConferenceParams * * Free a #LinphoneConferenceParams * @param params #LinphoneConferenceParams to free * @deprecated Use linphone_conference_params_unref() instead. + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_conference_params_free(LinphoneConferenceParams *params); diff --git a/include/linphone/core.h b/include/linphone/core.h index c27a6ce2b..4f3bc85a3 100644 --- a/include/linphone/core.h +++ b/include/linphone/core.h @@ -183,24 +183,28 @@ typedef LinphoneCoreCbsRegistrationStateChangedCb LinphoneCoreRegistrationStateC /** * Callback prototype * @deprecated + * @donotwrap */ typedef void (*ShowInterfaceCb)(LinphoneCore *lc); /** * Callback prototype * @deprecated + * @donotwrap */ typedef void (*DisplayStatusCb)(LinphoneCore *lc, const char *message); /** * Callback prototype * @deprecated + * @donotwrap */ typedef void (*DisplayMessageCb)(LinphoneCore *lc, const char *message); /** * Callback prototype * @deprecated + * @donotwrap */ typedef void (*DisplayUrlCb)(LinphoneCore *lc, const char *message, const char *url); @@ -288,11 +292,12 @@ typedef LinphoneCoreCbsCallLogUpdatedCb LinphoneCoreCallLogUpdatedCb; /** * Callback prototype - * @deprecated use #LinphoneCoreMessageReceivedCb instead. * @param lc #LinphoneCore object * @param room #LinphoneChatRoom involved in this conversation. Can be be created by the framework in case \link #LinphoneAddress the from \endlink is not present in any chat room. * @param from #LinphoneAddress from * @param message incoming message + * @deprecated use #LinphoneCoreMessageReceivedCb instead. + * @donotwrap */ typedef void (*LinphoneCoreTextMessageReceivedCb)(LinphoneCore *lc, LinphoneChatRoom *room, const LinphoneAddress *from, const char *message); @@ -604,6 +609,7 @@ LINPHONE_PUBLIC void *linphone_core_cbs_get_user_data(const LinphoneCoreCbs *cbs * This is meant only to be called from a callback to be able to get the user_data associated with the #LinphoneCoreCbs that is calling the callback. * @param lc the linphonecore * @return the #LinphoneCoreCbs that has called the last callback + * @donotwrap */ LINPHONE_PUBLIC LinphoneCoreCbs *linphone_core_get_current_callbacks(const LinphoneCore *lc); @@ -1094,29 +1100,25 @@ LINPHONE_PUBLIC void linphone_core_set_log_level_mask(unsigned int loglevel); /** * Enable logs in supplied FILE*. - * - * @deprecated Use #linphone_core_set_log_file and #linphone_core_set_log_level instead. - * * @param file a C FILE* where to fprintf logs. If null stdout is used. - * + * @deprecated Use #linphone_core_set_log_file and #linphone_core_set_log_level instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_enable_logs(FILE *file); /** * Enable logs through the user's supplied log callback. - * - * @deprecated Use #linphone_core_set_log_handler and #linphone_core_set_log_level instead. - * * @param logfunc The address of a OrtpLogFunc callback whose protoype is * typedef void (*OrtpLogFunc)(OrtpLogLevel lev, const char *fmt, va_list args); - * + * @deprecated Use #linphone_core_set_log_handler and #linphone_core_set_log_level instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_enable_logs_with_cb(OrtpLogFunc logfunc); /** * Entirely disable logging. - * * @deprecated Use #linphone_core_set_log_level instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_disable_logs(void); @@ -1138,11 +1140,13 @@ LINPHONE_PUBLIC const char *linphone_core_get_user_agent(LinphoneCore *lc); /** * @deprecated Use #linphone_core_get_user_agent instead. + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_core_get_user_agent_name(void); /** * @deprecated Use #linphone_core_get_user_agent instead. + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_core_get_user_agent_version(void); @@ -1169,6 +1173,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_core_get_user_agent_ver * callbacks) using linphone_core_get_user_data(). * @see linphone_core_new_with_config * @deprecated Use linphone_factory_create_core() instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneCore *linphone_core_new(const LinphoneCoreVTable *vtable, const char *config_path, const char *factory_config_path, void* userdata); @@ -1185,6 +1190,7 @@ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneCore *linphone_core_new(const Linpho * callbacks) using linphone_core_get_user_data(). * @see linphone_core_new * @deprecated Use linphone_factory_create_core_with_config() instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneCore *linphone_core_new_with_config(const LinphoneCoreVTable *vtable, LpConfig *config, void *userdata); @@ -1228,6 +1234,7 @@ LINPHONE_PUBLIC void linphone_core_iterate(LinphoneCore *lc); * @param vtable a LinphoneCoreVTable structure holding your application callbacks. Object is owned by linphone core until linphone_core_remove_listener. * @param lc object * @deprecated Use linphone_core_add_callbacks() instead. + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_add_listener(LinphoneCore *lc, LinphoneCoreVTable *vtable); @@ -1246,6 +1253,7 @@ LINPHONE_PUBLIC void linphone_core_add_callbacks(LinphoneCore *lc, LinphoneCoreC * @param lc object * @param vtable a LinphoneCoreVTable structure holding your application callbacks. * @deprecated Use linphone_core_remove_callbacks() instead. + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_remove_listener(LinphoneCore *lc, const LinphoneCoreVTable *vtable); @@ -1631,7 +1639,7 @@ LINPHONE_PUBLIC LinphoneCall *linphone_core_get_call_by_remote_address2(Linphone * This function only works during calls. The dtmf is automatically played to the user. * @param lc The LinphoneCore object * @param dtmf The dtmf name specified as a char, such as '0', '#' etc... - * + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_send_dtmf(LinphoneCore *lc, char dtmf); @@ -2011,6 +2019,7 @@ LINPHONE_PUBLIC bool_t linphone_core_payload_type_enabled(LinphoneCore *lc, cons * @return TRUE if the payload type represents a VBR codec, FALSE if disabled. * @ingroup media_parameters * @deprecated Use linphone_payload_type_is_vbr() instead + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_core_payload_type_is_vbr(LinphoneCore *lc, const LinphonePayloadType *pt); @@ -2070,6 +2079,7 @@ LINPHONE_PUBLIC LinphonePayloadType* linphone_core_find_payload_type(LinphoneCor * Returns the payload type number assigned for this codec. * @ingroup media_parameters * @deprecated Use linphone_payload_type_get_number() instead + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_payload_type_number(LinphoneCore *lc, const PayloadType *pt); @@ -2078,6 +2088,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_payload_type_number(Li * to override the automatic assignment mechanism. * @ingroup media_parameters * @deprecated Use linphone_payload_type_set_number() instead + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_payload_type_number(LinphoneCore *lc, PayloadType *pt, int number); @@ -2135,6 +2146,7 @@ LINPHONE_PUBLIC void linphone_core_set_default_proxy_index(LinphoneCore *lc, int /** * @return the default proxy configuration, that is the one used to determine the current identity. * @deprecated Use linphone_core_get_default_proxy_config() instead. + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_default_proxy(LinphoneCore *lc, LinphoneProxyConfig **config); @@ -2455,8 +2467,9 @@ LINPHONE_PUBLIC bool_t linphone_core_get_use_rfc2833_for_dtmf(LinphoneCore *lc); * @param[in] port The UDP port to be used by SIP * @ingroup network_parameters * @deprecated use linphone_core_set_sip_transports() instead. + * @donotwrap **/ -LINPHONE_PUBLIC void linphone_core_set_sip_port(LinphoneCore *lc, int port); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_sip_port(LinphoneCore *lc, int port); /** * Gets the UDP port used by SIP. @@ -2464,8 +2477,9 @@ LINPHONE_PUBLIC void linphone_core_set_sip_port(LinphoneCore *lc, int port); * @return The UDP port used by SIP * @ingroup network_parameters * @deprecated use linphone_core_get_sip_transports() instead. + * @donotwrap **/ -LINPHONE_PUBLIC int linphone_core_get_sip_port(LinphoneCore *lc); +LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_sip_port(LinphoneCore *lc); /** * Sets the ports to be used for each of transport (UDP or TCP) @@ -2486,6 +2500,7 @@ LINPHONE_PUBLIC int linphone_core_set_sip_transports(LinphoneCore *lc, const Lin * @param[out] transports A #LinphoneSipTransports structure that will receive the configured ports * @return 0 * @ingroup network_parameters + * @donotwrap **/ LINPHONE_PUBLIC int linphone_core_get_sip_transports(LinphoneCore *lc, LinphoneSipTransports *transports); @@ -2496,6 +2511,7 @@ LINPHONE_PUBLIC int linphone_core_get_sip_transports(LinphoneCore *lc, LinphoneS * @param[in] lc LinphoneCore object * @param[out] tr A #LinphoneSipTransports structure that will receive the ports being used * @ingroup network_parameters + * @donotwrap **/ LINPHONE_PUBLIC void linphone_core_get_sip_transports_used(LinphoneCore *lc, LinphoneSipTransports *tr); @@ -2637,6 +2653,7 @@ LINPHONE_PUBLIC const char *linphone_core_get_nat_address(const LinphoneCore *lc * @param[in] pol The #LinphoneFirewallPolicy to use. * @ingroup network_parameters * @deprecated Use linphone_core_set_nat_policy() instead. + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_set_firewall_policy(LinphoneCore *lc, LinphoneFirewallPolicy pol); @@ -2645,7 +2662,8 @@ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_set_firewall_policy(Linph * @param[in] lc #LinphoneCore object. * @return The #LinphoneFirewallPolicy that is being used. * @ingroup network_parameters - * @deprecated Use linphone_core_get_nat_policy() instead. + * @deprecated Use linphone_core_get_nat_policy() instead + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneFirewallPolicy linphone_core_get_firewall_policy(const LinphoneCore *lc); @@ -2714,6 +2732,7 @@ LINPHONE_PUBLIC bool_t linphone_core_sound_device_can_playback(LinphoneCore *lc, * Get ring sound level in 0-100 scale. * @ingroup media_parameters * @deprecated + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_ring_level(LinphoneCore *lc); @@ -2721,6 +2740,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_ring_level(LinphoneCor * Get playback sound level in 0-100 scale. * @ingroup media_parameters * @deprecated + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_play_level(LinphoneCore *lc); @@ -2728,6 +2748,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_play_level(LinphoneCor * Get sound capture level in 0-100 scale. * @ingroup media_parameters * @deprecated + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_rec_level(LinphoneCore *lc); @@ -2735,6 +2756,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_core_get_rec_level(LinphoneCore * Set sound ring level in 0-100 scale. * @ingroup media_parameters * @deprecated + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_ring_level(LinphoneCore *lc, int level); @@ -2742,6 +2764,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_ring_level(LinphoneCo * Set sound playback level in 0-100 scale. * @deprecated * @ingroup media_parameters + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_play_level(LinphoneCore *lc, int level); @@ -2749,6 +2772,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_play_level(LinphoneCo * Set sound capture level in 0-100 scale. * @deprecated * @ingroup media_parameters + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_rec_level(LinphoneCore *lc, int level); @@ -3021,12 +3045,14 @@ bool_t linphone_core_agc_enabled(const LinphoneCore *lc); /** * @deprecated Use #linphone_core_enable_mic instead. + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_mute_mic(LinphoneCore *lc, bool_t muted); /** * Get mic state. * @deprecated Use #linphone_core_mic_enabled instead + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_core_is_mic_muted(LinphoneCore *lc); @@ -3170,6 +3196,7 @@ LINPHONE_PUBLIC bool_t linphone_core_video_supported(LinphoneCore *lc); * @param display_enabled indicates whether video display should be shown * @ingroup media_parameters * @deprecated Use #linphone_core_enable_video_capture and #linphone_core_enable_video_display instead. + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_enable_video(LinphoneCore *lc, bool_t vcap_enabled, bool_t display_enabled); @@ -3732,6 +3759,7 @@ LINPHONE_PUBLIC LinphoneConfig * linphone_core_get_config(LinphoneCore *lc); * @param[in] filename The filename of the config file to read to fill the instantiated LpConfig * @ingroup misc * @deprecated Use linphone_core_create_config() instead. + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneConfig * linphone_core_create_lp_config(LinphoneCore *lc, const char *filename); @@ -3758,6 +3786,7 @@ LINPHONE_PUBLIC const bctbx_list_t * linphone_core_get_sip_setups(LinphoneCore * * @param[in] lc LinphoneCore object * @ingroup initializing * @deprecated Use linphone_core_unref() instead. + * @donotwrap **/ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_core_destroy(LinphoneCore *lc); @@ -4805,8 +4834,9 @@ LINPHONE_PUBLIC LinphoneFriend * linphone_core_create_friend_with_address(Linpho * @param[in] alternative_contact sip uri used to redirect call in state #LinphoneStatusMoved * @param[in] os #LinphoneOnlineStatus * @deprecated Use linphone_core_set_presence_model() instead + * @donotwrap */ -LINPHONE_PUBLIC void linphone_core_set_presence_info(LinphoneCore *lc,int minutes_away,const char *alternative_contact,LinphoneOnlineStatus os); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_set_presence_info(LinphoneCore *lc,int minutes_away,const char *alternative_contact,LinphoneOnlineStatus os); /** * Set my presence model @@ -4820,8 +4850,9 @@ LINPHONE_PUBLIC void linphone_core_set_presence_model(LinphoneCore *lc, Linphone * @param[in] lc #LinphoneCore object * @return #LinphoneOnlineStatus * @deprecated Use linphone_core_get_presence_model() instead + * @donotwrap */ -LINPHONE_PUBLIC LinphoneOnlineStatus linphone_core_get_presence_info(const LinphoneCore *lc); +LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneOnlineStatus linphone_core_get_presence_info(const LinphoneCore *lc); /** * Get my presence model @@ -4846,8 +4877,9 @@ LINPHONE_PUBLIC void linphone_core_set_consolidated_presence(LinphoneCore *lc, L /** * @deprecated Use linphone_core_interpret_url() instead + * @donotwrap */ -LINPHONE_PUBLIC void linphone_core_interpret_friend_uri(LinphoneCore *lc, const char *uri, char **result); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_interpret_friend_uri(LinphoneCore *lc, const char *uri, char **result); /** * Add a friend to the current buddy list, if \link linphone_friend_enable_subscribes() subscription attribute \endlink is set, a SIP SUBSCRIBE message is sent. @@ -4862,8 +4894,9 @@ LINPHONE_PUBLIC void linphone_core_add_friend(LinphoneCore *lc, LinphoneFriend * * @param lc #LinphoneCore object * @param fr #LinphoneFriend to remove * @deprecated use linphone_friend_list_remove_friend() instead. + * @donotwrap */ -LINPHONE_PUBLIC void linphone_core_remove_friend(LinphoneCore *lc, LinphoneFriend *fr); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_core_remove_friend(LinphoneCore *lc, LinphoneFriend *fr); /** * Black list a friend. same as linphone_friend_set_inc_subscribe_policy() with #LinphoneSPDeny policy; @@ -4877,8 +4910,9 @@ LINPHONE_PUBLIC void linphone_core_reject_subscriber(LinphoneCore *lc, LinphoneF * @param[in] lc #LinphoneCore object * @return \bctbx_list{LinphoneFriend} * @deprecated use linphone_core_get_friends_lists() or linphone_friend_list_get_friends() instead. + * @donotwrap */ -LINPHONE_PUBLIC const bctbx_list_t * linphone_core_get_friend_list(const LinphoneCore *lc); +LINPHONE_PUBLIC LINPHONE_DEPRECATED const bctbx_list_t * linphone_core_get_friend_list(const LinphoneCore *lc); /** * Notify all friends that have subscribed @@ -4893,8 +4927,9 @@ LINPHONE_PUBLIC void linphone_core_notify_all_friends(LinphoneCore *lc, Linphone * @param[in] addr The address to use to search the friend. * @return The #LinphoneFriend object corresponding to the given address. * @deprecated use linphone_core_find_friend() instead. + * @donotwrap */ -LINPHONE_PUBLIC LinphoneFriend *linphone_core_get_friend_by_address(const LinphoneCore *lc, const char *addr); +LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneFriend *linphone_core_get_friend_by_address(const LinphoneCore *lc, const char *addr); /** * Search a LinphoneFriend by its address. diff --git a/include/linphone/friend.h b/include/linphone/friend.h index f3520f857..3c1e5d1b5 100644 --- a/include/linphone/friend.h +++ b/include/linphone/friend.h @@ -35,6 +35,7 @@ extern "C" { * Contructor * @return a new empty #LinphoneFriend * @deprecated use #linphone_core_create_friend instead + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneFriend * linphone_friend_new(void); @@ -43,6 +44,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneFriend * linphone_friend_new(void); * @param addr a buddy address, must be a sip uri like sip:joe@sip.linphone.org * @return a new #LinphoneFriend with \link linphone_friend_get_address() address initialized \endlink * @deprecated use #linphone_core_create_friend_with_address instead + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneFriend *linphone_friend_new_with_address(const char *addr); @@ -56,8 +58,9 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneFriend *linphone_friend_new_with_add * Destroy a LinphoneFriend. * @param lf LinphoneFriend object * @deprecated Use linphone_friend_unref() instead. + * @donotwrap */ -LINPHONE_PUBLIC void linphone_friend_destroy(LinphoneFriend *lf); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_friend_destroy(LinphoneFriend *lf); /** * Set #LinphoneAddress for this friend @@ -191,8 +194,9 @@ LINPHONE_PUBLIC void linphone_friend_done(LinphoneFriend *fr); * @param[in] lf A #LinphoneFriend object * @return #LinphoneOnlineStatus * @deprecated Use linphone_friend_get_presence_model() instead + * @donotwrap */ -LINPHONE_PUBLIC LinphoneOnlineStatus linphone_friend_get_status(const LinphoneFriend *lf); +LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneOnlineStatus linphone_friend_get_status(const LinphoneFriend *lf); /** * Get subscription state of a friend diff --git a/include/linphone/info_message.h b/include/linphone/info_message.h index 5fe3e5db2..06a59ee2a 100644 --- a/include/linphone/info_message.h +++ b/include/linphone/info_message.h @@ -77,6 +77,7 @@ LINPHONE_PUBLIC void linphone_info_message_unref(LinphoneInfoMessage *im); /** * Destroy a LinphoneInfoMessage. * @deprecated Use linphone_info_message_unref() instead. + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_info_message_destroy(LinphoneInfoMessage *im); diff --git a/include/linphone/lpconfig.h b/include/linphone/lpconfig.h index 330d7e8ff..a76a1580e 100644 --- a/include/linphone/lpconfig.h +++ b/include/linphone/lpconfig.h @@ -276,6 +276,7 @@ LINPHONE_PUBLIC void linphone_config_write_relative_file(const LinphoneConfig *l * @param data Buffer where read string will be stored * @param max_length Length of the buffer * @return 0 on success, -1 on failure + * @donotwrap */ LINPHONE_PUBLIC int linphone_config_read_relative_file(const LinphoneConfig *lpconfig, const char *filename, char *data, size_t max_length); diff --git a/include/linphone/misc.h b/include/linphone/misc.h index ce9d2e74a..cb27cbe54 100644 --- a/include/linphone/misc.h +++ b/include/linphone/misc.h @@ -113,8 +113,9 @@ LINPHONE_PUBLIC const char *linphone_reason_to_string(LinphoneReason err); * Return humain readable presence status * @param ss * @deprecated Use #LinphonePresenceModel, #LinphonePresenceActivity and linphone_presence_activity_to_string() instead. + * @donotwrap */ -LINPHONE_PUBLIC const char *linphone_online_status_to_string(LinphoneOnlineStatus ss); +LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_online_status_to_string(LinphoneOnlineStatus ss); /** * Convert a string into LinphoneTunnelMode enum diff --git a/include/linphone/proxy_config.h b/include/linphone/proxy_config.h index eb6a30d02..6c305140b 100644 --- a/include/linphone/proxy_config.h +++ b/include/linphone/proxy_config.h @@ -33,8 +33,9 @@ extern "C" { /** * Creates an empty proxy config. * @deprecated, use #linphone_core_create_proxy_config instead + * @donotwrap **/ -LINPHONE_PUBLIC LinphoneProxyConfig *linphone_proxy_config_new(void); +LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneProxyConfig *linphone_proxy_config_new(void); /** * Acquire a reference to the proxy config. @@ -75,8 +76,9 @@ LINPHONE_PUBLIC int linphone_proxy_config_set_server_addr(LinphoneProxyConfig *c /** * @deprecated Use linphone_proxy_config_set_identity_address() + * @donotwrap **/ -LINPHONE_PUBLIC int linphone_proxy_config_set_identity(LinphoneProxyConfig *cfg, const char *identity); +LINPHONE_PUBLIC LINPHONE_DEPRECATED int linphone_proxy_config_set_identity(LinphoneProxyConfig *cfg, const char *identity); /** * Sets the user identity as a SIP address. @@ -228,8 +230,9 @@ LINPHONE_PUBLIC LinphoneRegistrationState linphone_proxy_config_get_state(const /** * @return a boolean indicating that the user is sucessfully registered on the proxy. * @deprecated Use linphone_proxy_config_get_state() instead. + * @donotwrap **/ -LINPHONE_PUBLIC bool_t linphone_proxy_config_is_registered(const LinphoneProxyConfig *cfg); +LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_proxy_config_is_registered(const LinphoneProxyConfig *cfg); /** * Get the domain name of the given proxy config. @@ -249,7 +252,6 @@ LINPHONE_PUBLIC const char *linphone_proxy_config_get_realm(const LinphoneProxyC * Set the realm of the given proxy config. * @param[in] cfg #LinphoneProxyConfig object. * @param[in] realm New realm value. - * @return The realm of the proxy config. **/ LINPHONE_PUBLIC void linphone_proxy_config_set_realm(LinphoneProxyConfig *cfg, const char * realm); @@ -265,8 +267,9 @@ LINPHONE_PUBLIC const LinphoneAddress *linphone_proxy_config_get_identity_addres /** * @deprecated use linphone_proxy_config_get_identity_address() + * @donotwrap **/ -LINPHONE_PUBLIC const char *linphone_proxy_config_get_identity(const LinphoneProxyConfig *cfg); +LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_proxy_config_get_identity(const LinphoneProxyConfig *cfg); /** * @return TRUE if PUBLISH request is enabled for this proxy. @@ -380,12 +383,12 @@ LINPHONE_PUBLIC const char* linphone_proxy_config_get_transport(const LinphonePr /** * Destroys a proxy config. - * @deprecated - * * @note: LinphoneProxyConfig that have been removed from LinphoneCore with * linphone_core_remove_proxy_config() must not be freed. + * @deprecated + * @donotwrap **/ -LINPHONE_PUBLIC void linphone_proxy_config_destroy(LinphoneProxyConfig *cfg); +LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_proxy_config_destroy(LinphoneProxyConfig *cfg); LINPHONE_PUBLIC void linphone_proxy_config_set_sip_setup(LinphoneProxyConfig *cfg, const char *type); @@ -409,6 +412,7 @@ LINPHONE_PUBLIC bool_t linphone_proxy_config_is_phone_number(LinphoneProxyConfig * @param result_len the size of the normalized number \a result * @return TRUE if a phone number was recognized, FALSE otherwise. * @deprecated use linphone_proxy_config_normalize_phone_number() + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_proxy_config_normalize_number(LinphoneProxyConfig *proxy, const char *username, char *result, size_t result_len); @@ -456,6 +460,7 @@ LINPHONE_PUBLIC LinphonePrivacyMask linphone_proxy_config_get_privacy(const Linp * @param[in] cfg #LinphoneProxyConfig object. * @param server_url URL of the file server like https://file.linphone.org/upload.php * @warning That function isn't implemented yet. + * @donotwrap * */ LINPHONE_PUBLIC void linphone_proxy_config_set_file_transfer_server(LinphoneProxyConfig *cfg, const char * server_url); @@ -464,6 +469,7 @@ LINPHONE_PUBLIC void linphone_proxy_config_set_file_transfer_server(LinphoneProx * @param[in] cfg #LinphoneProxyConfig object. * @return URL of the file server like https://file.linphone.org/upload.php * @warning That function isn't implemented yet. + * @donotwrap * */ LINPHONE_PUBLIC const char* linphone_proxy_config_get_file_transfer_server(const LinphoneProxyConfig *cfg); @@ -472,16 +478,18 @@ LINPHONE_PUBLIC const char* linphone_proxy_config_get_file_transfer_server(const * @param[in] cfg #LinphoneProxyConfig object. * @param[in] enable True to enable AVPF/SAVF, false to disable it. * @deprecated use linphone_proxy_config_set_avpf_mode() + * @donotwrap */ -LINPHONE_PUBLIC void linphone_proxy_config_enable_avpf(LinphoneProxyConfig *cfg, bool_t enable); +LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_proxy_config_enable_avpf(LinphoneProxyConfig *cfg, bool_t enable); /** * Indicates whether AVPF/SAVPF is being used for calls using this proxy config. * @param[in] cfg #LinphoneProxyConfig object. * @return True if AVPF/SAVPF is enabled, false otherwise. * @deprecated use linphone_proxy_config_set_avpf_mode() + * @donotwrap */ -LINPHONE_PUBLIC bool_t linphone_proxy_config_avpf_enabled(LinphoneProxyConfig *cfg); +LINPHONE_DEPRECATED LINPHONE_PUBLIC bool_t linphone_proxy_config_avpf_enabled(LinphoneProxyConfig *cfg); /** * Set the interval between regular RTCP reports when using AVPF/SAVPF. diff --git a/include/linphone/tunnel.h b/include/linphone/tunnel.h index 462a49fc3..3fbfa9c4b 100644 --- a/include/linphone/tunnel.h +++ b/include/linphone/tunnel.h @@ -208,6 +208,7 @@ LINPHONE_PUBLIC void linphone_tunnel_config_unref(LinphoneTunnelConfig *cfg); * Destroy a tunnel configuration * @param tunnel LinphoneTunnelConfig object * @deprecated use linphone_tunnel_config_unref(). + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_tunnel_config_destroy(LinphoneTunnelConfig *tunnel); @@ -342,6 +343,7 @@ LINPHONE_PUBLIC void linphone_tunnel_set_http_proxy(LinphoneTunnel *tunnel, cons * @param port http proxy port * @param username Optional http proxy username if the proxy request authentication. Currently only basic authentication is supported. Use NULL if not needed. * @param passwd Optional http proxy password. Use NULL if not needed. + * @donotwrap **/ LINPHONE_PUBLIC void linphone_tunnel_get_http_proxy(LinphoneTunnel*tunnel,const char **host, int *port, const char **username, const char **passwd); @@ -359,6 +361,7 @@ LINPHONE_PUBLIC void linphone_tunnel_set_http_proxy_auth_info(LinphoneTunnel*tun * @param enabled If true enter in tunneled mode, if false exits from tunneled mode. * The TunnelManager takes care of refreshing SIP registration when switching on or off the tunneled mode. * @deprecated Replaced by linphone_tunnel_set_mode() + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_tunnel_enable(LinphoneTunnel *tunnel, bool_t enabled); @@ -367,6 +370,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_tunnel_enable(LinphoneTunnel * * @param tunnel Tunnel object * @return Returns a boolean indicating whether tunneled operation is enabled. * @deprecated Replaced by linphone_tunnel_get_mode() + * @donotwrap **/ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_tunnel_enabled(const LinphoneTunnel *tunnel); @@ -377,6 +381,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_tunnel_enabled(const Linphon *
In case of success, the tunnel is automatically turned off. Otherwise, if no udp communication is feasible, tunnel mode is turned on. *
Call this method each time to run the auto detection algorithm * @deprecated Replaced by linphone_tunnel_set_mode(LinphoneTunnelModeAuto) + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_tunnel_auto_detect(LinphoneTunnel *tunnel); @@ -385,6 +390,7 @@ LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_tunnel_auto_detect(LinphoneTun * @param[in] tunnel LinphoneTunnel object. * @return TRUE if auto detection is enabled, FALSE otherwise. * @deprecated Replaced by linphone_tunnel_get_mode() + * @donotwrap */ LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_tunnel_auto_detect_enabled(LinphoneTunnel *tunnel); diff --git a/include/linphone/types.h b/include/linphone/types.h index 1b6f2f6ad..3782621e9 100644 --- a/include/linphone/types.h +++ b/include/linphone/types.h @@ -227,8 +227,8 @@ typedef enum _LinphoneCallState{ LinphoneCallIncomingEarlyMedia, /**< We are proposing early media to an incoming call */ LinphoneCallUpdating, /**< A call update has been initiated by us */ LinphoneCallReleased, /**< The call object is no more retained by the core */ - LinphoneCallEarlyUpdatedByRemote, /*< The call is updated by remote while not yet answered (early dialog SIP UPDATE received) */ - LinphoneCallEarlyUpdating /*< We are updating the call while not yet answered (early dialog SIP UPDATE sent) */ + LinphoneCallEarlyUpdatedByRemote, /**< The call is updated by remote while not yet answered (early dialog SIP UPDATE received) */ + LinphoneCallEarlyUpdating /**< We are updating the call while not yet answered (early dialog SIP UPDATE sent) */ } LinphoneCallState; /** @@ -362,8 +362,9 @@ typedef unsigned int LinphoneContactSearchID; /** * Old name of LinphoneContactSearchID * @deprecated + * @donotwrap */ -typedef LinphoneContactSearchID ContactSearchID; +LINPHONE_DEPRECATED typedef LinphoneContactSearchID ContactSearchID; /** * The LinphoneContent object holds data that can be embedded in a signaling message. @@ -428,6 +429,7 @@ typedef struct _LinphoneFactory LinphoneFactory; * Policy to use to pass through firewalls. * @ingroup network_parameters * @deprecated Use #LinphoneNatPolicy instead. + * @donotwrap **/ typedef enum _LinphoneFirewallPolicy { LinphonePolicyNoFirewall, /**< Do not use any mechanism to pass through firewalls */ @@ -590,6 +592,7 @@ typedef struct _LinphoneNatPolicy LinphoneNatPolicy; /** * Enum describing remote friend status * @deprecated Use #LinphonePresenceModel and #LinphonePresenceActivity instead + * @donotwrap */ typedef enum _LinphoneOnlineStatus{ LinphoneStatusOffline, /**< Offline */ @@ -912,8 +915,9 @@ typedef struct _LinphoneSipTransports { /** * Old name of LinphoneSipTransports * @deprecated + * @donotwrap */ -typedef struct _LinphoneSipTransports LCSipTransports; +LINPHONE_DEPRECATED typedef struct _LinphoneSipTransports LCSipTransports; typedef struct _LinphoneSoundDaemon LinphoneSoundDaemon; diff --git a/include/linphone/vcard.h b/include/linphone/vcard.h index ef82e91c1..23b3e9d42 100644 --- a/include/linphone/vcard.h +++ b/include/linphone/vcard.h @@ -41,6 +41,7 @@ extern "C" * Creates a LinphoneVcard object that has a pointer to an empty vCard * @return a new LinphoneVcard object * @deprecated Use linphone_factory_create_vcard() instead. + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneVcard* linphone_vcard_new(void); @@ -48,6 +49,7 @@ LINPHONE_DEPRECATED LINPHONE_PUBLIC LinphoneVcard* linphone_vcard_new(void); * Deletes a LinphoneVcard object properly * @param[in] vCard the LinphoneVcard to destroy * @deprecated Use linphone_vcard_unref() or belle_sip_object_unref() instead. + * @donotwrap */ LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_vcard_free(LinphoneVcard *vCard); diff --git a/wrappers/cpp/abstractapi.py b/wrappers/cpp/abstractapi.py index eeaf10e08..c5fcc8066 100644 --- a/wrappers/cpp/abstractapi.py +++ b/wrappers/cpp/abstractapi.py @@ -433,62 +433,11 @@ class CParser(object): self.cListType = 'bctbx_list_t' self.regexFixedSizeInteger = '^(u?)int(\d?\d)_t$' self.methodBl = ['ref', 'unref', 'new', 'destroy', 'getCurrentCallbacks', 'setUserData', 'getUserData'] - self.functionBl = ['linphone_tunnel_get_http_proxy', - 'linphone_core_can_we_add_call', - 'linphone_core_add_listener', - 'linphone_core_remove_listener', + self.functionBl = [ 'linphone_core_get_current_callbacks', - 'linphone_proxy_config_set_file_transfer_server', - 'linphone_proxy_config_get_file_transfer_server', 'linphone_factory_create_core', # manualy wrapped 'linphone_factory_create_core_with_config', # manualy wrapped - 'linphone_buffer_get_content', - 'linphone_chat_room_send_chat_message', # overloaded - 'linphone_chat_message_resend', # overloaded - 'linphone_config_read_relative_file', - 'linphone_vcard_get_belcard', # manualy wrapped - 'linphone_chat_room_destroy', # was deprecated when the wrapper generator was made - 'linphone_chat_room_send_message', # was deprecated when the wrapper generator was made - 'linphone_chat_room_send_message2', # was deprecated when the wrapper generator was made - 'linphone_chat_room_get_lc', # was deprecated when the wrapper generator was made - 'linphone_chat_message_start_file_download', # was deprecated when the wrapper generator was made - 'linphone_vcard_new', # was deprecated when the wrapper generator was made - 'linphone_vcard_free', # was deprecated when the wrapper generator was made - 'linphone_call_params_destroy', # was deprecated when the wrapper generator was made - 'linphone_address_is_secure', # was deprecated when the wrapper generator was made - 'linphone_address_destroy', # was deprecated when the wrapper generator was made - 'linphone_core_enable_logs', # was deprecated when the wrapper generator was made - 'linphone_core_enable_logs_with_cb', # was deprecated when the wrapper generator was made - 'linphone_core_disable_logs', # was deprecated when the wrapper generator was made - 'linphone_core_get_user_agent_name', # was deprecated when the wrapper generator was made - 'linphone_core_get_user_agent_version', # was deprecated when the wrapper generator was made - 'linphone_core_new', # was deprecated when the wrapper generator was made - 'linphone_core_new_with_config', # was deprecated when the wrapper generator was made - 'linphone_core_add_listener', # was deprecated when the wrapper generator was made - 'linphone_core_remove_listener', # was deprecated when the wrapper generator was made - 'linphone_core_send_dtmf', # was deprecated when the wrapper generator was made - 'linphone_core_get_default_proxy', # was deprecated when the wrapper generator was made - 'linphone_core_set_firewall_policy', # was deprecated when the wrapper generator was made - 'linphone_core_get_firewall_policy', # was deprecated when the wrapper generator was made - 'linphone_core_get_ring_level', # was deprecated when the wrapper generator was made - 'linphone_core_get_play_level', # was deprecated when the wrapper generator was made - 'linphone_core_get_rec_level', # was deprecated when the wrapper generator was made - 'linphone_core_set_ring_level', # was deprecated when the wrapper generator was made - 'linphone_core_set_play_level', # was deprecated when the wrapper generator was made - 'linphone_core_set_rec_level', # was deprecated when the wrapper generator was made - 'linphone_core_mute_mic', # was deprecated when the wrapper generator was made - 'linphone_core_is_mic_muted', # was deprecated when the wrapper generator was made - 'linphone_core_enable_video', # was deprecated when the wrapper generator was made - 'linphone_core_create_lp_config', # was deprecated when the wrapper generator was made - 'linphone_core_destroy', # was deprecated when the wrapper generator was made - 'linphone_proxy_config_normalize_number', # was deprecated when the wrapper generator was made - 'linphone_call_is_in_conference', # was deprecated when the wrapper generator was made - 'linphone_friend_new', # was deprecated when the wrapper generator was made - 'linphone_friend_new_with_address', # was deprecated when the wrapper generator was made - 'linphone_core_get_sound_source', # was deprecated when the wrapper generator was made - 'linphone_core_set_sound_source', # was deprecated when the wrapper generator was made - 'linphone_core_get_sip_transports', # not wrappable - 'linphone_core_get_sip_transports_used'] # not wrappable + 'linphone_vcard_get_belcard'] # manualy wrapped self.classBl = ['LpConfig', 'LinphonePayloadType',