From: Olle Johansson <oej@edvina.net>
Date: Wed, 25 Oct 2006 11:39:40 +0000 (+0000)
Subject: Always add doxygen comments to new functions, more lines than one are
X-Git-Tag: 1.6.0-beta1~3^2~4285
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2560ff9c33e73bb25e5555b58b3b04264ee32856;p=thirdparty%2Fasterisk.git

Always add doxygen comments to new functions, more lines than one are
appreciated really. (Read the coding guidelines).

I've worked hard to make chan_sip a better place to code in, let's
keep it that way and don't add more stuff without comments.

Thank you.


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

diff --git a/channels/chan_sip.c b/channels/chan_sip.c
index 18075a2485..817ff6a010 100644
--- a/channels/chan_sip.c
+++ b/channels/chan_sip.c
@@ -8912,8 +8912,7 @@ static struct ast_variable *copy_vars(struct ast_variable *src)
 	return res;
 }
 
-/* helper function for check_{user|peer}_ok() */
-
+/*! \brief helper function for check_{user|peer}_ok() */
 static void replace_cid(struct sip_pvt *p, const char *rpid_num, const char *calleridname)
 {
 	/* replace callerid if rpid found, and not restricted */
@@ -8927,6 +8926,7 @@ static void replace_cid(struct sip_pvt *p, const char *rpid_num, const char *cal
 	}
 }
 
+/*! \brief Validate user authentication */
 static enum check_auth_result check_user_ok(struct sip_pvt *p, char *of,
 	struct sip_request *req, int sipmethod, struct sockaddr_in *sin,
 	enum xmittype reliable,
@@ -9026,6 +9026,7 @@ static enum check_auth_result check_user_ok(struct sip_pvt *p, char *of,
 	return res;
 }
 
+/*! \brief Validate peer authentication */
 static enum check_auth_result check_peer_ok(struct sip_pvt *p, char *of,
 	struct sip_request *req, int sipmethod, struct sockaddr_in *sin,
 	struct sip_peer **authpeer,