Merge pull request #1706 from McStasMcXtrace/patch-installdocs-macOS

Document install steps around macOS 15 tightened security

INSTALL-McStas/macOS/README.md

@@ -1,7 +1,7 @@
 # Installation of McStas 3.5.1 on macOS 
 
 ## Supported macOS releases
-* macOS 11-14 (Big Sur and later, fully supported python tool set. Supported on both Intel and Apple Silicon,
+* macOS 11-15 (Big Sur and later, fully supported python tool set. Supported on both Intel and Apple Silicon,
   via separate installation bundles.
 
 ## Steps to perform
@@ -12,7 +12,19 @@
 
 * Open the relevant folder for your local processor
 
-* Drag the McStas-3.5.1.app to /Applications and right-click + open to start the app. 
+* Drag the McStas-3.5.1.app to /Applications and right-click + open to start the app:<br/>
+![](screenshots/1_open-mcstas-from-Applications.png?raw=true)
+
+* Depending on your macOS version, security settings may initially prevent the app from opening, example from macOS 15 Sequoia:
+  - Initial warning that "McStas-3.5.1" was not opened<br/>
+  ![](screenshots/2_mcstas-not-opened.png?raw=true)
+  - Next, go to System Preferences, Privacy and Security and select to
+  "Open Anyway"<br/>
+  ![](screenshots/3_mcstas-settings-open-anyway.png?raw=true)
+  - You will then receive yet another warning<br/>
+  ![](screenshots/4_mcstas-open-anyway.png?raw=true)
+  - And finally give your password for installation to proceed<br/>
+  ![](screenshots/5_admin-password.png?raw=true)
 
 * As of 3.5.1 the macOS app bundles are fully based on conda-forge and will "self-inject" all dependencies on first launch. Please follow any on-screen instructions given.
 

INSTALL-McXtrace/macOS/README.md

@@ -1,7 +1,7 @@
 # Installation of McXtrace 3.5.1 on macOS 
 
 ## Supported macOS releases
-* macOS 11-14 (Big Sur and later, fully supported python tool set. Supported on both Intel and Apple Silicon,
+* macOS 11-15 (Big Sur and later, fully supported python tool set. Supported on both Intel and Apple Silicon,
   via separate installation bundles.
 
 ## Steps to perform
@@ -12,7 +12,19 @@
 
 * Open the relevant folder for your local processor
 
-* Drag the McXtrace-3.5.1.app to /Applications and right-click + open to start the app. 
+* Drag the McXtrace-3.5.1.app to /Applications and right-click + open to start the app:<br/>
+![](screenshots/1_open-mcxtrace-from-Applications.png?raw=true)
+
+* Depending on your macOS version, security settings may initially prevent the app from opening, example from macOS 15 Sequoia:
+  - Initial warning that "McXtrace-3.5.1" was not opened<br/>
+  ![](screenshots/2_mcxtrace-not-opened.png?raw=true)
+  - Next, go to System Preferences, Privacy and Security and select to
+  "Open Anyway"<br/>
+  ![](screenshots/3_mcxtrace-settings-open-anyway.png?raw=true)
+  - You will then receive yet another warning<br/>
+  ![](screenshots/4_mcxtrace-open-anyway.png?raw=true)
+  - And finally give your password for installation to proceed<br/>
+  ![](screenshots/5_admin-password.png?raw=true)
 
 * As of 3.5.1 the macOS app bundles are fully based on conda-forge and will "self-inject" all dependencies on first launch. Please follow any on-screen instructions given.