[mobile-broadband-provider-info] dtd: add description of various items

[Dan Williams <dcbw src gnome org>]

commit 71817d1bee4ea15170768b4e2c20df083edb010f
Author: Dan Williams <dcbw redhat com>
Date:   Thu Jul 22 17:01:51 2010 -0700

    dtd: add description of various items

 serviceproviders.2.dtd |   24 +++++++++++++++++++++++-
 1 files changed, 23 insertions(+), 1 deletions(-)
---
diff --git a/serviceproviders.2.dtd b/serviceproviders.2.dtd
index 44562aa..485b0aa 100644
--- a/serviceproviders.2.dtd
+++ b/serviceproviders.2.dtd
@@ -45,11 +45,32 @@
 <!ELEMENT network-id EMPTY>
 <!ATTLIST network-id mcc CDATA #REQUIRED>
 <!ATTLIST network-id mnc CDATA #REQUIRED>
+<!-- network-id should contain all the providers's known MCC/MNC codes.
+     The MNC should be a three-digit ITU E.212 Mobile Country Code (like
+     '310' or '409') and the MNC should be a two- or three-digit GSM
+     Mobile Network Code.  Even if the provider is an MVNO, it's upstream
+     network infrastructure provider's MCC/MNC codes should be included
+     so that the MCC+MNC from the IMSI of the MVNO's SIM can be roughly
+     matched to the provider.
+-->
+
+<!ELEMENT username (#PCDATA)>
+<!-- username required for authentication when starting a packet data session -->
 
-<!ELEMENT username (#PCDATA)> 
 <!ELEMENT password (#PCDATA)>
+<!-- password required for authentication when starting a packet data session -->
+
 <!ELEMENT dns (#PCDATA)>
+<!-- Any static IPv4 DNS servers required for the provider; usually these are
+     sent to the client automatically via PPP or PDP context negotiation and
+     this value is not used.
+-->
+
 <!ELEMENT gateway (#PCDATA)>
+<!-- Static IPv4 gateway to which IP traffic for the data session should be
+     directed to.  Usually the gateway is provided automatically via PPP or
+     PDP context negotiation and this value is not used.
+-->
 
 <!ELEMENT cdma (name*,
                 username?,
@@ -59,6 +80,7 @@
 
 <!ELEMENT sid EMPTY>
 <!ATTLIST sid value CDATA #REQUIRED>
+<!-- AMPS/CDMA System IDs known to be used by this provider -->
 
 <!ELEMENT name (#PCDATA)>
 <!ATTLIST name xml:lang CDATA #IMPLIED>