瀏覽代碼

Doxygen updates

oej 16 年之前
父節點
當前提交
2d473a9db8

+ 8 - 8
modules/topoh/README

@@ -70,10 +70,10 @@ Chapter 1. Admin Guide
 
 
 1. Overview
 1. Overview
 
 
-   This module hides the routing headers that show topology details. It it
-   is not affected by the server being transaction stateless or stateful.
-   The script interpretor gets the SIP messages decoded, so all
-   functionality existing so far is preserved.
+   This module hides the SIP routing headers that show topology details.
+   It it is not affected by the server being transaction stateless or
+   stateful. The script interpreter gets the SIP messages decoded, so all
+   existing functionality is preserved.
 
 
    The module is transparent for the configuration writer. It only needs
    The module is transparent for the configuration writer. It only needs
    to be loaded (tune the parameters if needed). The SIP server can be
    to be loaded (tune the parameters if needed). The SIP server can be
@@ -98,7 +98,7 @@ Chapter 1. Admin Guide
 
 
    The following libraries or applications must be installed before
    The following libraries or applications must be installed before
    running Kamailio with this module loaded:
    running Kamailio with this module loaded:
-     * None. In the future the module can be enhnaced to use a stronger
+     * None. In the future the module can be enhanced to use a stronger
        encryption algorithm.
        encryption algorithm.
 
 
 3. Exported Parameters
 3. Exported Parameters
@@ -137,7 +137,7 @@ modparam("topoh", "mask_callid", 1)
 
 
 3.3. uparam_name (str)
 3.3. uparam_name (str)
 
 
-   Name of URI param where to store encoded value.
+   Name of URI parameter where to store encoded value.
 
 
    Default value is "line".
    Default value is "line".
 
 
@@ -148,7 +148,7 @@ modparam("topoh", "uparam_name", "myparam")
 
 
 3.4. uparam_prefix (str)
 3.4. uparam_prefix (str)
 
 
-   Prefix to be added in encoded URI params.
+   Prefix to be added in encoded URI parameters.
 
 
    Default value is "sr-".
    Default value is "sr-".
 
 
@@ -159,7 +159,7 @@ modparam("topoh", "uparam_prefix", "xyz")
 
 
 3.5. vparam_name (str)
 3.5. vparam_name (str)
 
 
-   Name of Via: parameter where to store encoded value.
+   Name of Via: parameter used to store encoded value.
 
 
    Default value is "branch".
    Default value is "branch".
 
 

+ 7 - 7
modules/topoh/doc/topoh_admin.xml

@@ -16,10 +16,10 @@
 	<section>
 	<section>
 	<title>Overview</title>
 	<title>Overview</title>
 	<para>
 	<para>
-		This module hides the routing headers that show topology details.
+		This module hides the SIP routing headers that show topology details.
 		It it is not affected by the server being transaction stateless or
 		It it is not affected by the server being transaction stateless or
-		stateful. The script interpretor gets the SIP messages decoded,
-		so all functionality existing so far is preserved.
+		stateful. The script interpreter gets the SIP messages decoded,
+		so all existing functionality is preserved.
 	</para>
 	</para>
 	<para>
 	<para>
 		The module is transparent for the configuration writer. It only needs to be
 		The module is transparent for the configuration writer. It only needs to be
@@ -57,7 +57,7 @@
 			<listitem>
 			<listitem>
 			<para>
 			<para>
 				<emphasis>None</emphasis>. In the future the module can be
 				<emphasis>None</emphasis>. In the future the module can be
-				enhnaced to use a stronger encryption algorithm.
+				enhanced to use a stronger encryption algorithm.
 			</para>
 			</para>
 			</listitem>
 			</listitem>
 			</itemizedlist>
 			</itemizedlist>
@@ -111,7 +111,7 @@ modparam("topoh", "mask_callid", 1)
 	<section>
 	<section>
 		<title><varname>uparam_name</varname> (str)</title>
 		<title><varname>uparam_name</varname> (str)</title>
 		<para>
 		<para>
-		Name of URI param where to store encoded value.
+		Name of URI parameter where to store encoded value.
 		</para>
 		</para>
 		<para>
 		<para>
 		<emphasis>
 		<emphasis>
@@ -130,7 +130,7 @@ modparam("topoh", "uparam_name", "myparam")
 	<section>
 	<section>
 		<title><varname>uparam_prefix</varname> (str)</title>
 		<title><varname>uparam_prefix</varname> (str)</title>
 		<para>
 		<para>
-		Prefix to be added in encoded URI params.
+		Prefix to be added in encoded URI parameters.
 		</para>
 		</para>
 		<para>
 		<para>
 		<emphasis>
 		<emphasis>
@@ -149,7 +149,7 @@ modparam("topoh", "uparam_prefix", "xyz")
 		<section>
 		<section>
 		<title><varname>vparam_name</varname> (str)</title>
 		<title><varname>vparam_name</varname> (str)</title>
 		<para>
 		<para>
-		Name of Via: parameter where to store encoded value.
+		Name of Via: parameter used to store encoded value.
 		</para>
 		</para>
 		<para>
 		<para>
 		<emphasis>
 		<emphasis>

+ 6 - 0
modules/topoh/th_mask.c

@@ -17,6 +17,12 @@
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  */
+/*!
+ * \file
+ * \brief SIP-router topoh :: 
+ * \ingroup lcr
+ * Module: \ref lcr
+ */
 
 
 #include <string.h>
 #include <string.h>
 
 

+ 7 - 0
modules/topoh/th_mask.h

@@ -18,6 +18,13 @@
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  */
 
 
+/*!
+ * \file
+ * \brief SIP-router topoh :: 
+ * \ingroup topoh
+ * Module: \ref topoh
+ */
+
 #ifndef _TH_MASK_H_
 #ifndef _TH_MASK_H_
 #define _TH_MASK_H_
 #define _TH_MASK_H_
 
 

+ 7 - 0
modules/topoh/th_msg.c

@@ -18,6 +18,13 @@
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  */
 
 
+/*!
+ * \file
+ * \brief SIP-router topoh ::
+ * \ingroup topoh
+ * Module: \ref topoh
+ */
+
 #include <string.h>
 #include <string.h>
 
 
 #include "../../dprint.h"
 #include "../../dprint.h"

+ 7 - 0
modules/topoh/th_msg.h

@@ -18,6 +18,13 @@
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  */
 
 
+/*!
+ * \file
+ * \brief SIP-router topoh ::
+ * \ingroup topoh
+ * Module: \ref topoh
+ */
+
 #ifndef _TH_MSG_H_
 #ifndef _TH_MSG_H_
 #define _TH_MSG_H_
 #define _TH_MSG_H_
 
 

+ 15 - 0
modules/topoh/topoh_mod.c

@@ -18,6 +18,21 @@
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
  */
 
 
+/*!
+ * \file
+ * \brief SIP-router topoh :: Module interface
+ * \ingroup topoh
+ * Module: \ref topoh
+ */
+
+/*! \defgroup topoh SIP-router :: Topology hiding
+ *
+ * This module hides the SIP routing headers that show topology details.
+ * It it is not affected by the server being transaction stateless or
+ * stateful. The script interpreter gets the SIP messages decoded, so all
+ * existing functionality is preserved.
+ */
+
 #include <stdio.h>
 #include <stdio.h>
 #include <string.h>
 #include <string.h>
 #include <stdlib.h>
 #include <stdlib.h>