R8 no beta

add_headers.py

@@ -0,0 +1,42 @@
+import os
+
+# Chemin du dossier contenant les fichiers Markdown
+folder_path = r"c:\Github\docs\docs\aikit"
+
+def generate_header(file_name, title):
+    # Génère le header avec id et title
+    id_value = file_name.lower().replace(" ", "-").replace(".md", "")
+    return f"---\nid: {id_value}\ntitle: {title}\n---\n\n"
+
+def process_markdown_files(folder_path):
+    for file_name in os.listdir(folder_path):
+        if file_name.endswith(".md"):
+            file_path = os.path.join(folder_path, file_name)
+
+            with open(file_path, "r", encoding="utf-8") as file:
+                lines = file.readlines()
+
+            # Trouver le premier titre (#)
+            title = None
+            for line in lines:
+                if line.startswith("# "):  # Rechercher un titre de niveau 1
+                    title = line[2:].strip()
+                    break
+
+            if title:
+                # Générer le header
+                header = generate_header(file_name, title)
+
+                # Vérifier si le header existe déjà
+                if not lines[0].startswith("---"):
+                    # Ajouter le header au début du fichier
+                    with open(file_path, "w", encoding="utf-8") as file:
+                        file.write(header + "".join(lines))
+                    print(f"Header ajouté dans : {file_name}")
+                else:
+                    print(f"Header déjà présent dans : {file_name}")
+            else:
+                print(f"Aucun titre trouvé dans : {file_name}")
+
+# Exécuter le script
+process_markdown_files(folder_path)

docs/API/CollectionClass.md

@@ -2418,10 +2418,9 @@ $strings2:=$strings1.orderByMethod(Function(sortCollection);sk strict)
 The ***sortCollection*** method:
 
 ```4d
-var $1 : Object
-var $2: Integer // sort option
+#DECLARE ($toSort : Object ; $option : Integer)
 
-$1.result:=(Compare strings($1.value;$1.value2;$2)<0)
+$toSort.result:=(Compare strings($toSort.value;$toSort.value2;$option2)<0)
 ```
 
 <!-- END REF -->

docs/API/DataClassClass.md

@@ -56,7 +56,7 @@ Returned attribute objects contain the following properties:
 |autoFilled|Boolean|True if the attribute value is automatically filled by 4D. Corresponds to the following 4D field properties: "Autoincrement" for numeric type fields and "Auto UUID" for UUID (alpha) fields. Not returned if `.kind` = "relatedEntity" or "relatedEntities". |
 |exposed|Boolean|True if the attribute is exposed in REST|
 |fieldNumber|integer|Internal 4D field number of the attribute. Not returned if `.kind` = "relatedEntity" or "relatedEntities". |
