summaryrefslogtreecommitdiff
path: root/src/libical/icalproperty.h
diff options
context:
space:
mode:
authorEmiel Bruijntjes <emiel.bruijntjes@copernica.com>2019-05-26 10:16:10 -0400
committerAllen Winter <allen.winter@kdab.com>2019-05-26 10:18:32 -0400
commit7dc9a9674120fa8be2fc33e627211b515475207f (patch)
tree8a02d6cd2c0d25c7bdf807e2cd0205447e60d540 /src/libical/icalproperty.h
parentd101b1798dfab5aa6730e63424156453f859f114 (diff)
downloadlibical-git-7dc9a9674120fa8be2fc33e627211b515475207f.tar.gz
Deprecate foo_new_clone() in favor of foo_clone()
Consistency between const and non-const args for clone functions
Diffstat (limited to 'src/libical/icalproperty.h')
-rw-r--r--src/libical/icalproperty.h14
1 files changed, 13 insertions, 1 deletions
diff --git a/src/libical/icalproperty.h b/src/libical/icalproperty.h
index 70daba98..210b0c81 100644
--- a/src/libical/icalproperty.h
+++ b/src/libical/icalproperty.h
@@ -20,6 +20,7 @@
#ifndef ICALPROPERTY_H
#define ICALPROPERTY_H
+#include "libical_deprecated.h"
#include "libical_ical_export.h"
#include "icalderivedproperty.h" /* To get icalproperty_kind enumerations */
@@ -29,7 +30,12 @@ LIBICAL_ICAL_EXPORT icalproperty *icalproperty_new(icalproperty_kind kind);
LIBICAL_ICAL_EXPORT icalproperty *icalproperty_new_impl(icalproperty_kind kind);
-LIBICAL_ICAL_EXPORT icalproperty *icalproperty_new_clone(icalproperty *prop);
+/**
+ * Deeply clone an icalproperty.
+ * Returns a pointer to the memory for the newly cloned icalproperty.
+ * @since 3.1.0
+ */
+LIBICAL_ICAL_EXPORT icalproperty *icalproperty_clone(const icalproperty *prop);
LIBICAL_ICAL_EXPORT icalproperty *icalproperty_new_from_string(const char *str);
@@ -147,4 +153,10 @@ LIBICAL_ICAL_EXPORT int icalproperty_enum_belongs_to_property(icalproperty_kind
*/
LIBICAL_ICAL_EXPORT void icalproperty_normalize(icalproperty *prop);
+/**
+ * @copydoc icalproperty_clone()
+ * @deprecated use icalproperty_clone() instead
+ */
+LIBICAL_ICAL_EXPORT LIBICAL_DEPRECATED(icalproperty *icalproperty_new_clone(icalproperty *prop));
+
#endif /*ICALPROPERTY_H */