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_procedure_set_static_help (procedure,
"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);
gimp_procedure_set_static_attribution (procedure,
"Spencer Kimball & Peter Mattis",
@ -707,7 +708,9 @@ register_edit_procs (GimpPDB *pdb)
"gimp-edit-copy");
gimp_procedure_set_static_help (procedure,
"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);
gimp_procedure_set_static_attribution (procedure,
"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
* 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.
* its contents stored in the internal GIMP edit buffer.
* 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.
*
* 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
* 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
* edit buffer.
* 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.
* nothing to copy from.
* All the drawables must belong to the same image.
*
* 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
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.
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
&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
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.
buffer.
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.
HELP