From 296236288405ace8576bd6dfc4e3f1cfbde277f5 Mon Sep 17 00:00:00 2001
From: Jehan <jehan@girinstud.io>
Date: Sun, 12 Oct 2025 17:18:51 +0200
Subject: [PATCH] app, libgimp, pdb: fix markdown-like syntax.

We need 2 lines in the PDB for it to be an empty line in the C file,
which in turn will be interpreted as markdown-like lists for the
gi-docgen generated HTML docs.
---
 app/pdb/layer-cmds.c    | 1 +
 libgimp/gimplayer_pdb.c | 1 +
 pdb/groups/layer.pdb    | 1 +
 3 files changed, 3 insertions(+)

diff --git a/app/pdb/layer-cmds.c b/app/pdb/layer-cmds.c
index e27ce62082..fc8935c1ec 100644
--- a/app/pdb/layer-cmds.c
+++ b/app/pdb/layer-cmds.c
@@ -1605,6 +1605,7 @@ register_layer_procs (GimpPDB *pdb)
                                   "Create a layer mask for the specified layer.",
                                   "This procedure creates a layer mask for the specified layer.\n"
                                   "Layer masks serve as an additional alpha channel for a layer. Different types of masks are allowed for initialisation:\n"
+                                  "\n"
                                   "- white mask (leaves the layer fully visible);\n"
                                   "- black mask (gives the layer complete transparency);\n"
                                   "- the layer's alpha channel (either a copy, or a transfer, which leaves the layer fully visible, but which may be more useful than a white mask);\n"
diff --git a/libgimp/gimplayer_pdb.c b/libgimp/gimplayer_pdb.c
index 503e88238a..f5f63024c1 100644
--- a/libgimp/gimplayer_pdb.c
+++ b/libgimp/gimplayer_pdb.c
@@ -492,6 +492,7 @@ gimp_layer_set_offsets (GimpLayer *layer,
  * This procedure creates a layer mask for the specified layer.
  * Layer masks serve as an additional alpha channel for a layer.
  * Different types of masks are allowed for initialisation:
+ *
  * - white mask (leaves the layer fully visible);
  * - black mask (gives the layer complete transparency);
  * - the layer's alpha channel (either a copy, or a transfer, which
diff --git a/pdb/groups/layer.pdb b/pdb/groups/layer.pdb
index e0db0678b2..7c37babae8 100644
--- a/pdb/groups/layer.pdb
+++ b/pdb/groups/layer.pdb
@@ -293,6 +293,7 @@ This procedure creates a layer mask for the specified layer.
 Layer masks serve as an additional alpha channel for a layer. Different
 types of masks are allowed for initialisation:
 
+
 - white mask (leaves the layer fully visible);
 
 - black mask (gives the layer complete transparency);