Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/shared/resources/apn/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'shared/resources/apn/README.md')
-rw-r--r--shared/resources/apn/README.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/shared/resources/apn/README.md b/shared/resources/apn/README.md
new file mode 100644
index 0000000..b839ef3
--- /dev/null
+++ b/shared/resources/apn/README.md
@@ -0,0 +1,20 @@
+Three APN (Access Point Name) databases are used:
+
+* the Android database `/shared/resources/apn/apns_conf.xml` is the *de facto* standard we rely on;
+* a local database `/shared/resources/apn/apns_conf-local.xml` with the same format we merge with the above, used for where Google is lacking. Ideally this file should be empty as everything should be put upstream;
+* the Gnome database `/shared/resources/apn/serviceproviders.xml` is probably less up-to-date but has a bit more information.
+
+A fourth file `/shared/resources/apn/operator-variant.xml` is also used.
+
+These files are only used to test and merge these APN databases.
+
+The `/shared/resources/apn.json` file is a JSON version of the Android database, with a few additional informations from the Gnome APN database (e.g. voicemail number).
+
+To regenerate the .json file, start from the parent directory a webserver. Like this:
+
+ cd .. ; python -m SimpleHTTPServer 4104
+
+Then load http://0.0.0.0:4104/apn
+This should regenerate the .json file into the left part of the page, and you can cut & paste this to your editor.
+
+TODO: make this automatic. Patches Welcomeâ„¢ \ No newline at end of file