pdb: deprecate the drawable and vectors parasite APIs

This commit is contained in:
Michael Natterer 2010-07-09 10:36:17 +02:00
parent d0c80bae12
commit 7314d3fe4f
4 changed files with 49 additions and 98 deletions

View File

@ -967,12 +967,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-drawable-parasite-find");
gimp_procedure_set_static_strings (procedure,
"gimp-drawable-parasite-find",
"Look up a parasite in a drawable",
"Finds and returns the parasite that was previously attached to a drawable.",
"This procedure is deprecated! Use 'gimp-item-parasite-find' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-find' instead.",
"Jay Cox",
"Jay Cox",
"1998",
NULL);
"gimp-item-parasite-find");
gimp_procedure_add_argument (procedure,
gimp_param_spec_drawable_id ("drawable",
"drawable",
@ -1002,12 +1002,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-drawable-parasite-attach");
gimp_procedure_set_static_strings (procedure,
"gimp-drawable-parasite-attach",
"Add a parasite to a drawable.",
"This procedure attaches a parasite to a drawable. It has no return values.",
"This procedure is deprecated! Use 'gimp-item-parasite-attach' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-attach' instead.",
"Jay Cox",
"Jay Cox",
"1998",
NULL);
"gimp-item-parasite-attach");
gimp_procedure_add_argument (procedure,
gimp_param_spec_drawable_id ("drawable",
"drawable",
@ -1030,12 +1030,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-drawable-parasite-detach");
gimp_procedure_set_static_strings (procedure,
"gimp-drawable-parasite-detach",
"Removes a parasite from a drawable.",
"This procedure detaches a parasite from a drawable. It has no return values.",
"This procedure is deprecated! Use 'gimp-item-parasite-detach' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-detach' instead.",
"Jay Cox",
"Jay Cox",
"1998",
NULL);
"gimp-item-parasite-detach");
gimp_procedure_add_argument (procedure,
gimp_param_spec_drawable_id ("drawable",
"drawable",
@ -1060,12 +1060,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-drawable-parasite-list");
gimp_procedure_set_static_strings (procedure,
"gimp-drawable-parasite-list",
"List all parasites.",
"Returns a list of all currently attached parasites.",
"This procedure is deprecated! Use 'gimp-item-parasite-list' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-list' instead.",
"Marc Lehmann",
"Marc Lehmann",
"1999",
NULL);
"gimp-item-parasite-list");
gimp_procedure_add_argument (procedure,
gimp_param_spec_drawable_id ("drawable",
"drawable",
@ -1094,12 +1094,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-vectors-parasite-find");
gimp_procedure_set_static_strings (procedure,
"gimp-vectors-parasite-find",
"Look up a parasite in a vectors object",
"Finds and returns the parasite that was previously attached to a vectors object.",
"This procedure is deprecated! Use 'gimp-item-parasite-find' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-find' instead.",
"Michael Natterer <mitch@gimp.org>",
"Michael Natterer",
"2006",
NULL);
"gimp-item-parasite-find");
gimp_procedure_add_argument (procedure,
gimp_param_spec_vectors_id ("vectors",
"vectors",
@ -1129,12 +1129,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-vectors-parasite-attach");
gimp_procedure_set_static_strings (procedure,
"gimp-vectors-parasite-attach",
"Add a parasite to a vectors object",
"This procedure attaches a parasite to a vectors object. It has no return values.",
"This procedure is deprecated! Use 'gimp-item-parasite-attach' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-attach' instead.",
"Michael Natterer <mitch@gimp.org>",
"Michael Natterer",
"2006",
NULL);
"gimp-item-parasite-attach");
gimp_procedure_add_argument (procedure,
gimp_param_spec_vectors_id ("vectors",
"vectors",
@ -1157,12 +1157,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-vectors-parasite-detach");
gimp_procedure_set_static_strings (procedure,
"gimp-vectors-parasite-detach",
"Removes a parasite from a vectors object",
"This procedure detaches a parasite from a vectors object. It has no return values.",
"This procedure is deprecated! Use 'gimp-item-parasite-detach' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-detach' instead.",
"Michael Natterer <mitch@gimp.org>",
"Michael Natterer",
"2006",
NULL);
"gimp-item-parasite-detach");
gimp_procedure_add_argument (procedure,
gimp_param_spec_vectors_id ("vectors",
"vectors",
@ -1187,12 +1187,12 @@ register_parasite_procs (GimpPDB *pdb)
"gimp-vectors-parasite-list");
gimp_procedure_set_static_strings (procedure,
"gimp-vectors-parasite-list",
"List all parasites.",
"Returns a list of all currently attached parasites.",
"This procedure is deprecated! Use 'gimp-item-parasite-list' instead.",
"This procedure is deprecated! Use 'gimp-item-parasite-list' instead.",
"Michael Natterer <mitch@gimp.org>",
"Michael Natterer",
"2006",
NULL);
"gimp-item-parasite-list");
gimp_procedure_add_argument (procedure,
gimp_param_spec_vectors_id ("vectors",
"vectors",

View File

@ -23,6 +23,9 @@
#include "config.h"
#include "gimp.h"
#undef GIMP_DISABLE_DEPRECATED
#undef __GIMP_PARASITE_PDB_H__
#include "gimpparasite_pdb.h"
/**
@ -467,10 +470,7 @@ gimp_item_parasite_list (gint32 item_ID,
* @drawable_ID: The drawable.
* @name: The name of the parasite to find.
*
* Look up a parasite in a drawable
*
* Finds and returns the parasite that was previously attached to a
* drawable.
* This procedure is deprecated! Use gimp_item_parasite_find() instead.
*
* Returns: The found parasite.
*/
@ -501,10 +501,8 @@ gimp_drawable_parasite_find (gint32 drawable_ID,
* @drawable_ID: The drawable.
* @parasite: The parasite to attach to a drawable.
*
* Add a parasite to a drawable.
*
* This procedure attaches a parasite to a drawable. It has no return
* values.
* This procedure is deprecated! Use gimp_item_parasite_attach()
* instead.
*
* Returns: TRUE on success.
*/
@ -534,10 +532,8 @@ gimp_drawable_parasite_attach (gint32 drawable_ID,
* @drawable_ID: The drawable.
* @name: The name of the parasite to detach from a drawable.
*
* Removes a parasite from a drawable.
*
* This procedure detaches a parasite from a drawable. It has no return
* values.
* This procedure is deprecated! Use gimp_item_parasite_detach()
* instead.
*
* Returns: TRUE on success.
*/
@ -568,9 +564,7 @@ gimp_drawable_parasite_detach (gint32 drawable_ID,
* @num_parasites: The number of attached parasites.
* @parasites: The names of currently attached parasites.
*
* List all parasites.
*
* Returns a list of all currently attached parasites.
* This procedure is deprecated! Use gimp_item_parasite_list() instead.
*
* Returns: TRUE on success.
*/
@ -612,10 +606,7 @@ gimp_drawable_parasite_list (gint32 drawable_ID,
* @vectors_ID: The vectors object.
* @name: The name of the parasite to find.
*
* Look up a parasite in a vectors object
*
* Finds and returns the parasite that was previously attached to a
* vectors object.
* This procedure is deprecated! Use gimp_item_parasite_find() instead.
*
* Returns: The found parasite.
*
@ -648,10 +639,8 @@ gimp_vectors_parasite_find (gint32 vectors_ID,
* @vectors_ID: The vectors object.
* @parasite: The parasite to attach to a vectors object.
*
* Add a parasite to a vectors object
*
* This procedure attaches a parasite to a vectors object. It has no
* return values.
* This procedure is deprecated! Use gimp_item_parasite_attach()
* instead.
*
* Returns: TRUE on success.
*
@ -683,10 +672,8 @@ gimp_vectors_parasite_attach (gint32 vectors_ID,
* @vectors_ID: The vectors object.
* @name: The name of the parasite to detach from a vectors object.
*
* Removes a parasite from a vectors object
*
* This procedure detaches a parasite from a vectors object. It has no
* return values.
* This procedure is deprecated! Use gimp_item_parasite_detach()
* instead.
*
* Returns: TRUE on success.
*
@ -719,9 +706,7 @@ gimp_vectors_parasite_detach (gint32 vectors_ID,
* @num_parasites: The number of attached parasites.
* @parasites: The names of currently attached parasites.
*
* List all parasites.
*
* Returns a list of all currently attached parasites.
* This procedure is deprecated! Use gimp_item_parasite_list() instead.
*
* Returns: TRUE on success.
*

View File

@ -51,6 +51,7 @@ gboolean gimp_item_parasite_detach (gint32 item_ID,
gboolean gimp_item_parasite_list (gint32 item_ID,
gint *num_parasites,
gchar ***parasites);
#ifndef GIMP_DISABLE_DEPRECATED
GimpParasite* gimp_drawable_parasite_find (gint32 drawable_ID,
const gchar *name);
gboolean gimp_drawable_parasite_attach (gint32 drawable_ID,
@ -69,6 +70,7 @@ gboolean gimp_vectors_parasite_detach (gint32 vectors_ID,
gboolean gimp_vectors_parasite_list (gint32 vectors_ID,
gint *num_parasites,
gchar ***parasites);
#endif /* GIMP_DISABLE_DEPRECATED */
G_END_DECLS

View File

@ -333,12 +333,7 @@ CODE
}
sub drawable_parasite_find {
$blurb = 'Look up a parasite in a drawable';
$help = <<'HELP';
Finds and returns the parasite that was previously attached to a drawable.
HELP
&std_pdb_deprecated ('gimp-item-parasite-find');
&jay_pdb_misc('1998');
@inargs = (
@ -367,12 +362,7 @@ CODE
}
sub drawable_parasite_attach {
$blurb = 'Add a parasite to a drawable.';
$help = <<'HELP';
This procedure attaches a parasite to a drawable. It has no return values.
HELP
&std_pdb_deprecated ('gimp-item-parasite-attach');
&jay_pdb_misc('1998');
@inargs = (
@ -392,12 +382,7 @@ CODE
}
sub drawable_parasite_detach {
$blurb = 'Removes a parasite from a drawable.';
$help = <<'HELP';
This procedure detaches a parasite from a drawable. It has no return values.
HELP
&std_pdb_deprecated ('gimp-item-parasite-detach');
&jay_pdb_misc('1998');
@inargs = (
@ -417,9 +402,7 @@ CODE
}
sub drawable_parasite_list {
$blurb = 'List all parasites.';
$help = 'Returns a list of all currently attached parasites.';
&std_pdb_deprecated ('gimp-item-parasite-list');
&marc_pdb_misc('1999');
@inargs = (
@ -443,13 +426,7 @@ CODE
}
sub vectors_parasite_find {
$blurb = 'Look up a parasite in a vectors object';
$help = <<'HELP';
Finds and returns the parasite that was previously attached
to a vectors object.
HELP
&std_pdb_deprecated ('gimp-item-parasite-find');
&mitch_pdb_misc('2006', '2.4');
@inargs = (
@ -478,12 +455,7 @@ CODE
}
sub vectors_parasite_attach {
$blurb = 'Add a parasite to a vectors object';
$help = <<'HELP';
This procedure attaches a parasite to a vectors object. It has no return values.
HELP
&std_pdb_deprecated ('gimp-item-parasite-attach');
&mitch_pdb_misc('2006', '2.4');
@inargs = (
@ -503,13 +475,7 @@ CODE
}
sub vectors_parasite_detach {
$blurb = 'Removes a parasite from a vectors object';
$help = <<'HELP';
This procedure detaches a parasite from a vectors object.
It has no return values.
HELP
&std_pdb_deprecated ('gimp-item-parasite-detach');
&mitch_pdb_misc('2006', '2.4');
@inargs = (
@ -529,9 +495,7 @@ CODE
}
sub vectors_parasite_list {
$blurb = 'List all parasites.';
$help = 'Returns a list of all currently attached parasites.';
&std_pdb_deprecated ('gimp-item-parasite-list');
&mitch_pdb_misc('2006', '2.4');
@inargs = (