From 16f86e437c04745504489188caa3d25066e83e14 Mon Sep 17 00:00:00 2001
From: Izzy <izzysoft@qumran.org>
Date: Tue, 13 Nov 2018 14:34:25 +0000
Subject: [PATCH] Improve descriptions of MAXS modules

---
 metadata/org.projectmaxs.module.alarmset.txt       | 2 ++
 metadata/org.projectmaxs.module.bluetooth.txt      | 3 +++
 metadata/org.projectmaxs.module.bluetoothadmin.txt | 3 +++
 metadata/org.projectmaxs.module.clipboard.txt      | 3 +++
 metadata/org.projectmaxs.module.fileread.txt       | 3 +++
 metadata/org.projectmaxs.module.filewrite.txt      | 3 +++
 metadata/org.projectmaxs.module.locationfine.txt   | 3 +++
 metadata/org.projectmaxs.module.misc.txt           | 3 +++
 metadata/org.projectmaxs.module.nfc.txt            | 2 ++
 metadata/org.projectmaxs.module.notification.txt   | 7 +++++++
 metadata/org.projectmaxs.module.phonestateread.txt | 2 ++
 metadata/org.projectmaxs.module.ringermode.txt     | 3 +++
 metadata/org.projectmaxs.module.shell.txt          | 2 ++
 metadata/org.projectmaxs.module.smsnotify.txt      | 3 +++
 metadata/org.projectmaxs.module.smsread.txt        | 3 +++
 metadata/org.projectmaxs.module.smssend.txt        | 3 +++
 metadata/org.projectmaxs.module.smswrite.txt       | 5 +++++
 metadata/org.projectmaxs.module.wifiaccess.txt     | 3 +++
 metadata/org.projectmaxs.module.wifichange.txt     | 3 +++
 metadata/org.projectmaxs.transport.xmpp.txt        | 4 ++++
 20 files changed, 63 insertions(+)

