Add doxygen documentation for slinfactory_destroy(), mainly just noting that
authorRussell Bryant <russell@russellbryant.com>
Sat, 8 Sep 2007 19:01:20 +0000 (19:01 +0000)
committerRussell Bryant <russell@russellbryant.com>
Sat, 8 Sep 2007 19:01:20 +0000 (19:01 +0000)
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

include/asterisk/slinfactory.h

index 3ab42d2..597d366 100644 (file)
@@ -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);