res_pjsip: Update endpoint transport option documentation.

Change-Id: I5394fdff6a296efc8e1695a156e616acd932ae52

diff --git a/configs/samples/pjsip.conf.sample b/configs/samples/pjsip.conf.sample
index c2e2918ae61a753f5e52d5e6bea7574b0e78216d..6969aa0de2cded6c661f8f8633ff1dc998cd8580 100644 (file)
--- a/configs/samples/pjsip.conf.sample
+++ b/configs/samples/pjsip.conf.sample
@@ -288,8 +288,8 @@
 ; a transport that you'll need to uncomment from the previous examples.
 ;
 ; Uncomment one of the transport lines to choose which transport you want. If
-; not specified then the default transport chosen is the first defined transport
-; in the configuration file.
+; not specified then the default transport chosen is the first compatible transport
+; in the configuration file for the contact URL.
 ;
 ; Modify the "max_contacts=" line to change how many unique registrations to allow.
 ;
@@ -670,7 +670,12 @@
 ;timers=yes     ; Session timers for SIP packets (default: "yes")
 ;timers_sess_expires=1800       ; Maximum session timer expiration period
                                 ; (default: "1800")
-;transport=     ; Desired transport configuration (default: "")
+;transport=     ; Explicit transport configuration to use (default: "")
+                ; This will force the endpoint to use the specified transport
+                ; configuration to send SIP messages.  You need to already know
+                ; what kind of transport (UDP/TCP/IPv4/etc) the endpoint device
+                ; will use.
+
 ;trust_id_inbound=no    ; Accept identification information received from this
                         ; endpoint (default: "no")
 ;trust_id_outbound=no   ; Send private identification details to the endpoint

diff --git a/res/res_pjsip.c b/res/res_pjsip.c
index 0d9c77c516551684c6e3d2392d0bbe215c82873d..ba06277a856b3f63461c5228607f595294c72062 100644 (file)
--- a/res/res_pjsip.c
+++ b/res/res_pjsip.c
@@ -471,14 +471,17 @@
                                        </para></description>
                                </configOption>
                                <configOption name="transport">
-                                       <synopsis>Desired transport configuration</synopsis>
-                                       <description><para>
-                                               This will set the desired transport configuration to send SIP data through.
+                                       <synopsis>Explicit transport configuration to use</synopsis>
+                                       <description>
+                                               <para>This will <emphasis>force</emphasis> the endpoint to use the
+                                               specified transport configuration to send SIP messages.  You need
+                                               to already know what kind of transport (UDP/TCP/IPv4/etc) the
+                                               endpoint device will use.
                                                </para>
-                                               <warning><para>Not specifying a transport will <emphasis>DEFAULT</emphasis>
-                                               to the first configured transport in <filename>pjsip.conf</filename> which is
-                                               valid for the URI we are trying to contact.
-                                               </para></warning>
+                                               <note><para>Not specifying a transport will select the first
+                                               configured transport in <filename>pjsip.conf</filename> which is
+                                               compatible with the URI we are trying to contact.
+                                               </para></note>
                                                <warning><para>Transport configuration is not affected by reloads. In order to
                                                change transports, a full Asterisk restart is required</para></warning>
                                        </description>