Add Doxygen documentation for API changes from 1.6.0 to 1.6.1

Copied from my review board description:
This is a continuation of the API changes documentation started for describing
changes between releases. Most of the API changes were pretty simple needing
only to be brought to attention via the new "Asterisk API Changes" list.
However, if you see anything that needs further explanation feel free to
supplement what is there. The current method of documenting is to add (in the
header file): \version <ver number> <description of changes> and then to add
the function to the change list in doxyref.h on the AstAPIChanges page. I also
made sure all the functions that were newly added were tagged with \since
1.6.1. I think this is a good habit to start both for the historical aspect as
well as for the future ability to easily add a "New Asterisk API" page.

Review: http://reviewboard.digium.com/r/190/


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

1 files changed, 17 insertions, 9 deletions

diff --git a/include/asterisk/extconf.h b/include/asterisk/extconf.h
index 7527c579f..eeccc7b33 100644
--- a/include/asterisk/extconf.h
+++ b/include/asterisk/extconf.h
@@ -1,4 +1,4 @@
-/*  
+/*
  * Asterisk -- An open source telephony toolkit.
  *
  * Copyright (C) 2007, Digium, Inc.
@@ -15,7 +15,7 @@
  * the GNU General Public License Version 2. See the LICENSE file
  * at the top of the source tree.
  */
-/*! \file 
+/*! \file
  * \brief External configuration handlers (realtime and static configuration)
  * \author Steve Murphy <murf@digium.com>
  *
@@ -30,7 +30,7 @@ extern "C" {
 
 #ifdef NOTYET
 /* I'm going to define all the structs mentioned below, to avoid
-   possible conflicts in declarations that might be introduced, 
+   possible conflicts in declarations that might be introduced,
    if we just include the files that define them-- this may be
    unnecessary */
 
@@ -54,7 +54,7 @@ struct ast_variable {
 struct ast_category {
 	char name[80];
 	int ignored;			/*!< do not let user of the config see this category */
-	int include_level;	
+	int include_level;
 	struct ast_comment *precomments;
 	struct ast_comment *sameline;
 	struct ast_variable *root;
@@ -180,6 +180,10 @@ struct ast_sw *localized_walk_context_switches(struct ast_context *con,
 void localized_context_destroy(struct ast_context *con, const char *registrar);
 int localized_pbx_load_module(void);
 
+/*!
+ * \version 1.6.1 added tab parameter
+ * \version 1.6.1 renamed function from localized_context_create to localized_context_find_or_create
+ */
 struct ast_context *localized_context_find_or_create(struct ast_context **extcontexts, void *tab, const char *name, const char *registrar);
 int localized_pbx_builtin_setvar(struct ast_channel *chan, void *data);
 int localized_context_add_ignorepat2(struct ast_context *con, const char *value, const char *registrar);
@@ -191,6 +195,10 @@ int localized_add_extension2(struct ast_context *con,
 							 int replace, const char *extension, int priority, const char *label, const char *callerid,
 							 const char *application, void *data, void (*datad)(void *),
 							 const char *registrar);
+
+/*!
+ * \version 1.6.1 added tab parameter
+ */
 void localized_merge_contexts_and_delete(struct ast_context **extcontexts, void *tab, const char *registrar);
 int localized_context_verify_includes(struct ast_context *con);
 void localized_use_conf_dir(void);
@@ -234,17 +242,17 @@ struct pbx_find_info {
 #define STATUS_NO_EXTENSION	2
 #define STATUS_NO_PRIORITY	3
 #define STATUS_NO_LABEL		4
-#define STATUS_SUCCESS		5 
+#define STATUS_SUCCESS		5
 
 #endif
 
 struct ast_exten *localized_find_extension(struct ast_context *bypass,
 										  struct pbx_find_info *q,
-										  const char *context, 
-										  const char *exten, 
+										  const char *context,
+										  const char *exten,
 										  int priority,
-										  const char *label, 
-										  const char *callerid, 
+										  const char *label,
+										  const char *callerid,
 										  enum ext_match_t action);