From cff415f221fd009b9c8287707601656624a98bcc Mon Sep 17 00:00:00 2001
From: Zander Brown <zbrown@gnome.org>
Date: Sun, 4 May 2025 17:41:11 +0100
Subject: [PATCH] gallocator: mark as deprecated
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

These show up in various places in docgen-based docs, including in
results for fairly common searches (such as ‘alloc’). Whilst people
should have been scared off by these being undocumented, the red
deprecated tags make it clear these shouldn't be touched.
---
 glib/deprecated/gallocator.c | 162 +++++++++++++++++++++++++++++++++++
 1 file changed, 162 insertions(+)

diff --git a/glib/deprecated/gallocator.c b/glib/deprecated/gallocator.c
index 344e98797..ed8463869 100644
--- a/glib/deprecated/gallocator.c
+++ b/glib/deprecated/gallocator.c
@@ -25,10 +25,80 @@
 #include <glib/gmessages.h>
 #include <glib/gslice.h>
 
+/**
+ * GAllocator:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * G_ALLOC_ONLY:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * G_ALLOC_AND_FREE:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * G_ALLOCATOR_LIST:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * G_ALLOCATOR_SLIST:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * G_ALLOCATOR_NODE:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * g_chunk_new:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * g_chunk_new0:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * g_chunk_free:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * g_mem_chunk_create:
+ *
+ * Deprecated: 2.10
+ */
+
+/**
+ * GMemChunk:
+ *
+ * Deprecated: 2.10
+ */
 struct _GMemChunk {
   guint alloc_size;           /* the size of an atom */
 };
 
+/**
+ * g_mem_chunk_new:
+ *
+ * Deprecated: 2.10
+ */
 GMemChunk*
 g_mem_chunk_new (const gchar *name,
                  gint         atom_size,
@@ -45,6 +115,11 @@ g_mem_chunk_new (const gchar *name,
   return mem_chunk;
 }
 
+/**
+ * g_mem_chunk_destroy:
+ *
+ * Deprecated: 2.10
+ */
 void
 g_mem_chunk_destroy (GMemChunk *mem_chunk)
 {
@@ -53,6 +128,11 @@ g_mem_chunk_destroy (GMemChunk *mem_chunk)
   g_slice_free (GMemChunk, mem_chunk);
 }
 
+/**
+ * g_mem_chunk_alloc:
+ *
+ * Deprecated: 2.10
+ */
 gpointer
 g_mem_chunk_alloc (GMemChunk *mem_chunk)
 {
@@ -61,6 +141,11 @@ g_mem_chunk_alloc (GMemChunk *mem_chunk)
   return g_slice_alloc (mem_chunk->alloc_size);
 }
 
+/**
+ * g_mem_chunk_alloc0:
+ *
+ * Deprecated: 2.10
+ */
 gpointer
 g_mem_chunk_alloc0 (GMemChunk *mem_chunk)
 {
@@ -69,6 +154,11 @@ g_mem_chunk_alloc0 (GMemChunk *mem_chunk)
   return g_slice_alloc0 (mem_chunk->alloc_size);
 }
 
+/**
+ * g_mem_chunk_free:
+ *
+ * Deprecated: 2.10
+ */
 void
 g_mem_chunk_free (GMemChunk *mem_chunk,
                   gpointer   mem)
@@ -78,6 +168,11 @@ g_mem_chunk_free (GMemChunk *mem_chunk,
   g_slice_free1 (mem_chunk->alloc_size, mem);
 }
 
+/**
+ * g_allocator_new:
+ *
+ * Deprecated: 2.10
+ */
 GAllocator*
 g_allocator_new (const gchar *name,
                  guint        n_preallocs)
@@ -86,19 +181,86 @@ g_allocator_new (const gchar *name,
   return (void *) 1;
 }
 
+/**
+ * g_allocator_free:
+ *
+ * Deprecated: 2.10
+ */
 void g_allocator_free           (GAllocator *allocator) { }
 
+/**
+ * g_mem_chunk_clean:
+ *
+ * Deprecated: 2.10
+ */
 void g_mem_chunk_clean          (GMemChunk *mem_chunk)  { }
+
+/**
+ * g_mem_chunk_reset:
+ *
+ * Deprecated: 2.10
+ */
 void g_mem_chunk_reset          (GMemChunk *mem_chunk)  { }
+
+/**
+ * g_mem_chunk_print:
+ *
+ * Deprecated: 2.10
+ */
 void g_mem_chunk_print          (GMemChunk *mem_chunk)  { }
+
+/**
+ * g_mem_chunk_info:
+ *
+ * Deprecated: 2.10
+ */
 void g_mem_chunk_info           (void)                  { }
+
+/**
+ * g_blow_chunks:
+ *
+ * Deprecated: 2.10
+ */
 void g_blow_chunks              (void)                  { }
 
+/**
+ * g_list_push_allocator:
+ *
+ * Deprecated: 2.10
+ */
 void g_list_push_allocator      (GAllocator *allocator) { }
+
+/**
+ * g_list_pop_allocator:
+ *
+ * Deprecated: 2.10
+ */
 void g_list_pop_allocator       (void)                  { }
 
+/**
+ * g_slist_push_allocator:
+ *
+ * Deprecated: 2.10
+ */
 void g_slist_push_allocator     (GAllocator *allocator) { }
+
+/**
+ * g_slist_pop_allocator:
+ *
+ * Deprecated: 2.10
+ */
 void g_slist_pop_allocator      (void)                  { }
 
+/**
+ * g_node_push_allocator:
+ *
+ * Deprecated: 2.10
+ */
 void g_node_push_allocator      (GAllocator *allocator) { }
+
+/**
+ * g_node_pop_allocator:
+ *
+ * Deprecated: 2.10
+ */
 void g_node_pop_allocator       (void)                  { }