Removed superfluous tags from nua_tag.h and from documentation.

darcs-hash:20051008193858-65a35-adf2366d8485e26f530fec6e919c526f703d836d.gz

libsofia-sip-ua/nua/nua.c

@@ -589,7 +589,6 @@ sip_to_t const *nua_handle_local(nua_handle_t const *nh)
  *     nothing
  *
  * @par Related tags:
- *     #NUTAG_ALLOW \n
  *     #NUTAG_AUTOACK \n
  *     #NUTAG_AUTOALERT \n
  *     #NUTAG_AUTOANSWER \n
@@ -697,8 +696,6 @@ void nua_get_params(nua_t *nua, tag_type_t tag, tag_value_t value, ...)
  *     nothing
  *
  * @par Related tags:
- *     #NUTAG_AF \n
- *     #NUTAG_ALLOW \n
  *     #NUTAG_AUTOACK \n
  *     #NUTAG_AUTOALERT \n
  *     #NUTAG_AUTOANSWER \n
@@ -707,23 +704,16 @@ void nua_get_params(nua_t *nua, tag_type_t tag, tag_value_t value, ...)
  *     #NUTAG_ENABLEMESSAGE \n
  *     #NUTAG_ENABLEMESSENGER \n
  *     #NUTAG_INVITE_TIMER \n
- *     #NUTAG_MEDIA_ADDRESS \n
- *     #NUTAG_MEDIA_CLONE \n
- *     #NUTAG_MEDIA_DESCS \n
- *     #NUTAG_MEDIA_EVENT_PATH \n
  *     #NUTAG_MEDIA_FEATURES \n
- *     #NUTAG_MEDIA_PATH \n
- *     #NUTAG_MEDIA_PARAMS \n
  *     #NUTAG_MIN_SE \n
- *     #NUTAG_PROXY \n
+ *     #NUTAG_PROXY (XXX) \n
  *     #NUTAG_REGISTRAR \n
  *     #NUTAG_SESSION_REFRESHER \n
  *     #NUTAG_SESSION_TIMER \n
- *     #NUTAG_URL \n
  *     #NUTAG_USER_AGENT \n
  *     #NUTAG_UPDATE_REFRESH \n
- *     #NUTAG_SIP_PARSER \n
- *     #NUTAG_CERTIFICATE_DIR \n
+ *     #NUTAG_SIP_PARSER (XXX) \n
+ *     #NUTAG_CERTIFICATE_DIR (XXX) \n
  *     #NUTAG_SMIME_ENABLE \n
  *     #NUTAG_SMIME_OPT \n
  *     #NUTAG_SMIME_PROTECTION_MODE \n
@@ -732,17 +722,11 @@ void nua_get_params(nua_t *nua, tag_type_t tag, tag_value_t value, ...)
  *     #NUTAG_SMIME_KEY_ENCRYPTION \n
  *     #NUTAG_SMIME_MESSAGE_ENCRYPTION \n
  *     #NUTAG_SIPS_URL \n
- *     #SIPTAG_FROM_STR \n
+ *     #SIPTAG_ORGANIZATION \n
  *     #SIPTAG_ORGANIZATION_STR \n
+ *     #SIPTAG_SUPPORTED \n
  *     #SIPTAG_SUPPORTED_STR \n
  *     #SIPTAG_ALLOW_STR \n
- *     #NTATAG_DEFAULT_PROXY \n
- *     #NTATAG_SIP_T1 \n
- *     #NTATAG_SIP_T2 \n
- *     #NTATAG_SIP_T4 \n
- *     #NTATAG_SIP_T1X64 \n
- *     #NTATAG_DEBUG_DROP_PROB \n
- *     #NTATAG_SIPFLAGS
  *
  * @par Events:
  *     none
@@ -753,10 +737,24 @@ void nua_set_hparams(nua_handle_t *nh, tag_type_t tag, tag_value_t value, ...)
 }
 
 /** Get values of handle-specific parameters in nua_r_get_params event.
+ *
+ * Application will specify either expilicit list of tags it is interested
+ * in, or a filter (at the moment, TAG_ANY()). The values are returned as a
+ * list of tags in the nua_r_get_params event.
  *
  * @param nh              Pointer to operation handle
  * @param tag, value, ... List of tagged parameters
  *
+ * The handle-specific parameters will contain only the parameters actually
+ * modified by application, either by nua_set_handle_params() or some other
+ * handle-specific call. Currently, no NTA parameters are returned. They are
+ * returned only when application asks for user-agent-level parameters using
+ * either nua_get_params() or using default handle, eg.
+ * @code
+ * nua_get_handle_params(nua_default(nua), TAG_ANY())
+ * @endcode
+ *
+ *
  * @return
  *     nothing
  *

libsofia-sip-ua/nua/nua_tag.c

@@ -103,7 +103,6 @@ tag_typedef_t nutag_certificate_dir = STRTAG_TYPEDEF(certificate_dir);
 tag_typedef_t nutag_certificate_phrase = STRTAG_TYPEDEF(certificate_phrase);
 
 tag_typedef_t nutag_registrar = URLTAG_TYPEDEF(registrar);
-tag_typedef_t nutag_allow = STRTAG_TYPEDEF(allow);
 tag_typedef_t nutag_sip_parser = PTRTAG_TYPEDEF(sip_parser);
 
 tag_typedef_t nutag_use_leg = BOOLTAG_TYPEDEF(use_leg);

libsofia-sip-ua/nua/nua_tag.h

@@ -790,25 +790,6 @@ extern tag_typedef_t nutag_registrar;
 #define NUTAG_REGISTRAR_REF(x)  nutag_registrar_ref, urltag_url_vr(&(x))
 extern tag_typedef_t nutag_registrar_ref;
 
-/** Allowed sip methods. If this tag is not used all methods are allowed by default.
- * @par Used with
- *    nua_set_params() \n
- *    nua_get_params()
- *
- * @par Parameter type
- *    char const *
- *
- * @par Values
- *    NULL terminated string of allowed SIP methods separated by commas
- *
- * Corresponding tag taking reference parameter is NUTAG_ALLOW_REF()
- */
-#define NUTAG_ALLOW(x)          nutag_allow, tag_str_v(x)
-extern tag_typedef_t nutag_allow;
-
-#define NUTAG_ALLOW_REF(x)      nutag_allow_ref, tag_str_vr(&(x))
-extern tag_typedef_t nutag_allow_ref;
-
 /** Pointer to SIP parser structure
  *
  * @par Used with