Documentation 
Section: 
Over at gtk.org the generated documentation for function g_seekable_truncate() doesn't really tell me anything about that the function does. It sort of just repeats the name of the function. Maybe for people born next to a PDP-11 this is useful info, but it just makes me confused?

The current documentation is:
"Truncates a stream with a given offset."

I wonder for example:
* What does "truncate" mean in thus context?
* Does it truncate the beginning or the end of the stream?
* Is this also written to disk right away or even I close the stream?
* On which types of streams is this operation application? (input/output or both?)
* What properties of the stream changes when I run this method? For example, is it true that stream.current_position always becomes zero?
* If I do .seek(5) and then truncate() will the file now be 5 bytes long?

The docs have a huge room for improvement here. As I said, I'm working mostly in higher level languages and they don't have a truncate() function and I've never heard of this function and/or system call and/or fopen mode before and it's _not_ obvious.

If someone could just add one more sentence that would still be very useful. 

PS. The master copy of the documentation is located at glib/gio/gseekable.c on line 183 in case someone wants to contribute a patch. DS.

kthxbye

Correct version:


Other information: