documentation: g_slist_remove*, g_slist_delete*

[Felix Kater <fkater googlemail com>]

Hi,

here some remarks about the documentation of some g_slist* functions:

g_slist_remove():

It is not explicitly said if the data which the element points to is
freed as well. If you read g_slist_remove_link() below then you might
understand that, however, indirectly only.

g_slist_delete_link():

I find it quite hard to understand what this function does -- since the
explication is short and the term 'node' is used instead of 'element'.
This makes it even more compliacted to get its meaning by the context.
Also, it is not said, if the element's data is freed as well.

g_slist_delete_link, g_slist_remove_all, g_slist_insert_before:

For consistancy reasons, these 3 functions should use the term 'element'
like all others but not 'node'.

Felix