diff options
-rw-r--r-- | doc/libogg/ogg_stream_destroy.html | 9 | ||||
-rw-r--r-- | doc/libogg/ogg_sync_destroy.html | 8 |
2 files changed, 15 insertions, 2 deletions
diff --git a/doc/libogg/ogg_stream_destroy.html b/doc/libogg/ogg_stream_destroy.html index 5badc94..9a07de3 100644 --- a/doc/libogg/ogg_stream_destroy.html +++ b/doc/libogg/ogg_stream_destroy.html @@ -18,7 +18,14 @@ <p><i>declared in "ogg/ogg.h";</i></p> <p>This function frees the memory used by the <a href="ogg_stream_state.html">ogg_stream_state</a> struct. -<p>This should be called when you are done working with an ogg stream. It can also be called to make sure that the struct does not exist. + +<p>This should be called when you are done working with an ogg stream. +It can also be called to make sure that the struct does not exist.</p> + +<p>It calls free() on its argument, so if the ogg_stream_state +is not malloc()'d or will otherwise be freed by your own code, use +<a href="ogg_stream_clear.html">ogg_stream_clear</a> instead.</p> + <br><br> <table border=0 color=black cellspacing=0 cellpadding=7> <tr bgcolor=#cccccc> diff --git a/doc/libogg/ogg_sync_destroy.html b/doc/libogg/ogg_sync_destroy.html index 19987a2..687aa97 100644 --- a/doc/libogg/ogg_sync_destroy.html +++ b/doc/libogg/ogg_sync_destroy.html @@ -17,7 +17,13 @@ <p><i>declared in "ogg/ogg.h";</i></p> -<p>This function is used to destroy an <a href="ogg_sync_state.html">ogg_sync_state</a> struct and free all memory used. +<p>This function is used to destroy an <a href="ogg_sync_state.html">ogg_sync_state</a> struct and free all memory used.</p> + +<p>Note this calls free() on its argument so you should only use this +function if you've allocated the ogg_sync_state on the heap. If it is +allocated on the stack, or it will otherwise be freed by your +own code, use <a href="ogg_sync_clear.html">ogg_sync_clear</a> instead +to release just the internal memory.</p> <br><br> <table border=0 color=black cellspacing=0 cellpadding=7> |