scripts: improve comments on functions that convert hashtables

src/plugins/guile/weechat-guile.c

@@ -190,7 +190,7 @@ weechat_guile_hashtable_map_cb (void *data,
 }
 
 /*
- * Gets guile alist with a WeeChat hashtable.
+ * Converts a WeeChat hashtable to a guile alist.
  */
 
 SCM
@@ -208,7 +208,7 @@ weechat_guile_hashtable_to_alist (struct t_hashtable *hashtable)
 }
 
 /*
- * Gets WeeChat hashtable with guile alist.
+ * Converts a guile alist to a WeeChat hashtable.
  *
  * Note: hashtable must be free after use.
  */

src/plugins/lua/weechat-lua.c

@@ -99,7 +99,7 @@ weechat_lua_hashtable_map_cb (void *data,
 }
 
 /*
- * Puts a WeeChat hashtable on lua stack, as lua table.
+ * Converts a WeeChat hashtable to a lua hash (as lua table on the stack).
  */
 
 void
@@ -113,7 +113,7 @@ weechat_lua_pushhashtable (lua_State *interpreter, struct t_hashtable *hashtable
 }
 
 /*
- * Gets WeeChat hashtable with lua hash (on stack).
+ * Converts a lua hash (on stack) to a WeeChat hashtable.
  *
  * Note: hashtable must be freed after use.
  */

src/plugins/perl/weechat-perl.c

@@ -120,7 +120,7 @@ weechat_perl_hashtable_map_cb (void *data,
 }
 
 /*
- * Gets perl hash with a WeeChat hashtable.
+ * Converts a WeeChat hashtable to a perl hash.
  */
 
 HV *
@@ -140,7 +140,7 @@ weechat_perl_hashtable_to_hash (struct t_hashtable *hashtable)
 }
 
 /*
- * Gets WeeChat hashtable with perl hash.
+ * Converts a perl hash to a WeeChat hashtable.
  *
  * Note: hashtable must be freed after use.
  */

src/plugins/python/weechat-python.c

@@ -213,7 +213,7 @@ weechat_python_hashtable_map_cb (void *data,
 }
 
 /*
- * Gets python dictionary with a WeeChat hashtable.
+ * Converts a WeeChat hashtable to a python dictionary.
  */
 
 PyObject *
@@ -236,7 +236,7 @@ weechat_python_hashtable_to_dict (struct t_hashtable *hashtable)
 }
 
 /*
- * Gets WeeChat hashtable with python dictionary.
+ * Converts a python dictionary to a WeeChat hashtable.
  *
  * Note: hashtable must be freed after use.
  */

src/plugins/ruby/weechat-ruby.c

@@ -134,7 +134,7 @@ weechat_ruby_hashtable_map_cb (void *data,
 }
 
 /*
- * Gets ruby hash with a WeeChat hashtable.
+ * Converts a WeeChat hashtable to a ruby hash.
  */
 
 VALUE
@@ -184,7 +184,7 @@ weechat_ruby_hash_foreach_cb (VALUE key, VALUE value, void *arg)
 }
 
 /*
- * Gets WeeChat hashtable with ruby hashtable.
+ * Converts a ruby hash to a WeeChat hashtable.
  *
  * Note: hashtable must be freed after use.
  */

src/plugins/tcl/weechat-tcl.c

@@ -105,7 +105,7 @@ weechat_tcl_hashtable_map_cb (void *data,
 }
 
 /*
- * Gets tcl dict with a WeeChat hashtable.
+ * Converts a WeeChat hashtable to a tcl dict.
  */
 
 Tcl_Obj *
@@ -130,7 +130,7 @@ weechat_tcl_hashtable_to_dict (Tcl_Interp *interp,
 }
 
 /*
- * Gets WeeChat hashtable with tcl dict.
+ * Converts a tcl dict to a WeeChat hashtable.
  *
  * Note: hashtable must be freed after use.
  */