livecode · livecodepanos · Aug 29, 2018 · Jun 22, 2018 · Jul 20, 2018 · Jul 23, 2018
diff --git a/.gitignore b/.gitignore
@@ -20,11 +20,12 @@ encryptedstack.cpp
 encryptedstack.h
 stacksecurity_encrypted.cpp
 util/perfect/perfect.linux-*
-extensions/*/*/*.xml
-extensions/*/*/*.lci
-extensions/*/*/*.lcm
-extensions/*/*/*.lce
-extensions/*/*/api.lcdoc
+**/extensions/*/*/*.xml
+**/extensions/*/*/*.lci
+**/extensions/*/*/*.lcm
+**/extensions/*/*/*.lce
+**/extensions/*/*/api.lcdoc
+*/src/.lci/*
 
 # Compiled source and intermediates #
 ###################

diff --git a/Makefile.common b/Makefile.common
@@ -43,6 +43,10 @@ guess_linux_arch_script := \
 	case `uname -p` in \
 	    x86_64) echo x86_64 ;; \
 	    x86|i*86) echo x86 ;; \
+	    unknown) case `uname -m` in \
+	        x86_64) echo x86_64 ;; \
+                x86|i*86) echo x86 ;; \
+	    esac ;; \
 	esac
 guess_linux_arch := $(shell $(guess_linux_arch_script))
 

diff --git a/docs/development/testing.md b/docs/development/testing.md
@@ -61,18 +61,33 @@ Before running each test command, the test framework inserts a test library stac
 * `TestAssert pDescription, pExpectTrue`: Make a test assertion.  The test is recorded as a failure if *pExpectTrue* is false.  *pDescription* should be a short string that describes the test (e.g. "clipboard is clear").
 * `TestSkip pDescription, pReasonSkipped`: Record a test as having been skipped.  *pReasonSkipped* should be a short explanation of why the test was skipped (e.g. "not supported on Windows").
 * `TestSkipIf pRequirement, pOptions`: Skip a test if the requirements 
-are met. `pOptions` varies depending on the `pRequirement` enum. The
-following requirements are implemented:
-   - `ide` - the IDE repo is available. No options.
+are met. `pOptions` varies depending on the `pRequirement` enum (if no 
+options are explicitly specified then no options are available for that
+particular `pRequirement`. The following requirements are implemented:
+   - `ide` - the IDE repo is available
    - `lcb` - LCB compilation supported
-   - `docs` - the docs are available. No options.
+   - `docs` - the docs are available
+   - `standalone` - the test is running in the standalone test runner
    - `securityPermissions` - Option `set` to skip if a test should not
    set the `securityPermissions`
    - `platform` - options are comma delimited platform strings
    - `processor` - options are comma delimited processor strings
    - `stack` - options are comma delimited stack names to test if they
    are available
    - `environment` - options are comma delimited environment strings
+   - `clipboard` - access to the clipboard is available
+   - `wait` - the `wait` command is available and works as expected
+   - `security` - the security module is available
+   - `write` - write access to the filesystem is available
+   - `ui` - the test is running in a graphical environment (as opposed
+   to the command line)
+   - `desktop` - the test is running on a desktop computer
+   - `mobile` - the test is running on a mobile device
+   - `external` - an external module can be loaded/used. Options are a
+   comma delimited list of external module names
+   - `database` - an database module can be loaded/used. Options are a
+   comma delimited list of external module names
+   - `jvm` - the Java Virtual Machine is available
 * `TestSkipIfNot pRequirement, pOptions`: Skip a test if the 
 requirements are not met. Requirements and options are the same as for 
 `TestSkipIf`.

diff --git a/docs/dictionary/command/androidRequestPermission.lcdoc b/docs/dictionary/command/androidRequestPermission.lcdoc
@@ -0,0 +1,65 @@
+Name: androidRequestPermission
+
+Type: command
+
+Syntax: androidRequestPermission <permissionName>
+
+Summary:
+Displays a dialog showing a permission request for <permissionName>. If a user has already granted permission for <permissionName>, this command does nothing.
+
+Introduced: 9.0.1
+
+OS: android
+
+Platforms: mobile
+
+Example:
+local tCameraPermissionGranted
+put androidHasPermission("android.permission.CAMERA") into tCameraPermissionGranted
+if not tCameraPermissionGranted then
+   androidRequestPermission "android.permission.CAMERA"
+end if
+put androidHasPermission("android.permission.CAMERA") into tCameraPermissionGranted
+if not tCameraPermissionGranted then
+   answer "This app is not permitted to access the device camera. You can change this" && \
+         "in the Settings app."
+end if
+
+
+Parameters:
+permissionName (enum):
+The name of the permission to request.
+
+-   "android.permission.READ_CALENDAR": permission to allow an application to read the device's calendar.
+-   "android.permission.WRITE_CALENDAR": permission to allow an application to write to the device's calendar.
+-   "android.permission.CAMERA": permission to allow an application to access the device's camera.
+-   "android.permission.ACCESS_COARSE_LOCATION": permission to allow an application to access the device's coarse location.
+-   "android.permission.ACCESS_FINE_LOCATION": permission to allow an application to access the device's fine location.
+-   "android.permission.READ_CONTACTS": permission to allow an application to read data from the device's contacts.
+-   "android.permission.WRITE_CONTACTS": permission to allow an application to write date to the device's contacts.
+-   "android.permission.GET_ACCOUNTS": permission to allow an application to access to the list of accounts in the Accounts Service.
+-   "android.permission.RECORD_AUDIO": permission to allow an application to allow an application to record audio.
+-   "android.permission.READ_EXTERNAL_STORAGE": permission to allow an application to read data from the device's external storage.
+-   "android.permission.WRITE_EXTERNAL_STORAGE": permission to allow an application to write data to the device's external storage.
+-   "android.permission.READ_PHONE_STATE": permission to allow an application to access phone state, including the phone number of the device, current cellular network information, the status of any ongoing calls, and a list of any PhoneAccounts registered on the device.
+-   "android.permission.READ_PHONE_NUMBERS": permission to allow an application to access the device's phone number(s).
+-   "android.permission.CALL_PHONE": permission to allow an application to initiate a phone call without going through the Dialer user interface for the user to confirm the call. 
+-   "android.permission.ANSWER_PHONE_CALLS": permission to allow an application to answer an incoming phone call.
+-   "android.permission.READ_CALL_LOG": permission to allow an application to read the user's call log.
+-   "android.permission.WRITE_CALL_LOG": permission to allow an application to write to the user's call log.
+-   "android.permission.ADD_VOICEMAIL": permission to allow an application to add voicemails into the system.
+-   "android.permission.USE_SIP": permission to allow an application to use SIP service.
+-   "android.permission.PROCESS_OUTGOING_CALLS": permission to allow an application to see the number being dialed during an outgoing call with the option to redirect the call to a different number or abort the call altogether.
+-   "android.permission.SEND_SMS": permission to allow an application to send SMS messages.
+-   "android.permission.RECEIVE_SMS": permission to allow an application to receive SMS messages
+-   "android.permission.READ_SMS": permission to allow an application to read SMS messages.
+-   "android.permission.RECEIVE_WAP_PUSH": permission to allow an application to receive WAP push messages.
+-   "android.permission.RECEIVE_MMS": permission to allow an application to receive MMS messages.
+-   "android.permission.BODY_SENSORS": permission to allow an application to access data from sensors that the user uses to measure what is happening inside his/her body, such as heart rate.
+
+
+
+Description:
+Use the <androidRequestPermission> command to request permission for <permissionName> from the user.
+
+>*Note:* Permission names are case sensitive.
diff --git a/docs/dictionary/command/mobilePickMedia.lcdoc b/docs/dictionary/command/mobilePickMedia.lcdoc
@@ -76,15 +76,17 @@ to select multiple items on iOS, the user has to select the Done button,
 once all of the selections have been made.
 
 The remaining arguments specify the type of media items the user should
-> be allowed to select from the iPod library. On Android, it is not
-> necessary to specify any arguments. The application that is launched
-> is in control of the audio media types that are to be selected.
+be allowed to select from the iPod library. On Android, it is not
+necessary to specify any arguments. The application that is launched
+is in control of the audio media types that are to be selected.
 >*Note:* <mobilePickMedia> does not return anything for m4p files or
 > iCloud files that are not physically on the device, even if they are
 > displayed in the picker itself.
+
 >*Note:* On iOS, <mobilePickMedia> returns references to the iTunes data
 > store on the iOS device. These media references can only be played
 > with the <mobilePlaySoundOnChannel> command.
+
 >*Note:* <mobilePickMedia> is not available on the iOS simulator.
 
 References: mobilePlaySoundOnChannel (command), mobilePick (command),

diff --git a/docs/dictionary/command/mobilePickPhoto.lcdoc b/docs/dictionary/command/mobilePickPhoto.lcdoc
@@ -23,15 +23,13 @@ mobilePickPhoto "front camera", 250, 250
 
 Parameters:
 source (enum):
-The source for the image. One of:
+The source for the image.
 
-- "library"
-- "album"
-- "camera"
-
-
--   "rear camera": iOS only
--   "front camera": iOS only
+- "library":
+- "album":
+- "camera":
+- "rear camera": iOS only
+- "front camera": iOS only
 
 
 maxwidth:

diff --git a/docs/dictionary/command/mobilePlaySoundOnChannel.lcdoc b/docs/dictionary/command/mobilePlaySoundOnChannel.lcdoc
@@ -33,8 +33,6 @@ channel:
 The name of the channel to play the sound on.
 
 type (enum):
-One of:
-
 -   "now": The sound is played immediately, replacing any current sound
     (and queued sound) on the channel.
 -   "next": The sound is queued to play immediately after the current

diff --git a/docs/dictionary/command/mobileSetLocationHistoryLimit.lcdoc b/docs/dictionary/command/mobileSetLocationHistoryLimit.lcdoc
@@ -57,21 +57,19 @@ sample provided with the <locationChanged> event (which will always be
 the last sample in the history). e.g.
 
     on locationChanged
-
-    local tHistory
-    put mobileGetLocationHistory() into tHistory
-    repeat for each element tSample in tHistory
-
-    processLocationChanged tSample
-
-    end repeat
+        local tHistory
+        put mobileGetLocationHistory() into tHistory
+        repeat for each element tSample in tHistory
+            processLocationChanged tSample
+        end repeat
     end locationChanged
 
 
 References: mobileStopTrackingSensor (command),
-mobileStartTrackingSensor (command), mobileGetLocationHistory (function),
+mobileStartTrackingSensor (command),
+mobileGetLocationHistory (function),
 mobileGetLocationHistoryLimit (function),
 mobileSensorAvailable (function), mobileSensorReading (function),
-mobileLocationAuthorizationStatus (function), locationChanged (message),
-trackingError (message)
+mobileLocationAuthorizationStatus (function),
+locationChanged (message), trackingError (message)
 
diff --git a/docs/dictionary/command/mobileStartTrackingSensor.lcdoc b/docs/dictionary/command/mobileStartTrackingSensor.lcdoc
@@ -33,9 +33,9 @@ loosely (enum):
 How accurate the readings from sensors should be. The default value is
 false 
 
--   "true": readings are determined without using accurate(but power
+-   "true": readings are determined without using accurate (but power
     consuming) sources such as GPS.
--   "false": readings are determined using accurate(but power consuming)
+-   "false": readings are determined using accurate (but power consuming)
     sources such as GPS.
 
 

diff --git a/docs/dictionary/function/androidHasPermission.lcdoc b/docs/dictionary/function/androidHasPermission.lcdoc
@@ -0,0 +1,66 @@
+Name: androidHasPermission
+
+Type: function
+
+Syntax: androidHasPermission(<permissionName>)
+
+Summary:
+Returns if permission <permissionName> has been granted by the user.
+
+Introduced: 9.0.1
+
+OS: android
+
+Platforms: mobile
+
+Example:
+local tLocationPermissionGranted
+put androidHasPermission("android.permission.ACCESS_FINE_LOCATION") into tLocationPermissionGranted
+if not tLocationPermissionGranted then
+   androidRequestPermission "android.permission.ACCESS_FINE_LOCATION"
+end if
+if not tLocationPermissionGranted then
+   answer "This app is not permitted to access the device location. You can change this" && \
+         "in the Settings app."
+end if
+
+
+Parameters:
+permissionName (enum):
+The name of the permission to request.
+
+-   "android.permission.READ_CALENDAR": permission to allow an application to read the device's calendar.
+-   "android.permission.WRITE_CALENDAR": permission to allow an application to write to the device's calendar.
+-   "android.permission.CAMERA": permission to allow an application to access the device's camera.
+-   "android.permission.ACCESS_COARSE_LOCATION": permission to allow an application to access the device's coarse location.
+-   "android.permission.ACCESS_FINE_LOCATION": permission to allow an application to access the device's fine location.
+-   "android.permission.READ_CONTACTS": permission to allow an application to read data from the device's contacts.
+-   "android.permission.WRITE_CONTACTS": permission to allow an application to write date to the device's contacts.
+-   "android.permission.GET_ACCOUNTS": permission to allow an application to access to the list of accounts in the Accounts Service.
+-   "android.permission.RECORD_AUDIO": permission to allow an application to allow an application to record audio.
+-   "android.permission.READ_EXTERNAL_STORAGE": permission to allow an application to read data from the device's external storage.
+-   "android.permission.WRITE_EXTERNAL_STORAGE": permission to allow an application to write data to the device's external storage.
+-   "android.permission.READ_PHONE_STATE": permission to allow an application to access phone state, including the phone number of the device, current cellular network information, the status of any ongoing calls, and a list of any PhoneAccounts registered on the device.
+-   "android.permission.READ_PHONE_NUMBERS": permission to allow an application to access the device's phone number(s).
+-   "android.permission.CALL_PHONE": permission to allow an application to initiate a phone call without going through the Dialer user interface for the user to confirm the call. 
+-   "android.permission.ANSWER_PHONE_CALLS": permission to allow an application to answer an incoming phone call.
+-   "android.permission.READ_CALL_LOG": permission to allow an application to read the user's call log.
+-   "android.permission.WRITE_CALL_LOG": permission to allow an application to write to the user's call log.
+-   "android.permission.ADD_VOICEMAIL": permission to allow an application to add voicemails into the system.
+-   "android.permission.USE_SIP": permission to allow an application to use SIP service.
+-   "android.permission.PROCESS_OUTGOING_CALLS": permission to allow an application to see the number being dialed during an outgoing call with the option to redirect the call to a different number or abort the call altogether.
+-   "android.permission.SEND_SMS": permission to allow an application to send SMS messages.
+-   "android.permission.RECEIVE_SMS": permission to allow an application to receive SMS messages
+-   "android.permission.READ_SMS": permission to allow an application to read SMS messages.
+-   "android.permission.RECEIVE_WAP_PUSH": permission to allow an application to receive WAP push messages.
+-   "android.permission.RECEIVE_MMS": permission to allow an application to receive MMS messages.
+-   "android.permission.BODY_SENSORS": permission to allow an application to access data from sensors that the user uses to measure what is happening inside his/her body, such as heart rate.
+
+Returns(boolean):
+True if permission has been granted, false otherwise.
+
+
+Description:
+Use the <androidRequestPermission> function to find out if permission <permissionName> has been granted by the user.
+
+>*Note:* Permission names are case sensitive.
diff --git a/docs/dictionary/function/androidPermissionExists.lcdoc b/docs/dictionary/function/androidPermissionExists.lcdoc
@@ -0,0 +1,33 @@
+Name: androidPermissionExists
+
+Type: function
+
+Syntax: androidPermissionExists(<permissionName>)
+
+Summary:
+Returns true if <permissionName> is a valid Android permission name
+
+Introduced: 9.0.1
+
+OS: android
+
+Platforms: mobile
+
+Example:
+
+if not androidPermissionExists(pPermission) then
+   answer pPermission && "is not a valid permission name"
+end if
+
+
+Parameters:
+permissionName (string):
+The name of the permission to check.
+
+Returns(boolean):
+True if <permissionName> is a valid Android permission name, false otherwise.
+
+Description:
+Use the <androidPermissionExists> function to check if <permissionName> is a valid Android permission name.
+
+>*Note:* Permission names are case sensitive.