diff options
author | iphydf <iphydf@users.noreply.github.com> | 2016-12-14 18:31:42 +0000 |
---|---|---|
committer | iphydf <iphydf@users.noreply.github.com> | 2016-12-16 03:10:34 +0000 |
commit | bf6db329ac94267117fc74d9fdd90069a5145331 (patch) | |
tree | 60abeafbd8b49f6b77099833594dab0c8deceaba /toxcore/tox.h | |
parent | 4dccd668d2e356261114aeb9d70c360294a19563 (diff) |
Strengthen the note about ABI compatibility in tox.h.
We really want to get all clients off this struct. We won't actually
remove it until 0.2, but we're going to break ABI compatibility with this
in various 0.1.x releases.
Diffstat (limited to 'toxcore/tox.h')
-rw-r--r-- | toxcore/tox.h | 14 |
1 files changed, 6 insertions, 8 deletions
diff --git a/toxcore/tox.h b/toxcore/tox.h index e0f36343..602ec3c4 100644 --- a/toxcore/tox.h +++ b/toxcore/tox.h | |||
@@ -477,19 +477,17 @@ typedef void tox_log_cb(Tox *tox, TOX_LOG_LEVEL level, const char *file, uint32_ | |||
477 | 477 | ||
478 | 478 | ||
479 | /** | 479 | /** |
480 | * This struct contains all the startup options for Tox. You can either | 480 | * This struct contains all the startup options for Tox. You must tox_options_new to |
481 | * allocate this object yourself, and pass it to tox_options_default, or call tox_options_new to get | 481 | * allocate an object of this type. |
482 | * a new default options object. | ||
483 | * | 482 | * |
484 | * If you allocate it yourself, be aware that your binary will rely on the | 483 | * WARNING: Although this struct happens to be visible in the API, it is |
485 | * memory layout of this struct. In particular, if additional fields are added | 484 | * effectively private. Do not allocate this yourself or access members |
486 | * in future versions of the API, code that allocates it itself will become | 485 | * directly, as it *will* break binary compatibility frequently. |
487 | * incompatible. | ||
488 | * | 486 | * |
489 | * @deprecated The memory layout of this struct (size, alignment, and field | 487 | * @deprecated The memory layout of this struct (size, alignment, and field |
490 | * order) is not part of the ABI. To remain compatible, prefer to use tox_options_new to | 488 | * order) is not part of the ABI. To remain compatible, prefer to use tox_options_new to |
491 | * allocate the object and accessor functions to set the members. The struct | 489 | * allocate the object and accessor functions to set the members. The struct |
492 | * will become opaque (i.e. the definition will become private) in v0.1.0. | 490 | * will become opaque (i.e. the definition will become private) in v0.2.0. |
493 | */ | 491 | */ |
494 | struct Tox_Options { | 492 | struct Tox_Options { |
495 | 493 | ||