diff --git a/app/pdb/file-cmds.c b/app/pdb/file-cmds.c index 6c1b89600d..8774fa5e67 100644 --- a/app/pdb/file-cmds.c +++ b/app/pdb/file-cmds.c @@ -419,7 +419,7 @@ register_file_procs (GimpPDB *pdb) "gimp-file-load"); gimp_procedure_set_static_help (procedure, "Loads an image file by invoking the right load handler.", - "This procedure invokes the correct file load handler using magic if possible, and falling back on the file's extension and/or prefix if not.", + "This procedure invokes the correct file load handler using magic if possible, and falling back on the file's extension and/or prefix if not. Note that the loaded image will be marked as dirty, which can be changed by calling [method@Gimp.Image.clean_all].", NULL); gimp_procedure_set_static_attribution (procedure, "Josh MacDonald", diff --git a/app/pdb/image-cmds.c b/app/pdb/image-cmds.c index a184f1503f..8a5b9148b6 100644 --- a/app/pdb/image-cmds.c +++ b/app/pdb/image-cmds.c @@ -4658,7 +4658,7 @@ register_image_procs (GimpPDB *pdb) "gimp-image-is-dirty"); gimp_procedure_set_static_help (procedure, "Checks if the image has unsaved changes.", - "This procedure checks the specified image's dirty count to see if it needs to be saved. Note that saving the image does not automatically set the dirty count to 0, you need to call 'gimp-image-clean-all' after calling a save procedure to make the image clean.", + "This procedure checks the specified image's dirty count to see if it needs to be saved. Note that saving the image does not automatically set the dirty count to 0, you need to call [method@Gimp.Image.clean_all] after calling a save procedure to make the image clean. When loading an image using e.g. [func@Gimp.file_load] the image will be marked as dirty too.", NULL); gimp_procedure_set_static_attribution (procedure, "Spencer Kimball & Peter Mattis", diff --git a/libgimp/gimpfile_pdb.c b/libgimp/gimpfile_pdb.c index 0efcb6292d..2f580a4ef4 100644 --- a/libgimp/gimpfile_pdb.c +++ b/libgimp/gimpfile_pdb.c @@ -45,7 +45,8 @@ * * This procedure invokes the correct file load handler using magic if * possible, and falling back on the file's extension and/or prefix if - * not. + * not. Note that the loaded image will be marked as dirty, which can + * be changed by calling [method@Gimp.Image.clean_all]. * * Returns: (transfer none): The output image. **/ diff --git a/libgimp/gimpimage_pdb.c b/libgimp/gimpimage_pdb.c index f204c047d9..ff656ff6b7 100644 --- a/libgimp/gimpimage_pdb.c +++ b/libgimp/gimpimage_pdb.c @@ -2075,8 +2075,10 @@ gimp_image_clean_all (GimpImage *image) * * This procedure checks the specified image's dirty count to see if it * needs to be saved. Note that saving the image does not automatically - * set the dirty count to 0, you need to call gimp_image_clean_all() - * after calling a save procedure to make the image clean. + * set the dirty count to 0, you need to call + * [method@Gimp.Image.clean_all] after calling a save procedure to make + * the image clean. When loading an image using e.g. + * [func@Gimp.file_load] the image will be marked as dirty too. * * Returns: TRUE if the image has unsaved changes. **/ diff --git a/pdb/groups/file.pdb b/pdb/groups/file.pdb index 25d49e88b8..f3117be060 100644 --- a/pdb/groups/file.pdb +++ b/pdb/groups/file.pdb @@ -23,7 +23,8 @@ sub file_load { $help = <<'HELP'; This procedure invokes the correct file load handler using magic if possible, and falling back on the file's extension and/or prefix if -not. +not. Note that the loaded image will be marked as dirty, which can be +changed by calling [method@Gimp.Image.clean_all]. HELP &josh_pdb_misc('1997'); diff --git a/pdb/groups/image.pdb b/pdb/groups/image.pdb index ef1c5f98f4..5521de3f7d 100644 --- a/pdb/groups/image.pdb +++ b/pdb/groups/image.pdb @@ -1795,8 +1795,9 @@ sub image_is_dirty { $help = <<'HELP'; This procedure checks the specified image's dirty count to see if it needs to be saved. Note that saving the image does not automatically -set the dirty count to 0, you need to call gimp_image_clean_all() after -calling a save procedure to make the image clean. +set the dirty count to 0, you need to call [method@Gimp.Image.clean_all] after +calling a save procedure to make the image clean. When loading an image using +e.g. [func@Gimp.file_load] the image will be marked as dirty too. HELP &std_pdb_misc;