Update online docs for 3.0.21.0 release.

Author: kleinerm

docs/PsychLicenseHandling.md

@@ -48,6 +48,12 @@ use period to its maximum duration. When connected to the internet,
 Psychtoolbox will sync with the server at the first use in a session and  
 periodically every few hours.  
 
+If your local environments firewall prevents online license management from  
+working, see the section at the bottom for how to add firewall exception rules  
+to make it work anyway. Below that section you will also find instructions for  
+operating in a fully offline "air gapped" environment without any internet access.  
+The latter may require specially configured licenses, as our default licenses do  
+not support fully offline use.  
 
 # Subfunctions and their meaning  
 
@@ -100,6 +106,64 @@ machine has a properly paid, valid and active license associated with it.
 Our professional support personnel may ask you to provide such a token in  
 some cases.  
 
+[PsychLicenseHandling](PsychLicenseHandling)('News');  
+- Print latest stored news about Psychtoolbox, and also specifically related to  
+this license and activations. Psychtoolbox prints those messages automatically  
+once when they are new. This function will print them even if they have been  
+printed before.  
+  
+  
+# USE IN STRICTLY FIREWALLED ENVIRONMENTS  
+  
+If your firewall is blocking internet connections to our license servers,  
+you can configure it as follows to allow connecting to the license servers.  
+Follow the most recent instructions on this website for passthrough for EU data centers:  
+  
+https://docs.cryptlex.com/node-locked-licenses/proxies-and-firewall\#for-our-eu-data-center  
+  
+As of March 2025, the following configuration would be needed, but check above  
+website for up to date informations if in doubt:  
+  
+### The following IP addresses and URL should be whitelisted:  
+  
+   IP Addresses to Whitelist:  
+       75.2.113.112  
+       99.83.149.57  
+  
+   Web API URL to Whitelist:  
+       https://api.eu.cryptlex.com:443  
+  
+# OFFLINE USE IN AIR GAPPED ENVIRONMENTS  
+  
+Some non-standard software subscription licenses allow offline activation and  
+deactivation by use of the customer portal and passing forth and back offline  
+activation and deactivation request and response files. This allows use in air-  
+gapped environments without access to the public internet or to our license  
+servers. If your purchased license supports this, the functions are as follows:  
+  
+[PsychLicenseHandling](PsychLicenseHandling)('ActivateEnrolledKeyOffline', pathToOfflineRequestResponseFile);  
+- Either create an offline activation request file under the specified path/filename,  
+which allows creation of an offline activation response file in the customer portal,  
+or reads such an offline activation response file and activates your local machine.  
+  
+E.g., after enrolling a license key via [PsychLicenseHandling](PsychLicenseHandling)('Setup') or  
+[PsychLicenseHandling](PsychLicenseHandling)('Activate', licenseKey); do the following:  
+  
+1. [PsychLicenseHandling](PsychLicenseHandling)('ActivateEnrolledKeyOffline', 'offlineRequest.dat');  
+  
+2. Login to customer portal and upload 'offlineRequest.dat' to create offline  
+   response file, downloaded to the file 'offlineResponse.dat'.  
+  
+3. [PsychLicenseHandling](PsychLicenseHandling)('ActivateEnrolledKeyOffline', 'offlineResponse.dat') to  
+   activate this machine.  
+  
+[PsychLicenseHandling](PsychLicenseHandling)('DeactivateEnrolledKeyOffline', pathToOfflineProofFile);  
+- Deactivate the machine locally and write a deactivation proof file into the  
+path/filename 'pathToOfflineProofFile'. You can upload that proof file into  
+the customer portal to deactivate the machine in the license servers, so the  
+machine activation that has been freed up can be reused on a different machine.  
+Not all licenses allow offline deactivation of once activated machines.  
+  
 
 
 

docs/PsychPaidSupportAndServices.md

