Merge pull request #442 from doc4d/main

upgrade after fixes

Author: arnaud4d

README.md

@@ -35,6 +35,9 @@ To generate syntax files:
 
 `npm run syntax`
 
+- auto build for main
+- for a beta branch: get the prod and generate, then push in the branch
+
 ## Markdown conventions
 
 ### API file names

docs/FormEditor/properties_FormProperties.md

@@ -44,7 +44,7 @@ A CSS file defined at the form level will override default style sheet(s). For m
 
 ## Form Class
 
-Name of an existing [user class](../Concepts/classes.md#class-definition) to associate to the form . The user class can belong to the host project or to a [component](../Extensions/develop-components.md#sharing-of-classes), in which case the formal syntax is "[*componentNameSpace*](../settings/general.md#component-namespace-in-the-class-store).className".
+Name of an existing [user class](../Concepts/classes.md#class-definition) to associate to the form. The user class can belong to the host project or to a [component](../Extensions/develop-components.md#sharing-of-classes), in which case the formal syntax is "[*componentNameSpace*](../settings/general.md#component-namespace-in-the-class-store).className".
 
 Associating a class to the form provides the following benefits:
 

docs/FormObjects/properties_BackgroundAndBorder.md

@@ -52,7 +52,7 @@ You can also set this property using the [`OBJECT SET RGB COLORS`](../commands-l
 
 An expression or a variable (array variables cannot be used) to apply a custom background color to each row of the list box. The expression or variable will be evaluated for each row displayed and must return a RGB color value. For more information, refer to the description of the [`OBJECT SET RGB COLORS`](../commands-legacy/object-set-rgb-colors.md) command in the *4D Language Reference manual*.
 
-You can also set this property using the [`LISTBOX SET PROPERTY`](../commands-legacy/listbox-set-property.md) command with `lk background color expression` constant.
+You can also set this property using the [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) command with `lk background color expression` constant.
 
 >With collection or entity selection type list boxes, this property can also be set using a [Meta Info Expression](properties_Text.md#meta-info-expression).
 

docs/FormObjects/properties_Text.md

@@ -373,7 +373,7 @@ Then, the *Color* method would contain:
 
 ## Multi-style
 
-This property enables the possibility of using specific styles in the selected area. When this option is checked, 4D interprets any `<SPAN> HTML` tags found in the area.
+This property enables the possibility of using [specific styles](https://doc.4d.com/4Dv20/4D/20.6/Supported-tags.300-7488021.en.html) in the selected area. When this option is checked, 4D interprets any `<SPAN> HTML` tags found in the area.
 
 By default, this option is not enabled.
 

docs/Notes/updates.md

@@ -14,10 +14,15 @@ Read [**What’s new in 4D 20 R10**](https://blog.4d.com/en-whats-new-in-4d-20-R
 - UUIDs in 4D are now generated in **version 7**. In previous 4D releases, they were generated in version 4.
 - 4D Language:
 	- For consistency, [`Create entity selection`](../commands/create-entity-selection.md) and [`USE ENTITY SELECTION`](../commands/use-entity-selection.md) commands have been moved from the ["4D Environment"](../commands/theme/4D_Environment.md) to the ["Selection"](../commands/theme/Selection.md) themes.
+	- New [`OBJECT SET DATA SOURCE FORMULA`](../commands/object-set-data-source-formula.md) and [`OBJECT Get data source formula`](../commands/object-get-data-source-formula.md) commands to assign and read `Formula` objects as data sources for form objects. 
+	- [`LISTBOX SET PROPERTY`](../commands/listbox-set-property.md) and [`LISTBOX Get property`](../commands/listbox-get-property.md) support three new constants: `lk current item`, `lk current item position`, and `lk selected items expression`.
+	
+
 
 #### Behavior changes
 
 - On Windows, current printer fonts intended only for printing (i.e. not usable on screen) are no longer loaded by 4D at startup. 
+- The *MeCab* library has been removed. This change only affects the processing of Japanese text.
 
 
 ## 4D 20 R9
@@ -37,6 +42,7 @@ Read [**What’s new in 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-20-R9
 - New [4D AIKit component](../aikit/overview.md) enabling interaction with third-party AI APIs.
 - The following VP command callbacks now wait for all 4D custom functions to complete their calculations: [VP IMPORT DOCUMENT](../ViewPro/commands/vp-import-document.md), [VP IMPORT FORM BLOB](../ViewPro/commands/vp-import-from-blob.md), [VP IMPORT FROM OBJECT](../ViewPro/commands/vp-import-from-object.md), and [VP FLUSH COMMANDS](../ViewPro/commands/vp-flush-commands.md).
 - New [4D Netkit](https://developer.4d.com/4D-NetKit/) features to manage Google and Microsoft 365 calendars; ability to use the host web server for OAuth 2.0 authentication. 
+- The [*MeCab* library](../settings/database.md#support-of-mecab-japanese-version) is now deprecated and will be removed in the next release. 
 - 4D Write Pro Interface: New [integrated AI](../WritePro/writeprointerface.md#integrated-ai) to interact with **chatGTP** from your 4D Write Pro documents.
 - [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R9): list of all bugs that have been fixed in 4D 20 R9.
 
@@ -122,7 +128,7 @@ Read [**What’s new in 4D 20 R6**](https://blog.4d.com/en-whats-new-in-4d-20-R6
 - New [`$singleton` API](../REST/$singleton.md) to call exposed singleton functions from REST and new [associated privileges](../ORDA/privileges.md).
 - A [new settings button](../settings/web.md#activate-rest-authentication-through-dsauthentify-function) helps you upgrade your project to use "force login" REST mode (the `On REST Authentication` database method is now deprecated).
 - A [new settings tab](../Project/compiler.md#warnings) helps you define warnings generation globally.
-- Several commands, mainly from the "4D Environment" theme, are now thread-safe ([see the full list](https://doc.4d.com/4Dv20R6/4D/Preemptive_6957385.999-2878208.en.html)), as well as some selectors of the [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) commands.   
+- Several commands, mainly from the "4D Environment" theme, are now thread-safe, as well as some selectors of the [`SET DATABASE PARAMETER`](../commands-legacy/set-database-parameter.md)/[`Get database parameter`](../commands-legacy/get-database-parameter.md) commands.   
 - New [4D-QPDF component](https://github.com/4d/4D-QPDF) that provides the `PDF Get attachments` command to extract attachments from a PDF/A3 document.
 - 4D Language commands: [What's new page](https://doc.4d.com/4Dv20R6/4D/20-R6/What-s-new.901-6957482.en.html) on doc.4d.com.
 - 4D Write Pro: [What's new page](https://doc.4d.com/4Dv20R6/4D/20-R6/What-s-new.901-6993921.en.html) on doc.4d.com.

docs/WebServer/sessions.md

@@ -24,18 +24,18 @@ Web sessions are used for:
 
 The session management feature can be enabled and disabled on your 4D web server. There are different ways to enable session management:
 
-- Using the **Scalable sessions** OTPion on the "Web/OTPions (I)" page of the Settings (permanent setting):
+- Using the **Scalable sessions** option on the "Web/Options (I)" page of the Settings (permanent setting):
 ![alt-text](../assets/en/WebServer/settingsSession.png)
 
-This OTPion is selected by default in new projects. It can however be disabled by selecting the **No sessions** OTPion, in which case the web session features are disabled (no `Session` object is available).
+This option is selected by default in new projects. It can however be disabled by selecting the **No sessions** option, in which case the web session features are disabled (no `Session` object is available).
 
-- Using the [`.scalableSession`](API/WebServerClass.md#scalablesession) property of the Web Server object (to pass in the *settings* parameter of the [`.start()`](API/WebServerClass.md#start) function). In this case, this setting overrides the OTPion defined in the Settings dialog box for the Web Server object (it is not stored on disk).
+- Using the [`.scalableSession`](API/WebServerClass.md#scalablesession) property of the Web Server object (to pass in the *settings* parameter of the [`.start()`](API/WebServerClass.md#start) function). In this case, this setting overrides the option defined in the Settings dialog box for the Web Server object (it is not stored on disk).
 
 > The [`WEB SET OTPION`](../commands-legacy/web-set-option.md) command can also set the session mode for the main Web server.
 
 In any cases, the setting is local to the machine; so it can be different on the 4D Server Web server and the Web servers of remote 4D machines.
 
-> **Compatibility**: A **Legacy sessions** OTPion is available in projects created with a 4D version prior to 4D v18 R6 (for more information, please refer to the [doc.4d.com](https://doc.4d.com) web site).
+> **Compatibility**: A **Legacy sessions** option is available in projects created with a 4D version prior to 4D v18 R6 (for more information, please refer to the [doc.4d.com](https://doc.4d.com) web site).
 
 
 ## Session implementation

docs/WritePro/commands-legacy/wp-paragraph-range.md

@@ -14,13 +14,9 @@ displayed_sidebar: docs
 
 <!-- END REF-->
 
-## Compatibility 
-
-<!--REF #_command_.WP Paragraph range.Summary-->**WP Paragraph range** was named **WP Create Paragraph range** in previous versions of 4D Write Pro.<!-- END REF--> It has been renamed for clarity. 
-
 ## Description 
 
-The **WP Paragraph range** command returns a specific range object that addresses only the paragraphs that intersect with the *targetObj* you passed as parameter. The paragraph range object returned can be used by [WP GET ATTRIBUTES](../commands/wp-get-attributes.md) and [WP SET ATTRIBUTES](../commands/wp-set-attributes.md) to handle paragraph attributes only. 
+<!--REF #_command_.WP Paragraph range.Summary-->The **WP Paragraph range** command returns a specific range object that addresses only the paragraphs that intersect with the *targetObj* you passed as parameter.<!-- END REF--> The paragraph range object returned can be used by [WP GET ATTRIBUTES](../commands/wp-get-attributes.md) and [WP SET ATTRIBUTES](../commands/wp-set-attributes.md) to handle paragraph attributes only. 
 
 In *targetObj*, you can pass:
 

docs/aikit/Classes/OpenAIImage.md

@@ -23,6 +23,8 @@ https://platform.openai.com/docs/api-reference/images/object
 
 **asBlob**() : 4D.Blob
 
+| Parameter        | Type    | Description                                             |
+|------------------|---------|---------------------------------------------------------|
 | Function result| 4D.Blob | Converts the generated image to a blob format based on its URL or base64-encoded JSON. |
 
 #### Example Usage
@@ -35,6 +37,8 @@ var $blob:=$image.asBlob()
 
 **asPicture**() : Picture
 
+| Parameter        | Type    | Description                                             |
+|------------------|---------|---------------------------------------------------------|
 | Function result| Picture | Creates a picture object from the blob converted image. |
 
 #### Example Usage

docs/aikit/Classes/OpenAIVision.md

@@ -11,7 +11,7 @@ Helper for vision stuff.
 
 ### create()
 
-**create*(*imageURL* : Text) : OpenAIVisionHelper
+**create**(*imageURL* : Text) : OpenAIVisionHelper
 
 | Parameter        | Type  | Description                   |
 |------------------|-------|-------------------------------|
@@ -27,7 +27,7 @@ var $result:=$helper.prompt("Could you describe it?")
 
 ### fromFile()
 
-**fromFile*(*imageFile* : 4D.File) : OpenAIVisionHelper
+**fromFile**(*imageFile* : 4D.File) : OpenAIVisionHelper
 
 | Parameter        | Type      | Description                  |
 |------------------|-----------|------------------------------|
@@ -37,13 +37,13 @@ var $result:=$helper.prompt("Could you describe it?")
 #### Example Usage
 
 ```4d
-var $helper:=$client.chat.vision.fromFile(Folder(fk resource foldres).file("image.png"))
+var $helper:=$client.chat.vision.fromFile(Folder(fk resources folder).file("image.png"))
 var $result:=$helper.prompt("Could you describe it?")
 ```
 
 ### fromPicture()
 
-**fromPicture*(*image* : Picture) : OpenAIVisionHelper
+**fromPicture**(*image* : Picture) : OpenAIVisionHelper
 
 | Parameter        | Type      | Description                  |
 |------------------|-----------|------------------------------|

docs/commands-legacy/listbox-get-arrays.md

@@ -47,7 +47,7 @@ For record selection, collection or entity selection type list boxes, *arrStyles
 ## See also 
 
 [LISTBOX Get array](listbox-get-array.md)  
-[LISTBOX Get property](listbox-get-property.md)  
+[LISTBOX Get property](../commands/listbox-get-property.md)  
 [LISTBOX SET ARRAY](listbox-set-array.md)  
 
 ## Properties