more tweaks and docs

git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@9715 d0543943-73ff-0310-b7d9-9358b9ac24b2

conf/dialplan/public.xml

@@ -1,13 +1,18 @@
+<!--
+    NOTICE:
+
+    This context is usually accessed via the external sip profile sitting on port 5080.
+    
+    It is recommended to have separate inbound and outbound contexts.  Not only for security
+    but clearing up why you would need to do such a thing.  You don't want outside un-authenticated
+    callers hitting your default context which allows dialing calls thru your providers and results 
+    in Toll Fraud.
+-->
+
 <!-- http://wiki.freeswitch.org/wiki/Dialplan_XML -->
 <include>
   <context name="public">
 
-    <extension name="outside_call" continue="true">
-      <condition break="never">
-	<action application="set" data="outside_call=true"/>
-      </condition>
-    </extension>
-
     <extension name="unloop">
       <condition field="${unroll_loops}" expression="^true$"/>
       <condition field="${sip_looped_call}" expression="^true$">
@@ -15,6 +20,17 @@
       </condition>
     </extension>
 
+    <!--
+	Tag anything pass thru here as an outside_call so you can make sure not
+	to create any routing loops based on the conditions that it came from 
+	the outside of the switch.  
+    -->
+    <extension name="outside_call" continue="true">
+      <condition break="never">
+	<action application="set" data="outside_call=true"/>
+      </condition>
+    </extension>
+
     <!-- Try to get target_domain from the sip_req_params variable -->
     <extension name="set_domain" continue="true">
       <condition field="${target_domain}" expression="^$" break="never"/>
@@ -37,7 +53,10 @@
 	<action application="transfer" data="$1 XML default"/>
       </condition>
     </extension>
-
+    
+    <!--
+	You can place files in the public directory to get included.
+    -->
     <X-PRE-PROCESS cmd="include" data="public/*.xml"/>
 
   </context>