Add doxygen documentation for slinfactory_destroy(), mainly just noting that

it doesn't free the slinfactory itself.  (This isn't related to a bug, i'm just
looking over random code)

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@81999 65c4cc65-6c06-0410-ace0-fbb531ad65f3

diff --git a/include/asterisk/slinfactory.h b/include/asterisk/slinfactory.h
index 3ab42d2839366f5c224c0d1a3806d45ab0f88fb5..597d366bf54c534e24b728c5574b1e01c2054395 100644 (file)
--- a/include/asterisk/slinfactory.h
+++ b/include/asterisk/slinfactory.h
@@ -42,7 +42,20 @@ struct ast_slinfactory {
 };
 
 void ast_slinfactory_init(struct ast_slinfactory *sf);
+
+/*!
+ * \brief Destroy the contents of a slinfactory
+ *
+ * \arg sf the slinfactory that is no longer needed
+ *
+ * This function will free any memory allocated for the contents of the
+ * slinfactory.  It does not free the slinfactory itself.  If the sf is
+ * malloc'd, then it must be explicitly free'd after calling this function.
+ *
+ * \return nothing
+ */
 void ast_slinfactory_destroy(struct ast_slinfactory *sf);
+
 int ast_slinfactory_feed(struct ast_slinfactory *sf, struct ast_frame *f);
 int ast_slinfactory_read(struct ast_slinfactory *sf, short *buf, size_t samples);
 unsigned int ast_slinfactory_available(const struct ast_slinfactory *sf);