Changeset b4f496e for protocols/nogaim.h

Timestamp:

2016-11-19T07:32:48Z (7 years ago)

Author:

dequis <dx@…>

Branches:

master

Children:

a7baf40

Parents:

9f03c47

Message:

Improve handling of unknown protocols / missing plugins

Instead of failing to load the config, a fake prpl is created to load
the account, keep its settings, and refuse to log in with a helpful
error message.

Also added a new explain_unknown_protocol() function which returns text
which attempts to explain why a protocol is missing, handling several
typical cases, including the future removal of several dead libpurple
plugins.

That message is shown when logging in to a loaded account with a missing
protocol and when adding a new one with 'account add', with the
difference that the latter doesn't leave a placeholder fake account.

File:

• protocols/nogaim.h (modified) (2 diffs)

protocols/nogaim.h

@@ -159 +159 @@
         /* The protocol is not suitable for OTR, see OPT_NOOTR */
         PRPL_OPT_NOOTR = 1 << 12,
+
+        /* This prpl is a placeholder for a missing protocol */
+        PRPL_OPT_UNKNOWN_PROTOCOL = 1 << 13,
 } prpl_options_t;
 
@@ -321 +324 @@
 G_MODULE_EXPORT struct prpl *find_protocol(const char *name);
 G_MODULE_EXPORT gboolean is_protocol_disabled(const char *name);
+G_MODULE_EXPORT struct prpl *make_unknown_protocol(const char *name);
+G_MODULE_EXPORT char *explain_unknown_protocol(const char *name);
 /* When registering a new protocol, you should allocate space for a new prpl
  * struct, initialize it (set the function pointers to point to your