summaryrefslogtreecommitdiff
path: root/src/libical/icalvalue.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/libical/icalvalue.h')
-rw-r--r--src/libical/icalvalue.h26
1 files changed, 15 insertions, 11 deletions
diff --git a/src/libical/icalvalue.h b/src/libical/icalvalue.h
index b3f899ba..d6946dcc 100644
--- a/src/libical/icalvalue.h
+++ b/src/libical/icalvalue.h
@@ -2,23 +2,16 @@
FILE: icalvalue.h
CREATOR: eric 20 March 1999
- (C) COPYRIGHT 2000, Eric Busboom <eric@civicknowledge.com>
+ SPDX-FileCopyrightText: 2000, Eric Busboom <eric@civicknowledge.com>
- This library is free software; you can redistribute it and/or modify
- it under the terms of either:
+ SPDX-License-Identifier: LGPL-2.1-only OR MPL-2.0
- The LGPL as published by the Free Software Foundation, version
- 2.1, available at: https://www.gnu.org/licenses/lgpl-2.1.html
-
- Or:
-
- The Mozilla Public License Version 2.0. You may obtain a copy of
- the License at https://www.mozilla.org/MPL/
======================================================================*/
#ifndef ICALVALUE_H
#define ICALVALUE_H
+#include "libical_deprecated.h"
#include "libical_ical_export.h"
#include "icalvalueimpl.h"
@@ -29,7 +22,12 @@
LIBICAL_ICAL_EXPORT icalvalue *icalvalue_new(icalvalue_kind kind);
-LIBICAL_ICAL_EXPORT icalvalue *icalvalue_new_clone(const icalvalue *value);
+/** @brief Deeply clones an icalvalue.
+ *
+ * Returns a pointer to the memory for the newly cloned icalvalue.
+ * @since 3.1.0
+ */
+LIBICAL_ICAL_EXPORT icalvalue *icalvalue_clone(const icalvalue *value);
LIBICAL_ICAL_EXPORT icalvalue *icalvalue_new_from_string(icalvalue_kind kind, const char *str);
@@ -48,6 +46,12 @@ LIBICAL_ICAL_EXPORT int icalvalue_isa_value(void *);
LIBICAL_ICAL_EXPORT icalparameter_xliccomparetype icalvalue_compare(const icalvalue *a,
const icalvalue *b);
+/**
+ * @copydoc icalvalue_clone()
+ * @deprecated Use icalvalue_clone() instead
+ */
+LIBICAL_ICAL_EXPORT LIBICAL_DEPRECATED(icalvalue *icalvalue_new_clone(const icalvalue *value));
+
/* Special, non autogenerated value accessors */
/* Defined in icalderivedvalue.h */