-|fieldType|Integer|4D database field type of the attribute. Depends on the attribute `kind`. Possible values: <li>if `.kind` = "storage": corresponding 4D field type, see [`Value type`](https://doc.4d.com/4dv20/help/command/en/page1509.html)</li><li>if `.kind` = "relatedEntity": 38 (`is object`)</li><li>if `.kind` = "relatedEntities": 42 (`is collection`)</li><li>if `.kind` = "calculated" or "alias" = same as above, depending on the resulting value (field type, relatedEntity or relatedEntities)</li>|
+|fieldType|Integer|4D database field type of the attribute. Depends on the attribute `kind`. Possible values: <li>if `.kind` = "storage": corresponding 4D field type, see [`Value type`](../commands-legacy/value-type.md)</li><li>if `.kind` = "relatedEntity": 38 (`is object`)</li><li>if `.kind` = "relatedEntities": 42 (`is collection`)</li><li>if `.kind` = "calculated" or "alias" = same as above, depending on the resulting value (field type, relatedEntity or relatedEntities)</li>|
 |indexed|Boolean|True if there is a B-tree or a Cluster B-tree index on the attribute. Not returned if `.kind` = "relatedEntity" or "relatedEntities". |
 |inverseName|Text|Name of the attribute which is at the other side of the relation. Returned only when `.kind` = "relatedEntity" or "relatedEntities".|
 |keywordIndexed|Boolean|True if there is a keyword index on the attribute. Not returned if `.kind` = "relatedEntity" or "relatedEntities". |

docs/API/DataStoreClass.md

@@ -561,7 +561,7 @@ This function must be called on a remote 4D, otherwise it returns an empty colle
 
 Collection of stacked request objects. The most recent request has index 0.
 
-For a description of the ORDA request log format, please refer to the [**ORDA client requests**](https://doc.4d.com/4Dv18/4D/18/Description-of-log-files.300-4575486.en.html#4385373) section.
+For a description of the ORDA request log format, please refer to the [**ORDA requests**](../Debugging/debugLogFiles.md#orda-requests) section.
 
 #### Example
 

docs/API/FileClass.md

@@ -240,7 +240,8 @@ You want to delete a specific file in the database folder:
 
 |Release|Changes|
 |---|---|
-|19|Added
+|20 R9|Read UUIDs in macOS executables|
+|19|Added|
 </details>
 
 <!--REF #FileClass.getAppInfo().Syntax -->**.getAppInfo**() : Object<!-- END REF -->
@@ -249,21 +250,28 @@ You want to delete a specific file in the database folder:
 <!--REF #FileClass.getAppInfo().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|Result|Object|<-|Contents of .exe/.dll version resource or .plist file|
+|Result|Object|<-|Application file information|
 <!-- END REF -->
 
 
 #### Description
 
-The `.getAppInfo()` function <!-- REF #FileClass.getAppInfo().Summary -->returns the contents of a **.exe**, **.dll** or **.plist** file information as an object<!-- END REF -->.
+The `.getAppInfo()` function <!-- REF #FileClass.getAppInfo().Summary -->returns the contents of an application file information as an object<!-- END REF -->.
+
+The function must be used with an existing, supported file: **.plist** (all platforms), **.exe**/**.dll** (Windows), or **macOS executable**. If the file does not exist on disk or is not a supported file, the function returns an empty object (no error is generated).
+
+**Returned object with a .plist file (all platforms)**
 
-The function must be used with an existing .exe, .dll or .plist file. If the file does not exist on disk or is not a valid .exe, .dll or .plist file, the function returns an empty object (no error is generated).
+The xml file contents is parsed and keys are returned as properties of the object, preserving their types (text, boolean, number). `.plist dict` is returned as a JSON object and `.plist array` is returned as a JSON array.
+
+:::note
 
-> The function only supports .plist files in xml format (text-based). An error is returned if it is used with a .plist file in binary format.  
+The function only supports .plist files in xml format (text-based). An error is returned if it is used with a .plist file in binary format.  
 
-**Returned object with a .exe or .dll file**
+:::
 
-> Reading a .exe or .dll is only possible on Windows.
+
+**Returned object with a .exe or .dll file (Windows only)**
 
 All property values are Text.
 
@@ -278,11 +286,37 @@ All property values are Text.
 |FileVersion|Text|
 |OriginalFilename|Text|
 
-**Returned object with a .plist file**
+**Returned object with a macOS executable file (macOS only)**
 
-The xml file contents is parsed and keys are returned as properties of the object, preserving their types (text, boolean, number). `.plist dict` is returned as a JSON object and `.plist array` is returned as a JSON array.
+:::note
 
-#### Example
+A macOS executable file is located within a package (e.g. myApp.app/Contents/MacOS/myApp).
+
+:::
+
+The function returns an `archs` object that contains a collection of objects describing every architecture found in the executable (a fat executable can embed several architectures). Every object of the collection contains the following properties:
+
+|Property|Type|Description|
+|---|---|---|
+|name|Text|Name of architecture ("arm64" or "x86_64")|
+|type|Number|Numerical identifier of the architecture|
+|uuid|Text|Textual representation of the executable uuid|
+
+
+
+#### Example 1
+
+```4d
+  // display copyright info of an info.plist (any platform)
+var $infoPlistFile : 4D.File
+var $info : Object
+$infoPlistFile:=File("/RESOURCES/info.plist")
+$info:=$infoPlistFile.getAppInfo()
+ALERT($info.Copyright)
+```
+
+
+#### Example 2
 
 ```4d
  // display copyright info of application .exe file (windows)
@@ -291,15 +325,38 @@ var $info : Object
 $exeFile:=File(Application file; fk platform path)
 $info:=$exeFile.getAppInfo()
 ALERT($info.LegalCopyright)
+```
 
-  // display copyright info of an info.plist (any platform)
-var $infoPlistFile : 4D.File
-var $info : Object
-$infoPlistFile:=File("/RESOURCES/info.plist")
-$info:=$infoPlistFile.getAppInfo()
-ALERT($info.Copyright)
+
+#### Example 3
+
+```4d
+ // Get uuids of an application (macOS)
+var $app:=File("/Applications/myApp.app/Contents/MacOS/myApp")
+var $info:=$app.getAppInfo()
 ```
 
+Result in *$info*:
+
+```json
+{
+  "archs":
+  [
+      {
+        "name":"x86_64",
+        "type":16777223,
+        "uuid":"3840983CDA32392DA4D1D32F08AB3212"
+      },
+      {
+        "name":"arm64",
+        "type":16777228,
+        "uuid":"E49F6BA275B931DDA183C0B0CDF0ADAF"
+      }
+  ]
+}
+```
+
+
 #### See also
 
 [.setAppInfo()](#setappinfo)
@@ -497,6 +554,7 @@ You want to rename "ReadMe.txt" in "ReadMe_new.txt":
 
 |Release|Changes|
 |---|---|
+|20 R9|Read UUIDs in macOS executables|
 |20|Support of WinIcon|
 |19|Added|
 </details>
@@ -507,20 +565,34 @@ You want to rename "ReadMe.txt" in "ReadMe_new.txt":
 <!--REF #FileClass.setAppInfo().Params -->
 |Parameter|Type||Description|
 |---|---|---|---|
-|info|Object|->|Properties to write in .exe/.dll version resource or .plist file|
+|info|Object|->|Properties to write in an application file information|
 <!-- END REF -->
 
 #### Description
 
-The `.setAppInfo()` function <!-- REF #FileClass.setAppInfo().Summary -->writes the *info* properties as information contents of a **.exe**, **.dll** or **.plist** file<!-- END REF -->.
+The `.setAppInfo()` function <!-- REF #FileClass.setAppInfo().Summary -->writes the *info* properties as information contents of an application file<!-- END REF -->.
+
+The function must be used with an existing, supported file: **.plist** (all platforms), **.exe**/**.dll** (Windows), or **macOS executable**. If the file does not exist on disk or is not a supported file, the function does nothing (no error is generated).
+
+***info* parameter object with a .plist file (all platforms)**
 
-The function must be used with an existing .exe, .dll or .plist file. If the file does not exist on disk or is not a valid .exe, .dll or .plist file, the function does nothing (no error is generated).
+:::note
 
-> The function only supports .plist files in xml format (text-based). An error is returned if it is used with a .plist file in binary format.
+The function only supports .plist files in xml format (text-based). An error is returned if it is used with a .plist file in binary format.
 
-***info* parameter object with a .exe or .dll file**
+:::
+
+Each valid property set in the *info* object parameter is written in the .plist file as a key. Any key name is accepted. Value types are preserved when possible.
+
+If a key set in the *info* parameter is already defined in the .plist file, its value is updated while keeping its original type. Other existing keys in the .plist file are left untouched.  
+
+:::note
 
-> Writing a .exe or .dll file information is only possible on Windows.
+To define a Date type value, the format to use is a json timestamp string formated in ISO UTC without milliseconds ("2003-02-01T01:02:03Z") like in the Xcode plist editor.
+
+:::
+
+***info* parameter object with a .exe or .dll file (Windows only)**
 
 Each valid property set in the *info* object parameter is written in the version resource of the .exe or .dll file. Available properties are (any other property will be ignored):
 
@@ -540,15 +612,34 @@ For all properties except `WinIcon`, if you pass a null or empty text as value,
 
 For the `WinIcon` property, if the icon file does not exist or has an incorrect format, an error is generated.
 
-***info* parameter object with a .plist file**
+***info* parameter object with a macOS executable file (macOS only)**
 
-Each valid property set in the *info* object parameter is written in the .plist file as a key. Any key name is accepted. Value types are preserved when possible.
+*info* must be an object with a single property named `archs` that is a collection of objects in the format returned by [`getAppInfo()`](#getappinfo). Each object must contain at least the `type` and `uuid` properties (`name` is not used).
 
-If a key set in the *info* parameter is already defined in the .plist file, its value is updated while keeping its original type. Other existing keys in the .plist file are left untouched.  
+Every object in the *info*.archs collection must contain the following properties:
 
-> To define a Date type value, the format to use is a json timestamp string formated in ISO UTC without milliseconds ("2003-02-01T01:02:03Z") like in the Xcode plist editor.
+|Property|Type|Description|
+|---|---|---|
+|type|Number|Numerical identifier of the architecture to modify|
+|uuid|Text|Textual representation of the new executable uuid|
 
-#### Example
+#### Example 1
+
+```4d
+  // set some keys in an info.plist file (all platforms)
+var $infoPlistFile : 4D.File
+var $info : Object
+$infoPlistFile:=File("/RESOURCES/info.plist")
+$info:=New object
+$info.Copyright:="Copyright 4D 2023" //text
+$info.ProductVersion:=12 //integer
+$info.ShipmentDate:="2023-04-22T06:00:00Z" //timestamp
+$info.CFBundleIconFile:="myApp.icns" //for macOS
+$infoPlistFile.setAppInfo($info)
+```
+
+
+#### Example 2
 
 ```4d
   // set copyright, version and icon of a .exe file (Windows)
@@ -563,19 +654,25 @@ $info.WinIcon:=$iconFile.path
 $exeFile.setAppInfo($info)
 ```
 
+#### Example 3
+
 ```4d
-  // set some keys in an info.plist file (all platforms)
-var $infoPlistFile : 4D.File
-var $info : Object
-$infoPlistFile:=File("/RESOURCES/info.plist")
-$info:=New object
-$info.Copyright:="Copyright 4D 2023" //text
-$info.ProductVersion:=12 //integer
-$info.ShipmentDate:="2023-04-22T06:00:00Z" //timestamp
-$info.CFBundleIconFile:="myApp.icns" //for macOS
-$infoPlistFile.setAppInfo($info)
+// regenerate uuids of an application (macOS)
+
+// read myApp uuids 
+var $app:=File("/Applications/myApp.app/Contents/MacOS/myApp")
+var $info:=$app.getAppInfo()
+
+// regenerate uuids for all architectures
+For each ($i; $info.archs)
+	$i.uuid:=Generate UUID
+End for each 
+
+// update the app with the new uuids
+$app.setAppInfo($info)
 ```
 
+
 #### See also
 
 [.getAppInfo()](#getappinfo)
@@ -666,7 +763,7 @@ In *breakMode*, you can pass a number indicating the processing to apply to end-
 
 By default, when you omit the *breakMode* parameter, line breaks are processed in native mode (1).
 
-> **Compatibility Note**: Compatibility options are available for EOL and BOM management. See [Compatibility page](https://doc.4d.com/4dv19R/help/title/en/page3239.html) on doc.4d.com.
+> **Compatibility Note**: Compatibility options are available for EOL and BOM management. See [Compatibility page](https://doc.4d.com/4Dv20/4D/20.2/Compatibility-page.300-6750362.en.html) on doc.4d.com.
 
 #### Example
 

docs/API/HTTPRequestClass.md

@@ -175,7 +175,7 @@ Here is the sequence of callback calls:
 
 :::info
 
-For the callback functions to be called when you do not use [`wait()`](#wait) (asynchronous call), the process must be a [worker](../Develop/processes.md#worker-processes) created with [`CALL WORKER`](https://doc.4d.com/4dv20/help/command/en/page1389.html), NOT [`New process`](https://doc.4d.com/4dv20/help/command/en/page317.html).
+For the callback functions to be called when you do not use [`wait()`](#wait) (asynchronous call), the process must be a [worker](../Develop/processes.md#worker-processes) created with [`CALL WORKER`](../commands-legacy/call-worker.md), NOT [`New process`](../commands-legacy/new-process.md).
 
 :::
 

docs/API/SessionClass.md

@@ -75,7 +75,13 @@ This function does nothing and always returns **True** with remote client, store
 
 :::
 
-The `.clearPrivileges()` function <!-- REF #SessionClass.clearPrivileges().Summary -->removes all the privileges associated to the session and returns **True** if the execution was successful<!-- END REF -->. As a result, the session automatically becomes a Guest session.
+The `.clearPrivileges()` function <!-- REF #SessionClass.clearPrivileges().Summary -->removes all the privileges associated to the session and returns **True** if the execution was successful<!-- END REF -->. Unless in ["forceLogin" mode](../REST/authUsers.md#force-login-mode), the session automatically becomes a Guest session.
+
+:::note
+
+In "forceLogin" mode, `.clearPrivileges()` does not transform the session to a Guest session, it only clears the session's privileges.
+
+:::
 
 
 #### Example

docs/API/SystemWorkerClass.md

@@ -92,7 +92,7 @@ In the *options* parameter, pass an object that can contain the following proper
 |onTerminate|Formula|undefined|Callback when the external process is terminated. It receives two objects as parameters (see below)|
 |timeout|Number|undefined|Time in seconds before the process is killed if it is still alive|
 |dataType|Text|"text"|Type of the response body content. Possible values: "text" (default), "blob".|
-|encoding|Text|"UTF-8"|Only if `dataType="text"`. Encoding of the response body content. For the list of available values, see the [`CONVERT FROM TEXT`](https://doc.4d.com/4dv19R/help/command/en/page1011.html) command description|
+|encoding|Text|"UTF-8"|Only if `dataType="text"`. Encoding of the response body content. For the list of available values, see the [`CONVERT FROM TEXT`](../commands-legacy/convert-from-text.md) command description|
 |variables|Object||Sets custom environment variables for the system worker. Syntax: `variables.key=value`, where `key` is the variable name and `value` its value. Values are converted into strings when possible. The value cannot contain a '='. If not defined, the system worker inherits from the 4D environment.|
 |currentDirectory|Folder||Working directory in which the process is executed|
 |hideWindow|Boolean|true|(Windows) Hide the application window (if possible) or the Windows console|
@@ -115,7 +115,7 @@ Here is the sequence of callback calls:
 
 :::info
 
-For the callback functions to be called when you do not use [`wait()`](#wait) (asynchronous call), the process must be a [worker](../Develop/processes.md#worker-processes) created with [`CALL WORKER`](https://doc.4d.com/4dv20/help/command/en/page1389.html), NOT [`New process`](https://doc.4d.com/4dv20/help/command/en/page317.html).
+For the callback functions to be called when you do not use [`wait()`](#wait) (asynchronous call), the process must be a [worker](../Develop/processes.md#worker-processes) created with [`CALL WORKER`](../commands-legacy/call-worker.md), NOT [`New process`](../commands-legacy/new-process.md).
 
 :::