From 0fe66771dad1787e3331803f65f335e8fe9b1ec4 Mon Sep 17 00:00:00 2001 From: Jehan Date: Tue, 27 Aug 2024 00:24:26 +0200 Subject: [PATCH] app, libgimp, pdb: fixing broken GIR links. The 'help' field needs to be single-quoted so that @-values do not look like perl variables, hence breaking GIR annotations. Fixing: > Possible unintended interpolation of @Gimp in string at /home/jehan/dev/src/gimp/pdb/groups/item.pdb line 64. --- app/pdb/item-cmds.c | 12 ++++++------ libgimp/gimpitem_pdb.c | 16 ++++++++-------- pdb/groups/item.pdb | 22 +++++++++++----------- 3 files changed, 25 insertions(+), 25 deletions(-) diff --git a/app/pdb/item-cmds.c b/app/pdb/item-cmds.c index 8bd834dbed..8108f09351 100644 --- a/app/pdb/item-cmds.c +++ b/app/pdb/item-cmds.c @@ -1102,7 +1102,7 @@ register_item_procs (GimpPDB *pdb) "Returns whether the item ID is a drawable.", "This procedure returns %TRUE if the specified item ID is a drawable.\n" "\n" - "*Note*: in most use cases, you should not use this function. See [func.Item.id_is_layer] for a discussion on alternatives.", + "*Note*: in most use cases, you should not use this function. See [func@Gimp.Item.id_is_layer] for a discussion on alternatives.", NULL); gimp_procedure_set_static_attribution (procedure, "Spencer Kimball & Peter Mattis", @@ -1133,7 +1133,7 @@ register_item_procs (GimpPDB *pdb) "Returns whether the item ID is a layer.", "This procedure returns %TRUE if the specified item ID is a layer.\n" "\n" - "*Note*: in most use cases, you should not use this function. If the goal is to verify the accurate type for a [class.Item], you should either use [method.Item.is_layer] or the specific type-checking methods for the used language.\n" + "*Note*: in most use cases, you should not use this function. If the goal is to verify the accurate type for a [class@Gimp.Item], you should either use [method@Gimp.Item.is_layer] or the specific type-checking methods for the used language.\n" "For instance, in C:\n" "```C\n" "if (GIMP_IS_LAYER (item))\n" @@ -1236,7 +1236,7 @@ register_item_procs (GimpPDB *pdb) "Returns whether the item ID is a channel.", "This procedure returns %TRUE if the specified item ID is a channel.\n" "\n" - "*Note*: in most use cases, you should not use this function. See [func.Item.id_is_layer] for a discussion on alternatives.", + "*Note*: in most use cases, you should not use this function. See [func@Gimp.Item.id_is_layer] for a discussion on alternatives.", NULL); gimp_procedure_set_static_attribution (procedure, "Spencer Kimball & Peter Mattis", @@ -1267,7 +1267,7 @@ register_item_procs (GimpPDB *pdb) "Returns whether the item ID is a layer mask.", "This procedure returns %TRUE if the specified item ID is a layer mask.\n" "\n" - "*Note*: in most use cases, you should not use this function. See [func.Item.id_is_layer] for a discussion on alternatives.", + "*Note*: in most use cases, you should not use this function. See [func@Gimp.Item.id_is_layer] for a discussion on alternatives.", NULL); gimp_procedure_set_static_attribution (procedure, "Spencer Kimball & Peter Mattis", @@ -1298,7 +1298,7 @@ register_item_procs (GimpPDB *pdb) "Returns whether the item ID is a path.", "This procedure returns %TRUE if the specified item ID is a path.\n" "\n" - "*Note*: in most use cases, you should not use this function. See [func.Item.id_is_layer] for a discussion on alternatives.", + "*Note*: in most use cases, you should not use this function. See [func@Gimp.Item.id_is_layer] for a discussion on alternatives.", NULL); gimp_procedure_set_static_attribution (procedure, "Spencer Kimball & Peter Mattis", @@ -1329,7 +1329,7 @@ register_item_procs (GimpPDB *pdb) "Returns whether the item ID is a selection.", "This procedure returns %TRUE if the specified item ID is a selection.\n" "\n" - "*Note*: in most use cases, you should not use this function. See [func.Item.id_is_layer] for a discussion on alternatives.", + "*Note*: in most use cases, you should not use this function. See [func@Gimp.Item.id_is_layer] for a discussion on alternatives.", NULL); gimp_procedure_set_static_attribution (procedure, "Spencer Kimball & Peter Mattis", diff --git a/libgimp/gimpitem_pdb.c b/libgimp/gimpitem_pdb.c index d23dc2c0da..8ae4b7d92f 100644 --- a/libgimp/gimpitem_pdb.c +++ b/libgimp/gimpitem_pdb.c @@ -86,7 +86,7 @@ gimp_item_id_is_valid (gint item_id) * This procedure returns %TRUE if the specified item ID is a drawable. * * *Note*: in most use cases, you should not use this function. See - * [func.Item.id_is_layer] for a discussion on alternatives. + * [func@Gimp.Item.id_is_layer] for a discussion on alternatives. * * Returns: TRUE if the item ID is a drawable, FALSE otherwise. * @@ -125,9 +125,9 @@ gimp_item_id_is_drawable (gint item_id) * This procedure returns %TRUE if the specified item ID is a layer. * * *Note*: in most use cases, you should not use this function. If the - * goal is to verify the accurate type for a [class.Item], you should - * either use [method.Item.is_layer] or the specific type-checking - * methods for the used language. + * goal is to verify the accurate type for a [class@Gimp.Item], you + * should either use [method@Gimp.Item.is_layer] or the specific + * type-checking methods for the used language. * For instance, in C: * ```C * if (GIMP_IS_LAYER (item)) @@ -256,7 +256,7 @@ gimp_item_id_is_group_layer (gint item_id) * This procedure returns %TRUE if the specified item ID is a channel. * * *Note*: in most use cases, you should not use this function. See - * [func.Item.id_is_layer] for a discussion on alternatives. + * [func@Gimp.Item.id_is_layer] for a discussion on alternatives. * * Returns: TRUE if the item ID is a channel, FALSE otherwise. * @@ -296,7 +296,7 @@ gimp_item_id_is_channel (gint item_id) * mask. * * *Note*: in most use cases, you should not use this function. See - * [func.Item.id_is_layer] for a discussion on alternatives. + * [func@Gimp.Item.id_is_layer] for a discussion on alternatives. * * Returns: TRUE if the item ID is a layer mask, FALSE otherwise. * @@ -335,7 +335,7 @@ gimp_item_id_is_layer_mask (gint item_id) * This procedure returns %TRUE if the specified item ID is a path. * * *Note*: in most use cases, you should not use this function. See - * [func.Item.id_is_layer] for a discussion on alternatives. + * [func@Gimp.Item.id_is_layer] for a discussion on alternatives. * * Returns: TRUE if the item ID is a path, FALSE otherwise. * @@ -375,7 +375,7 @@ gimp_item_id_is_path (gint item_id) * selection. * * *Note*: in most use cases, you should not use this function. See - * [func.Item.id_is_layer] for a discussion on alternatives. + * [func@Gimp.Item.id_is_layer] for a discussion on alternatives. * * Returns: TRUE if the item ID is a selection, FALSE otherwise. * diff --git a/pdb/groups/item.pdb b/pdb/groups/item.pdb index 3657f23c98..5f9df3d7cd 100644 --- a/pdb/groups/item.pdb +++ b/pdb/groups/item.pdb @@ -56,7 +56,7 @@ CODE sub item_id_is_drawable { $blurb = 'Returns whether the item ID is a drawable.'; - $help = <