docs: Move the GStringChunk SECTION

Move the contents to the struct docs.

Helps: #3037
This commit is contained in:
Matthias Clasen 2023-09-25 08:58:27 -04:00 committed by Philip Withnall
parent 57219c14a0
commit 5a2a0aeaf9

View File

@ -42,40 +42,33 @@
#include "gutilsprivate.h" #include "gutilsprivate.h"
/** /**
* SECTION:string_chunks * GStringChunk:
* @title: String Chunks *
* @short_description: efficient storage of groups of strings * `GStringChunk` provides efficient storage of groups of strings
* *
* String chunks are used to store groups of strings. Memory is * String chunks are used to store groups of strings. Memory is
* allocated in blocks, and as strings are added to the #GStringChunk * allocated in blocks, and as strings are added to the `GStringChunk`
* they are copied into the next free position in a block. When a block * they are copied into the next free position in a block. When a block
* is full a new block is allocated. * is full a new block is allocated.
* *
* When storing a large number of strings, string chunks are more * When storing a large number of strings, string chunks are more
* efficient than using g_strdup() since fewer calls to malloc() are * efficient than using [func@g_strdup] since fewer calls to `malloc()`
* needed, and less memory is wasted in memory allocation overheads. * are needed, and less memory is wasted in memory allocation overheads.
* *
* By adding strings with g_string_chunk_insert_const() it is also * By adding strings with [method@GLib.StringChunk.insert_const] it is also
* possible to remove duplicates. * possible to remove duplicates.
* *
* To create a new #GStringChunk use g_string_chunk_new(). * To create a new `GStringChunk` use [method@GLib.StringChunk.new].
* *
* To add strings to a #GStringChunk use g_string_chunk_insert(). * To add strings to a `GStringChunk` use [method@GLib.Stringchunk.insert].
* *
* To add strings to a #GStringChunk, but without duplicating strings * To add strings to a `GStringChunk`, but without duplicating strings
* which are already in the #GStringChunk, use * which are already in the `GStringChunk`, use [method@GLib.StringChunk.insert_const].
* g_string_chunk_insert_const().
* *
* To free the entire #GStringChunk use g_string_chunk_free(). It is * To free the entire `GStringChunk` use [method@GLib.Stringchunk.free].
* not possible to free individual strings. * It is not possible to free individual strings.
*/ */
/**
* GStringChunk:
*
* An opaque data structure representing String Chunks.
* It should only be accessed by using the following functions.
*/
struct _GStringChunk struct _GStringChunk
{ {
GHashTable *const_table; GHashTable *const_table;