dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

app, libgimp, pdb: also tweak a bit gimp_edit_copy|cut() docs per… 

… Lloyd comment in #10471.
This commit is contained in:
Jehan 2024-08-09 20:10:06 +02:00
parent 471a92e5ed
commit d5ff0360b1
3 changed files with 23 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
app/pdb/edit-cmds.c
View File

@ -672,7 +672,8 @@ register_edit_procs (GimpPDB *pdb)
"gimp-edit-cut"); "gimp-edit-cut");
gimp_procedure_set_static_help (procedure, gimp_procedure_set_static_help (procedure,
"Cut from the specified drawables.", "Cut from the specified drawables.",
"If there is a selection in the image, then the area specified by the selection is cut from the specified drawables and placed in an internal GIMP edit buffer. It can subsequently be retrieved using the 'gimp-edit-paste' command. If there is no selection and only one specified drawable, then the specified drawable will be removed and its contents stored in the internal GIMP edit buffer. This procedure will fail if the selected area lies completely outside the bounds of the current drawables and there is nothing to cut from.", "If there is a selection in the image, then the area specified by the selection is cut from the specified drawables and placed in an internal GIMP edit buffer. It can subsequently be retrieved using the 'gimp-edit-paste' command. If there is no selection and only one specified drawable, then the specified drawable will be removed and its contents stored in the internal GIMP edit buffer.\n"
"This procedure will return %FALSE if the selected area lies completely outside the bounds of the current drawables and there is nothing to cut from.",
NULL); NULL);
gimp_procedure_set_static_attribution (procedure, gimp_procedure_set_static_attribution (procedure,
"Spencer Kimball & Peter Mattis", "Spencer Kimball & Peter Mattis",
@ -707,7 +708,9 @@ register_edit_procs (GimpPDB *pdb)
"gimp-edit-copy"); "gimp-edit-copy");
gimp_procedure_set_static_help (procedure, gimp_procedure_set_static_help (procedure,
"Copy from the specified drawables.", "Copy from the specified drawables.",
"If there is a selection in the image, then the area specified by the selection is copied from the specified drawables and placed in an internal GIMP edit buffer. It can subsequently be retrieved using the 'gimp-edit-paste' command. If there is no selection, then the specified drawables' contents will be stored in the internal GIMP edit buffer. This procedure will fail if the selected area lies completely outside the bounds of the current drawables and there is nothing to copy from. All the drawables must belong to the same image.", "If there is a selection in the image, then the area specified by the selection is copied from the specified drawables and placed in an internal GIMP edit buffer. It can subsequently be retrieved using the 'gimp-edit-paste' command. If there is no selection, then the specified drawables' contents will be stored in the internal GIMP edit buffer.\n"
"This procedure will return %FALSE if the selected area lies completely outside the bounds of the current drawables and there is nothing to copy from.\n"
"All the drawables must belong to the same image.",
NULL); NULL);
gimp_procedure_set_static_attribution (procedure, gimp_procedure_set_static_attribution (procedure,
"Spencer Kimball & Peter Mattis", "Spencer Kimball & Peter Mattis",

14
libgimp/gimpedit_pdb.c
View File

@ -48,9 +48,10 @@
* internal GIMP edit buffer. It can subsequently be retrieved using * internal GIMP edit buffer. It can subsequently be retrieved using
* the gimp_edit_paste() command. If there is no selection and only one * the gimp_edit_paste() command. If there is no selection and only one
* specified drawable, then the specified drawable will be removed and * specified drawable, then the specified drawable will be removed and
* its contents stored in the internal GIMP edit buffer. This procedure * its contents stored in the internal GIMP edit buffer.
* will fail if the selected area lies completely outside the bounds of * This procedure will return %FALSE if the selected area lies
* the current drawables and there is nothing to cut from. * completely outside the bounds of the current drawables and there is
* nothing to cut from.
* *
* Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from. * Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from.
**/ **/
@ -93,10 +94,11 @@ gimp_edit_cut (gint num_drawables,
* internal GIMP edit buffer. It can subsequently be retrieved using * internal GIMP edit buffer. It can subsequently be retrieved using
* the gimp_edit_paste() command. If there is no selection, then the * the gimp_edit_paste() command. If there is no selection, then the
* specified drawables' contents will be stored in the internal GIMP * specified drawables' contents will be stored in the internal GIMP
* edit buffer. This procedure will fail if the selected area lies * edit buffer.
* This procedure will return %FALSE if the selected area lies
* completely outside the bounds of the current drawables and there is * completely outside the bounds of the current drawables and there is
* nothing to copy from. All the drawables must belong to the same * nothing to copy from.
* image. * All the drawables must belong to the same image.
* *
* Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from. * Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from.
**/ **/

15
pdb/groups/edit.pdb
View File

@ -26,8 +26,10 @@ GIMP edit buffer. It can subsequently be retrieved using the
gimp_edit_paste() command. If there is no selection and only one gimp_edit_paste() command. If there is no selection and only one
specified drawable, then the specified drawable will be removed and its specified drawable, then the specified drawable will be removed and its
contents stored in the internal GIMP edit buffer. contents stored in the internal GIMP edit buffer.
This procedure will fail if the selected area lies completely outside
the bounds of the current drawables and there is nothing to cut from. This procedure will return %FALSE if the selected area lies completely
outside the bounds of the current drawables and there is nothing to cut
from.
HELP HELP
&std_pdb_misc; &std_pdb_misc;
@ -113,9 +115,12 @@ selection is copied from the specified drawables and placed in an
internal GIMP edit buffer. It can subsequently be retrieved using the internal GIMP edit buffer. It can subsequently be retrieved using the
gimp_edit_paste() command. If there is no selection, then the gimp_edit_paste() command. If there is no selection, then the
specified drawables' contents will be stored in the internal GIMP edit specified drawables' contents will be stored in the internal GIMP edit
buffer. This procedure will fail if the selected area lies completely buffer.
outside the bounds of the current drawables and there is nothing to
copy from. This procedure will return %FALSE if the selected area lies
completely outside the bounds of the current drawables and there is
nothing to copy from.
All the drawables must belong to the same image. All the drawables must belong to the same image.
HELP HELP