Changeset 7c5affca

Timestamp:

2010-03-12T01:47:44Z (15 years ago)

Author:

Wilmer van der Gaast <wilmer@…>

Branches:

master

Children:

3330468

Parents:

4dc6b8d

Message:

Add some simple information about available settings to the online help
command.

File:

• protocols/purple/purple.c (modified) (6 diffs)

protocols/purple/purple.c

@@ -60 +60 @@
         GList *i, *st;
         set_t *s;
+        char help_title[64];
+        GString *help;
+        
+        help = g_string_new( "" );
+        g_string_printf( help, "BitlBee libpurple module %s (%s).\n\nSupported settings:",
+                                (char*) acc->prpl->name, prpl->info->name );
         
         /* Convert all protocol_options into per-account setting variables. */
@@ -78 +84 @@
                 case PURPLE_PREF_STRING:
                         def = g_strdup( purple_account_option_get_default_string( o ) );
+                        
+                        g_string_append_printf( help, "\n* %s (%s), %s, default: %s",
+                                                name, purple_account_option_get_text( o ),
+                                                "string", def );
+                        
                         break;
                 
@@ -83 +94 @@
                         def = g_strdup_printf( "%d", purple_account_option_get_default_int( o ) );
                         eval = set_eval_int;
+                        
+                        g_string_append_printf( help, "\n* %s (%s), %s, default: %s",
+                                                name, purple_account_option_get_text( o ),
+                                                "integer", def );
+                        
                         break;
                 
@@ -91 +107 @@
                                 def = g_strdup( "false" );
                         eval = set_eval_bool;
+                        
+                        g_string_append_printf( help, "\n* %s (%s), %s, default: %s",
+                                                name, purple_account_option_get_text( o ),
+                                                "boolean", def );
+                        
                         break;
                 
                 case PURPLE_PREF_STRING_LIST:
                         def = g_strdup( purple_account_option_get_default_list_value( o ) );
+                        
+                        g_string_append_printf( help, "\n* %s (%s), %s, default: %s",
+                                                name, purple_account_option_get_text( o ),
+                                                "list", def );
+                        g_string_append( help, "\n  Possible values: " );
+                        
                         for( io = purple_account_option_get_list( o ); io; io = io->next )
                         {
                                 PurpleKeyValuePair *kv = io->data;
                                 opts = g_slist_append( opts, kv->key );
+                                g_string_append_printf( help, "%s, ", kv->key );
                         }
+                        g_string_truncate( help, help->len - 2 );
                         eval = set_eval_list;
                         eval_data = opts;
+                        
                         break;
                         
@@ -118 +148 @@
                 }
         }
+        
+        g_snprintf( help_title, sizeof( help_title ), "purple %s", (char*) acc->prpl->name );
+        help_add_mem( &global.help, help_title, help->str );
+        g_string_free( help, TRUE );
         
         if( pi->options & OPT_PROTO_MAIL_CHECK )
@@ -713 +747 @@
         }
         
+        g_string_append( help, "\n\nFor used protocols, more information about available "
+                         "settings can be found using \x02help purple <protocol name>\x02" );
+        
         /* Add a simple dynamically-generated help item listing all
            the supported protocols. */