Adding fetch modes 'never' and 'automatic-home' #69

Author: Eduardo Fullea

index.html

@@ -868,12 +868,10 @@ <h2><a>MmsManager</a> Interface</h2>
     </dd>
 
     <dt>void setFetchMode ()</dt>
-    <dd>This method issues a request to the messaging system to set to <a
-    class="internalDFN" href="#idl-def-FetchMode.manual">manual</a>
-    or <a class="internalDFN" href="#idl-def-FetchMode.automatic">automatic</a>
-    the MMS message fetch mode of the specific service, the one identified by
-    the <code>serviceID</code> attribute, if provided, or all services
-    otherwise).
+    <dd>This method issues a request to the messaging system to set the MMS
+    message fetch mode for the service identified by the <code>serviceID</code>
+    attribute, if provided, or for all services otherwise, to the mode indicated
+    in the <code>fetchMode</code> attribute.
     <dl class='parameters'>
          <dt>FetchMode fetchMode</dt>
          <dd>
@@ -1078,7 +1076,10 @@ <h3>Steps</h3>
       identifier of the service at which the message has been received.
       <li>Set the <code>read</code> of the <code>MmsMessage</code> to 'false'.
       <li>if the fetch mode is <a class="internalDFN"
-      href="#idl-def-FetchMode.manual">manual</a>: 
+      href="#idl-def-FetchMode.manual">manual</a>, <a class="internalDFN"
+      href="#idl-def-FetchMode.never">never</a> or the device is not in the home
+      network and the the fetch mode is <a class="internalDFN"
+      href="#idl-def-FetchMode.automatic-home">automatic-home</a>: 
         <ol>
           <li>Set the <code>from</code> of the <code>MmsMessage</code> to the
           value of the 'From' field of the MMS notification, if present.
@@ -1104,7 +1105,9 @@ <h3>Steps</h3>
           'not-downloaded'.
         </ol>
       <li>if the fetch mode is otherwise <a class="internalDFN"
-      href="#idl-def-FetchMode.automatic">automatic</a>: 
+      href="#idl-def-FetchMode.automatic">automatic</a> or the device is in the
+      home network and the the fetch mode is <a class="internalDFN"
+      href="#idl-def-FetchMode.automatic-home">automatic-home</a>: 
         <ol>
           <li>Make a request to the system to fetch the MMS message from the URL
           indicated in the X-Mms-Content-Location field of the MMS notification.
@@ -1164,7 +1167,8 @@ <h3>Steps</h3>
 
    <p> The <dfn><code>fetch</code></dfn> method can be invoked to fetch an MMS
    message that has not been automatically fetched upon receiving the
-   corresponding MMS notification due to the fetch mode being manual. When this
+   corresponding MMS notification, e.g. due to the fetch mode being <a
+   class="internalDFN" href="#idl-def-FetchMode.manual">manual</a>. When this
    method is invoked the User Agent MUST run the following steps:
     <ol>
      <li>If the <code>messageID</code> parameter passed in the request matches
@@ -1956,11 +1960,25 @@ <h2>Enumerations</h2>
               notification.
           </dd>
 
+          <dt>automatic-home</dt>
+          <dd>
+              MMS message is fecthed right after the reception of the MMS
+              notification if the device is located in the home network, i.e.
+              not roaming, otherwise the message will be fetched upon the device
+              entering in the home network again or the user manually requesting
+              it.
+          </dd>
+
           <dt>manual</dt>
           <dd>
               The message is not fecthed until the user manually requests it.
           </dd>
 
+          <dt>never</dt>
+          <dd>
+              MMS message retrieval is completely disabled.
+          </dd>
+          
     </dl>
 
     </section>