LADI
/
jack2
1
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

common/jack/session.h: remove newsm recommendation 

Jack-Session was bad idea from the start,
so its use was never encouraged in LADI project.

NonSM & NewSM OSC-RPC, as used over UDP only, was and still is
unrealiable in multi computer in a network scenarios because of the
UDP packet loss.

Jack-Session used to be another jackaudio.org recommendation,
which ended in deprecations. However, as loading JS sessions via
LADISH is a feature to be maintained and sensible warnings during
build are to be easy catched, the half-deprecated jack-session api is
now undeprecated for the compiler. Jack-Session is left documented as
deprecated.
This commit is contained in:
Nedko Arnaudov 2023-08-27 21:05:56 +03:00
parent 3aa7e87727
commit 2de192bc81
1 changed files with 12 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
common/jack/session.h
View File

@ -31,9 +31,7 @@ extern "C" {
/**
* @defgroup SessionClientFunctions Session API for clients.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://new-session-manager.jackaudio.org/
* @deprecated Use of JACK-Session is deprecated.
* @{
*/
@ -160,9 +158,7 @@ typedef struct _jack_session_event jack_session_event_t;
*
* The client must promptly call jack_session_reply for this event.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://github.com/linuxaudio/new-session-manager
* @deprecated Use of JACK-Session is deprecated.
*
* @param event The event structure.
* @param arg Pointer to a client supplied structure.
@ -178,15 +174,13 @@ typedef void (*JackSessionCallback)(jack_session_event_t *event,
* error. if you have a multiclient application its more sensible to create
* a jack_client with only a session callback set.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://github.com/linuxaudio/new-session-manager
* @deprecated Use of JACK-Session is deprecated.
*
* @return 0 on success, otherwise a non-zero error code
*/
int jack_set_session_callback (jack_client_t *client,
JackSessionCallback session_callback,
void *arg) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT;
void *arg) JACK_OPTIONAL_WEAK_EXPORT;
/**
* Reply to a session event.
@ -195,14 +189,12 @@ int jack_set_session_callback (jack_client_t *client,
* different thread. For example, it is possible to push the event through a
* queue and execute the save code from the GUI thread.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://github.com/linuxaudio/new-session-manager
* @deprecated Use of JACK-Session is deprecated.
*
* @return 0 on success, otherwise a non-zero error code
*/
int jack_session_reply (jack_client_t *client,
jack_session_event_t *event) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT;
jack_session_event_t *event) JACK_OPTIONAL_WEAK_EXPORT;
/**
@ -210,11 +202,9 @@ int jack_session_reply (jack_client_t *client,
*
* This also frees the memory used by the command_line pointer, if its non NULL.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://github.com/linuxaudio/new-session-manager
* @deprecated Use of JACK-Session is deprecated.
*/
void jack_session_event_free (jack_session_event_t *event) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT;
void jack_session_event_free (jack_session_event_t *event) JACK_OPTIONAL_WEAK_EXPORT;
/**
@ -259,11 +249,9 @@ jack_session_command_t *jack_session_notify (
/**
* Free the memory allocated by a session command.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://github.com/linuxaudio/new-session-manager
* @deprecated Use of JACK-Session is deprecated.
*/
void jack_session_commands_free (jack_session_command_t *cmds) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT;
void jack_session_commands_free (jack_session_command_t *cmds) JACK_OPTIONAL_WEAK_EXPORT;
/**
* Reserve a client name and associate it with a UUID.
@ -282,15 +270,13 @@ jack_reserve_client_name (jack_client_t *client,
/**
* Find out whether a client has set up a session callback.
*
* @deprecated Use of JACK-Session is currently deprecated and unsupported.
* JACK developers recommend the use of NSM instead.
* See https://github.com/linuxaudio/new-session-manager
* @deprecated Use of JACK-Session is deprecated.
*
* @return 0 when the client has no session callback, 1 when it has one.
* -1 on error.
*/
int
jack_client_has_session_callback (jack_client_t *client, const char *client_name) JACK_OPTIONAL_WEAK_DEPRECATED_EXPORT;
jack_client_has_session_callback (jack_client_t *client, const char *client_name) JACK_OPTIONAL_WEAK_EXPORT;
/**
* @}