Improvements pointed out by Behdad Esfahbod (#314460):

2005-08-26  Matthias Clasen  <mclasen@redhat.com>

	Improvements pointed out by Behdad Esfahbod (#314460):

	* glib/tmpl/strings.sgml: Fix up some character/byte
	sloppyness.

	* glib/tmpl/iochannels.sgml: Don't mention deprecated
	functions in the introduction.
This commit is contained in:
Matthias Clasen 2005-08-26 16:46:09 +00:00 committed by Matthias Clasen
parent 1b43764b52
commit c593d2b180
3 changed files with 26 additions and 16 deletions

View File

@ -1,3 +1,13 @@
2005-08-26 Matthias Clasen <mclasen@redhat.com>
Improvements pointed out by Behdad Esfahbod (#314460):
* glib/tmpl/strings.sgml: Fix up some character/byte
sloppyness.
* glib/tmpl/iochannels.sgml: Don't mention deprecated
functions in the introduction.
2005-08-23 Matthias Clasen <mclasen@redhat.com> 2005-08-23 Matthias Clasen <mclasen@redhat.com>
* === Released 2.8.1 === * === Released 2.8.1 ===

View File

@ -21,7 +21,7 @@ manner using g_io_channel_new_file().
<para> <para>
Once a #GIOChannel has been created, it can be used in a generic manner Once a #GIOChannel has been created, it can be used in a generic manner
with the functions g_io_channel_read_chars(), g_io_channel_write_chars(), with the functions g_io_channel_read_chars(), g_io_channel_write_chars(),
g_io_channel_seek_position(), and g_io_channel_close(). g_io_channel_seek_position(), and g_io_channel_shutdown().
</para> </para>
<para> <para>
To add a #GIOChannel to the To add a #GIOChannel to the

View File

@ -25,7 +25,7 @@ The #GString struct contains the public fields of a #GString.
The <structfield>str</structfield> field points to the character data. The <structfield>str</structfield> field points to the character data.
It may move as text is added. It may move as text is added.
The <structfield>len</structfield> field contains the length of the string, The <structfield>len</structfield> field contains the length of the string,
not including the terminating nul character. not including the terminating nul byte.
</para> </para>
<para> <para>
The <structfield>str</structfield> field is nul-terminated and so can be used as an ordinary C The <structfield>str</structfield> field is nul-terminated and so can be used as an ordinary C
@ -59,7 +59,7 @@ provided, @init need not be nul-terminated, and can contain embedded nul bytes.
<!-- ##### FUNCTION g_string_sized_new ##### --> <!-- ##### FUNCTION g_string_sized_new ##### -->
<para> <para>
Creates a new #GString, with enough space for @dfl_size characters. Creates a new #GString, with enough space for @dfl_size bytes.
This is useful if you are going to add a lot of text to the string and This is useful if you are going to add a lot of text to the string and
don't want it to be reallocated too often. don't want it to be reallocated too often.
</para> </para>
@ -70,7 +70,7 @@ don't want it to be reallocated too often.
<!-- ##### FUNCTION g_string_assign ##### --> <!-- ##### FUNCTION g_string_assign ##### -->
<para> <para>
Copies the characters from a string into a #GString, destroying any previous Copies the bytes from a string into a #GString, destroying any previous
contents. It is rather like the standard strcpy() function, except that contents. It is rather like the standard strcpy() function, except that
you do not have to worry about having enough space to copy the string. you do not have to worry about having enough space to copy the string.
</para> </para>
@ -148,11 +148,11 @@ Adds a string onto the end of a #GString, expanding it if necessary.
<!-- ##### FUNCTION g_string_append_c ##### --> <!-- ##### FUNCTION g_string_append_c ##### -->
<para> <para>
Adds a character onto the end of a #GString, expanding it if necessary. Adds a byte onto the end of a #GString, expanding it if necessary.
</para> </para>
@string: a #GString. @string: a #GString.
@c: the character to append onto the end of the #GString. @c: the byte to append onto the end of the #GString.
@Returns: the #GString. @Returns: the #GString.
@ -190,11 +190,11 @@ Adds a string on to the start of a #GString, expanding it if necessary.
<!-- ##### FUNCTION g_string_prepend_c ##### --> <!-- ##### FUNCTION g_string_prepend_c ##### -->
<para> <para>
Adds a character onto the start of a #GString, expanding it if necessary. Adds a byte onto the start of a #GString, expanding it if necessary.
</para> </para>
@string: a #GString. @string: a #GString.
@c: the character to prepend on the start of the #GString. @c: the byte to prepend on the start of the #GString.
@Returns: the #GString. @Returns: the #GString.
@ -233,12 +233,12 @@ Inserts a copy of a string into a #GString, expanding it if necessary.
<!-- ##### FUNCTION g_string_insert_c ##### --> <!-- ##### FUNCTION g_string_insert_c ##### -->
<para> <para>
Inserts a character into a #GString, expanding it if necessary. Inserts a byte into a #GString, expanding it if necessary.
</para> </para>
@string: a #GString. @string: a #GString.
@pos: the position to insert the character. @pos: the position to insert the byte.
@c: the character to insert. @c: the byte to insert.
@Returns: the #GString. @Returns: the #GString.
@ -268,20 +268,20 @@ Inserts @len bytes of @val into @string at @pos. Because @len is provided, @val
<!-- ##### FUNCTION g_string_erase ##### --> <!-- ##### FUNCTION g_string_erase ##### -->
<para> <para>
Removes @len characters from a #GString, starting at position @pos. Removes @len bytes from a #GString, starting at position @pos.
The rest of the #GString is shifted down to fill the gap. The rest of the #GString is shifted down to fill the gap.
</para> </para>
@string: a #GString. @string: a #GString.
@pos: the position of the characters to remove. @pos: the position of the content to remove.
@len: the number of characters to remove, or -1 to remove all @len: the number of bytes to remove, or -1 to remove all
following characters. following bytes.
@Returns: the #GString. @Returns: the #GString.
<!-- ##### FUNCTION g_string_truncate ##### --> <!-- ##### FUNCTION g_string_truncate ##### -->
<para> <para>
Cuts off the end of the GString, leaving the first @len characters. Cuts off the end of the GString, leaving the first @len bytes.
</para> </para>
@string: a #GString. @string: a #GString.