@@ -5,15 +5,15 @@
 If you are using a Psychtoolbox variant and version that requires a paid  
 software license key to function, e.g., on Microsoft Windows or Apple  
 macOS, then a few minutes of basic support per year for basic questions  
-may be included in the specific type of software license you bought. If,  
-when, and how much support will be provided is usually at the discretion  
+may be included in the specific type of software license you bought. If  
+at all, when, and how much support will be provided is at the discretion  
 of the Psychtoolbox team. In any case, if you wanted to ask for this  
 basic support, you'd have to present an authentication token by running  
 this function, or by calling [PsychLicenseHandling](PsychLicenseHandling)('AuthenticationToken').  
 
-If you require additional paid support regarding Psychtoolbox, or custom feature  
-development (or if you want to buy a Psychtoolbox themed coffee mug, bag or shirt)  
-go to the following website which provides such services:  
+If you require additional paid support regarding Psychtoolbox, or custom  
+feature development (or if you want to buy a Psychtoolbox themed coffee  
+mug, bag or shirt) go to the following website which provides such services:  
 
 https://www.psychtoolbox.net  
 
@@ -94,9 +94,9 @@ Psychtoolbox to be around and in good shape years into the future.
 To clarify: Psychtoolbox itself will stay open-source software. Anybody  
 able and willing to contribute code and ideas of sufficiently high quality  
 is invited to contribute to the open-source code, the documentation on our  
-public community website and Wiki  
-http://psychtoolbox.org, and to participate and help each other on the  
-public community forum https://psychtoolbox.discourse.group.  
+public community website and Wiki http://psychtoolbox.org, and to participate  
+and help each other on the public community forum under:  
+https://psychtoolbox.discourse.group  
 
 Support by our developers will be reserved to paying community members.  
 

docs/Psychtoolbox.md

@@ -2,7 +2,7 @@
 ##### >[Psychtoolbox](Psychtoolbox)
 
 Psychtoolbox.  
-Version 3.0.20      13 December 2024  
+Version 3.0.21      31 March 2025  
 
 The Psychophysics Toolbox is a collection of Octave and Matlab functions  
 that extend the language to give you exquisite control of your computer  
@@ -99,21 +99,25 @@ Perception 36 ECVP Abstract Supplement.
 
 ### IMPORTANT NEWS:  
 
-You can now financially contribute to Psychtoolbox sustainability, upkeep  
-and continued improvement by buying a "Psychtoolbox Support Membership", which  
-also includes some paid support for questions regarding its use, or issues  
-you may have with it. We also offer paid feature development and other  
-useful commercial services.  
+If you need paid support, you can buy a "Psychtoolbox Paid Support  
+Membership". We also offer paid feature development and other useful  
+commercial services.  
 
 Please type 'PsychPaidSupportAndServices' to learn more.  
 
-Psychtoolbox for Apple macOS and Microsoft Windows will require a paid software  
-license key to work very soon, likely starting sometime in January 2025. Until  
-then you can use it with a free time-limited trial license. Psychtoolbox will  
-connect to our network licensing servers after installation and after you have  
-given consent, to enable you to use it. For more information about this, type  
-'help PsychLicenseHandling'. Stay tuned for our announcement of start of sales  
-for these software license keys in early 2025.  
+Psychtoolbox mex files for Apple macOS and Microsoft Windows will require  
+a paid software license key to work, starting in April 2025. Already  
+existing and active installations of Psychtoolbox 3.0.20 or later from  
+before April will be usable with a free time-limited trial license until  
+14th April 2025. New first time installations of Psychtoolbox on a  
+machine, starting at 31st of March 2025, will work for free for up to 14  
+days after first use. After that time period, a paid subscription license  
+will be required.  
+  
+Psychtoolbox on macOS and Windows will connect to our network licensing  
+servers after installation and after you have given consent, to enable  
+you to use it. For more information about our license management, type  
+'help PsychLicenseHandling'.