Possible misprint in documentation



I was reading GTK 2.0 API reference
on page http://developer.gnome.org/doc/API/2.0/gtk/gtk-general.html
in description of function "PangoLanguage* gtk_get_default_language
(void);"
it is written "Returns : the default language as an allocated string, must
be freed"

Why "allocated STRING" and not STRUCTURE or BUFFER or something else?
Probably it should be changed???

I don't know English very well but I undestand STRING as array of characters
not array of bytes,
even if I allocate array of bytes as:
char x[100];

It is not so important in fact but i think it should be clearness in
documentation.
Good documentation - good programmers.

Sergey Scobich (scobich dekart com)
Dekart Company (www.dekart.com)




[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]