Skip to content

Import source-backed Android.Telephony documentation #568

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jonathanpeppers wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Import source-backed Android.Telephony documentation #568

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d20953a
Add conservative XML documentation importer
jonathanpeppers Aug 15, 2026
7d2c934
Merge remote-tracking branch 'origin/main' into jonathanpeppers-build…
jonathanpeppers Aug 15, 2026
a5e6270
Document source-backed Android.Telephony APIs
jonathanpeppers Aug 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions docs/xml/Android.Telephony/AccessNetworkConstants+AccessNetworkType.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -316,8 +316,11 @@
</ReturnValue>
<MemberValue>2</MemberValue>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Constant Value: 2 (0x00000002) Content and code samples on this page are subject to the licenses described in the Content License.</summary>
<remarks>Constant Value: 2 (0x00000002) Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AccessNetworkConstants.AccessNetworkType#UTRAN" title="Reference documentation">Android reference for <code>android.telephony.AccessNetworkConstants.AccessNetworkType.UTRAN</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
</Members>
Expand Down
7 changes: 5 additions & 2 deletions docs/xml/Android.Telephony/AccessNetworkConstants+EutranBand.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1780,8 +1780,11 @@
</ReturnValue>
<MemberValue>9</MemberValue>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Constant Value: 9 (0x00000009) Content and code samples on this page are subject to the licenses described in the Content License.</summary>
<remarks>Constant Value: 9 (0x00000009) Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AccessNetworkConstants.EutranBand#BAND_9" title="Reference documentation">Android reference for <code>android.telephony.AccessNetworkConstants.EutranBand.BAND_9</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="JniPeerMembers">
Expand Down
7 changes: 5 additions & 2 deletions docs/xml/Android.Telephony/AccessNetworkConstants+GeranBand.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -445,8 +445,11 @@
</ReturnValue>
<MemberValue>7</MemberValue>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Constant Value: 7 (0x00000007) Content and code samples on this page are subject to the licenses described in the Content License.</summary>
<remarks>Constant Value: 7 (0x00000007) Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AccessNetworkConstants.GeranBand#BAND_T810" title="Reference documentation">Android reference for <code>android.telephony.AccessNetworkConstants.GeranBand.BAND_T810</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="JniPeerMembers">
Expand Down
7 changes: 5 additions & 2 deletions docs/xml/Android.Telephony/AccessNetworkConstants+NgranBands.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1602,8 +1602,11 @@
</ReturnValue>
<MemberValue>96</MemberValue>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Constant Value: 96 (0x00000060) Content and code samples on this page are subject to the licenses described in the Content License.</summary>
<remarks>Constant Value: 96 (0x00000060) Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AccessNetworkConstants.NgranBands#BAND_96" title="Reference documentation">Android reference for <code>android.telephony.AccessNetworkConstants.NgranBands.BAND_96</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="JniPeerMembers">
Expand Down
22 changes: 18 additions & 4 deletions docs/xml/Android.Telephony/AutheenticationType.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,11 @@
</ReturnValue>
<MemberValue>129</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Authentication type for UICC challenge is EAP AKA.</summary>
<remarks>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
<para>Authentication type for UICC challenge is EAP AKA. See RFC 4187 for details.</para>
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/TelephonyManager#AUTHTYPE_EAP_AKA" title="Reference documentation">Android reference for <code>android.telephony.TelephonyManager.AUTHTYPE_EAP_AKA</code>.</a></format></para>
</remarks>
</Docs>
</Member>
Expand Down Expand Up @@ -73,9 +75,11 @@
</ReturnValue>
<MemberValue>128</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Authentication type for UICC challenge is EAP SIM.</summary>
<remarks>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
<para>Authentication type for UICC challenge is EAP SIM. See RFC 4186 for details.</para>
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/TelephonyManager#AUTHTYPE_EAP_SIM" title="Reference documentation">Android reference for <code>android.telephony.TelephonyManager.AUTHTYPE_EAP_SIM</code>.</a></format></para>
</remarks>
</Docs>
</Member>
Expand Down Expand Up @@ -104,7 +108,12 @@
</ReturnValue>
<MemberValue>132</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Authentication type for GBA Bootstrap Challenge.</summary>
<remarks>
<para>Authentication type for GBA Bootstrap Challenge. Pass this authentication type into the getIccAuthentication(int, int, String) API to perform a GBA Bootstrap challenge (BSF), with data (generated according to the procedure defined in 3GPP 33.220 Section 5.3.2 step.4) in base64 encoding. This method will return the Bootstrapping response in base64 encoding when ICC authentication is completed. Ref 3GPP 33.220 Section 5.3.2.</para>
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/TelephonyManager#AUTHTYPE_GBA_BOOTSTRAP" title="Reference documentation">Android reference for <code>android.telephony.TelephonyManager.AUTHTYPE_GBA_BOOTSTRAP</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="GbaNafKeyExternal">
Expand Down Expand Up @@ -132,7 +141,12 @@
</ReturnValue>
<MemberValue>133</MemberValue>
<Docs>
<summary>To be added.</summary>
<summary>Authentication type for GBA Network Application Functions (NAF) key External Challenge.</summary>
<remarks>
<para>Authentication type for GBA Network Application Functions (NAF) key External Challenge. Pass this authentication type into the getIccAuthentication(int, int, String) API to perform a GBA Network Applications Functions (NAF) key External challenge using the NAF_ID parameter as the data in base64 encoding. This method will return the Ks_Ext_Naf key in base64 encoding when ICC authentication is completed. Ref 3GPP 33.220 Section 5.3.2.</para>
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/TelephonyManager#AUTHTYPE_GBA_NAF_KEY_EXTERNAL" title="Reference documentation">Android reference for <code>android.telephony.TelephonyManager.AUTHTYPE_GBA_NAF_KEY_EXTERNAL</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
</Members>
Expand Down
33 changes: 21 additions & 12 deletions docs/xml/Android.Telephony/AvailableNetworkInfo+Builder.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,10 +191,13 @@
<Parameter Name="mccMncs" Type="System.Collections.Generic.IList&lt;System.String&gt;" />
</Parameters>
<Docs>
<param name="mccMncs">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="mccMncs">nonull list of mccmncs. An empty List is still accepted. Please read documentation in AvailableNetworkInfo to see consequences of an empty List. This value cannot be null.</param>
<summary>Sets the list of mccmncs associated with the subscription id.</summary>
<returns>the original Builder object. This value cannot be null.</returns>
<remarks>Sets the list of mccmncs associated with the subscription id.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AvailableNetworkInfo.Builder#setMccMncs(java.util.List&lt;java.lang.String&gt;)" title="Reference documentation">Android reference for <code>android.telephony.AvailableNetworkInfo.Builder.setMccMncs</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="SetPriority">
Expand Down Expand Up @@ -224,10 +227,13 @@
<Parameter Name="priority" Type="System.Int32" />
</Parameters>
<Docs>
<param name="priority">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="priority">of the subscription id. See AvailableNetworkInfo.getPriority for more details. Value is one of the following: AvailableNetworkInfo.PRIORITY_HIGH AvailableNetworkInfo.PRIORITY_MED AvailableNetworkInfo.PRIORITY_LOW</param>
<summary>Sets the priority for the subscription id.</summary>
<returns>the original Builder object. This value cannot be null.</returns>
<remarks>Sets the priority for the subscription id.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AvailableNetworkInfo.Builder#setPriority(int)" title="Reference documentation">Android reference for <code>android.telephony.AvailableNetworkInfo.Builder.setPriority</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="SetRadioAccessSpecifiers">
Expand Down Expand Up @@ -257,10 +263,13 @@
<Parameter Name="radioAccessSpecifiers" Type="System.Collections.Generic.IList&lt;Android.Telephony.RadioAccessSpecifier&gt;" />
</Parameters>
<Docs>
<param name="radioAccessSpecifiers">To be added.</param>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<param name="radioAccessSpecifiers">nonull list of radioAccessSpecifiers. An empty List is still accepted. Please read documentation in AvailableNetworkInfo to see consequences of an empty List. This value cannot be null.</param>
<summary>Sets the list of mccmncs associated with the subscription id.</summary>
<returns>the original Builder object. This value cannot be null.</returns>
<remarks>Sets the list of mccmncs associated with the subscription id.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AvailableNetworkInfo.Builder#setRadioAccessSpecifiers(java.util.List&lt;android.telephony.RadioAccessSpecifier&gt;)" title="Reference documentation">Android reference for <code>android.telephony.AvailableNetworkInfo.Builder.setRadioAccessSpecifiers</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="ThresholdClass">
Expand Down
22 changes: 14 additions & 8 deletions docs/xml/Android.Telephony/AvailableNetworkInfo.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@
<c>AccessNetworkConstants.UtranBand</c> and <c>AccessNetworkConstants.EutranBand</c>
See <c>AccessNetworkConstants.AccessNetworkType</c> for details regarding different network
types.</summary>
<value>To be added.</value>
<value>List &lt; Integer &gt;</value>
<remarks>
<para>Returns the frequency bands that need to be scanned by opportunistic network service

Expand Down Expand Up @@ -203,9 +203,12 @@
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added.</summary>
<returns>To be added.</returns>
<remarks>To be added.</remarks>
<summary>Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.</summary>
<returns>a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR</returns>
<remarks>Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel,int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AvailableNetworkInfo#describeContents()" title="Reference documentation">Android reference for <code>android.telephony.AvailableNetworkInfo.describeContents</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
<Member MemberName="JniPeerMembers">
Expand Down Expand Up @@ -619,10 +622,13 @@
</Parameter>
</Parameters>
<Docs>
<param name="dest">To be added.</param>
<param name="flags">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="dest">The Parcel in which the object should be written. This value cannot be null.</param>
<param name="flags">Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of the following: Parcelable.PARCELABLE_WRITE_RETURN_VALUE</param>
<summary>Flatten this object in to a Parcel.</summary>
<remarks>Flatten this object in to a Parcel.
<para><format type="text/html"><a href="https://developer.android.com/reference/android/telephony/AvailableNetworkInfo#writeToParcel(android.os.Parcel,%20int)" title="Reference documentation">Android reference for <code>android.telephony.AvailableNetworkInfo.writeToParcel</code>.</a></format></para>
<para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
</remarks>
</Docs>
</Member>
</Members>
Expand Down
Loading