Mark Tox_Options struct as deprecated.

We will remove it in v0.1.

3 files changed, 9 insertions, 6 deletions

diff --git a/CMakeLists.txt b/CMakeLists.txt
index dbabebed..7c08fd82 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -81,6 +81,7 @@ if(WARNINGS)
   add_flag("-Wno-cast-align")
   add_flag("-Wno-conversion")
   add_flag("-Wno-covered-switch-default")
+  add_flag("-Wno-documentation-deprecated-sync")
   add_flag("-Wno-format-nonliteral")
   add_flag("-Wno-missing-field-initializers")
   add_flag("-Wno-missing-prototypes")
diff --git a/toxcore/tox.api.h b/toxcore/tox.api.h
index e9e3483d..40031830 100644
--- a/toxcore/tox.api.h
+++ b/toxcore/tox.api.h
@@ -433,9 +433,10 @@ static class options {
    * in future versions of the API, code that allocates it itself will become
    * incompatible.
    *
-   * The memory layout of this struct (size, alignment, and field order) is not
-   * part of the ABI. To remain compatible, prefer to use $new to allocate the
-   * object and accessor functions to set the members.
+   * @deprecated The memory layout of this struct (size, alignment, and field
+   * order) is not part of the ABI. To remain compatible, prefer to use $new to
+   * allocate the object and accessor functions to set the members. The struct
+   * will become opaque (i.e. the definition will become private) in v0.1.0.
    */
   struct this [get, set] {
     /**
diff --git a/toxcore/tox.h b/toxcore/tox.h
index af25d8fa..ef738422 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -482,9 +482,10 @@ typedef void tox_log_cb(Tox *tox, TOX_LOG_LEVEL level, const char *file, uint32_
  * in future versions of the API, code that allocates it itself will become
  * incompatible.
  *
- * The memory layout of this struct (size, alignment, and field order) is not
- * part of the ABI. To remain compatible, prefer to use tox_options_new to allocate the
- * object and accessor functions to set the members.
+ * @deprecated The memory layout of this struct (size, alignment, and field
+ * order) is not part of the ABI. To remain compatible, prefer to use tox_options_new to
+ * allocate the object and accessor functions to set the members. The struct
+ * will become opaque (i.e. the definition will become private) in v0.1.0.
  */
 struct Tox_Options {