diff --git a/metadata/org.projectmaxs.module.alarmset.txt b/metadata/org.projectmaxs.module.alarmset.txt
index dd2b676bd8..967992f9b4 100644
--- a/metadata/org.projectmaxs.module.alarmset.txt
+++ b/metadata/org.projectmaxs.module.alarmset.txt
@@ -12,6 +12,8 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The AlarmSet module can be used to set arlarms, and to set and start timers.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.bluetooth.txt b/metadata/org.projectmaxs.module.bluetooth.txt
index 7f2d9156cc..56d2e6ad38 100644
--- a/metadata/org.projectmaxs.module.bluetooth.txt
+++ b/metadata/org.projectmaxs.module.bluetooth.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The Bluetooth module can be used to query the default bluetooth adapter for its
+status.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.bluetoothadmin.txt b/metadata/org.projectmaxs.module.bluetoothadmin.txt
index 73b8c5935d..e2f2940f3d 100644
--- a/metadata/org.projectmaxs.module.bluetoothadmin.txt
+++ b/metadata/org.projectmaxs.module.bluetoothadmin.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The BluetoothAdmin module can be used to enable or disable the bluetooth
+adapter.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.clipboard.txt b/metadata/org.projectmaxs.module.clipboard.txt
index bcffe7f551..6f041c8f94 100644
--- a/metadata/org.projectmaxs.module.clipboard.txt
+++ b/metadata/org.projectmaxs.module.clipboard.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The Clipboard module can be used to set and retrieve the content of the Android
+clipboard.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.fileread.txt b/metadata/org.projectmaxs.module.fileread.txt
index d4e67cb254..622fc5eee8 100644
--- a/metadata/org.projectmaxs.module.fileread.txt
+++ b/metadata/org.projectmaxs.module.fileread.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The FileRead module can be used to browse the storage device. Send files over
+''transports'' that allow it.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.filewrite.txt b/metadata/org.projectmaxs.module.filewrite.txt
index 50a70b2f77..a9a2e03b14 100644
--- a/metadata/org.projectmaxs.module.filewrite.txt
+++ b/metadata/org.projectmaxs.module.filewrite.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The FileWrite module can be used to write, modify (rename, move, …) and delete
+files on the external storage.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.locationfine.txt b/metadata/org.projectmaxs.module.locationfine.txt
index 5ae6a85de7..c1f04c3e20 100644
--- a/metadata/org.projectmaxs.module.locationfine.txt
+++ b/metadata/org.projectmaxs.module.locationfine.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The LocationFine module can be used to locate the device using the best possible
+locate mechanism available (fine location).
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.misc.txt b/metadata/org.projectmaxs.module.misc.txt
index 1a338d9832..2a68c0ec11 100644
--- a/metadata/org.projectmaxs.module.misc.txt
+++ b/metadata/org.projectmaxs.module.misc.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The Misc module provides miscellaneous commands that require no special
+permission.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.nfc.txt b/metadata/org.projectmaxs.module.nfc.txt
index 1e51ccfe03..f0419fe0e2 100644
--- a/metadata/org.projectmaxs.module.nfc.txt
+++ b/metadata/org.projectmaxs.module.nfc.txt
@@ -12,6 +12,8 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The NFC module can be used to query the default NFC adapter for its status.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.notification.txt b/metadata/org.projectmaxs.module.notification.txt
index 3d9ade9437..c61d7cab1c 100644
--- a/metadata/org.projectmaxs.module.notification.txt
+++ b/metadata/org.projectmaxs.module.notification.txt
@@ -12,6 +12,13 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The Notification module can be used to listen for new notifications and inform
+the user.
+
+You need to allow the access to the notifications in Settings → Security →
+Notification access. The module allows you to configure when to notify you about
+Android notifications: when posted, when removed.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.phonestateread.txt b/metadata/org.projectmaxs.module.phonestateread.txt
index be674e7b35..659ea2b0bc 100644
--- a/metadata/org.projectmaxs.module.phonestateread.txt
+++ b/metadata/org.projectmaxs.module.phonestateread.txt
@@ -12,6 +12,8 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The PhonestateRead module can be used to get notified about incoming calls.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.ringermode.txt b/metadata/org.projectmaxs.module.ringermode.txt
index e127c10139..c7409d5d43 100644
--- a/metadata/org.projectmaxs.module.ringermode.txt
+++ b/metadata/org.projectmaxs.module.ringermode.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The RingerMode module can be used to display and change the ringer mode
+(silent/vibration/normal).
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.shell.txt b/metadata/org.projectmaxs.module.shell.txt
index 7e02fa51ed..d0539af787 100644
--- a/metadata/org.projectmaxs.module.shell.txt
+++ b/metadata/org.projectmaxs.module.shell.txt
@@ -12,6 +12,8 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The Shell module can be used to execute a shell command and return the result.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.smsnotify.txt b/metadata/org.projectmaxs.module.smsnotify.txt
index 13ab10e0a1..e851256a2a 100644
--- a/metadata/org.projectmaxs.module.smsnotify.txt
+++ b/metadata/org.projectmaxs.module.smsnotify.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The SmsNotify module can be used to get notified about new incoming SMS
+messages. It optionally makes use of the ContactsRead module, if installed.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.smsread.txt b/metadata/org.projectmaxs.module.smsread.txt
index d92b2ca2e2..757fa64248 100644
--- a/metadata/org.projectmaxs.module.smsread.txt
+++ b/metadata/org.projectmaxs.module.smsread.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The SmsRead module can be used to query the system's SMS database for messages.
+It can optionally make use of the ContactsRead module, if installed.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.smssend.txt b/metadata/org.projectmaxs.module.smssend.txt
index 08855a2fe2..50d807f7ca 100644
--- a/metadata/org.projectmaxs.module.smssend.txt
+++ b/metadata/org.projectmaxs.module.smssend.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The SmsSend module can be used to send SMS messages. It can optionally make use
+of the ContactsRead and SmsWrite modules, if installed.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.smswrite.txt b/metadata/org.projectmaxs.module.smswrite.txt
index 89cfdca2a4..cc40b4642a 100644
--- a/metadata/org.projectmaxs.module.smswrite.txt
+++ b/metadata/org.projectmaxs.module.smswrite.txt
@@ -12,6 +12,11 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The SmsWrite module can be used to modify the system's SMS database, e.g. add
+new messages to it. The main purpose is to add messages send by module-smssend,
+to the outbox. It can optionally make use of the ContactsRead module, if
+installed.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.wifiaccess.txt b/metadata/org.projectmaxs.module.wifiaccess.txt
index c29bf09f5f..6b463e491f 100644
--- a/metadata/org.projectmaxs.module.wifiaccess.txt
+++ b/metadata/org.projectmaxs.module.wifiaccess.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The WifiAccess module can be used to query the current state of the WiFi
+subsystem.
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.module.wifichange.txt b/metadata/org.projectmaxs.module.wifichange.txt
index 95684070da..de2574e2b3 100644
--- a/metadata/org.projectmaxs.module.wifichange.txt
+++ b/metadata/org.projectmaxs.module.wifichange.txt
@@ -12,6 +12,9 @@ Summary:A Module for MAXS
 Description:
 This is a Module for MAXS, which does not install any launcher. You need "MAXS
 Main" and a configured MAXS Transport to make use of it.
+
+The WifiChange module can be used to perform changes to the WiFi subsystem
+(enable/disable WiFi).
 .
 
 Repo Type:srclib
diff --git a/metadata/org.projectmaxs.transport.xmpp.txt b/metadata/org.projectmaxs.transport.xmpp.txt
index d86643e5fd..4acd0930e5 100644
--- a/metadata/org.projectmaxs.transport.xmpp.txt
+++ b/metadata/org.projectmaxs.transport.xmpp.txt
@@ -12,6 +12,10 @@ Summary:XMPP Transport for MAXS
 Description:
 This is the XMPP Transport for MAXS, which does not install any launcher. You
 need "MAXS Main" and preferably some MAXS Modules to make use of it!
+
+MAXS Transport XMPP acts as gateway between MAXS and the Extensible Messaging
+and Presence Protocol (XMPP). It enables MAXS to receive commands and send
+responses or notifications via XMPP.
 .
 
 Repo Type:srclib