Merge pull request #419 from doc4d/main

update 20 R9 beta

Author: arnaud4d

docs/Extensions/overview.md

@@ -20,7 +20,7 @@ The 4D [project architecture](../Project/architecture.md) is modular. You can pr
 |[4D SVG](https://github.com/4d/4D-SVG)|Create and manipulate common svg graphic objects|`SVGTool_Display_viewer`, multiple `SVG_` methods |
 |[4D ViewPro](ViewPro/getting-started.md)|Spreadsheet features in your forms|See [4D View Pro documentation](ViewPro/getting-started.md)|
 |[4D Widgets](https://github.com/4d/4D-Widgets)|Manage DatePicker, TimePicker, SearchPicker 4D widgets|`DatePicker calendar`, `DateEntry area`, `TimeEntry`, `SearchPicker SET HELP TEXT`, ...|
-|[4D WritePro Interface](https://github.com/4d/4D-WritePro-Interface)|Manage [4D Write Pro](https://doc.4d.com/4Dv20/4D/20/4D-Write-Pro-Reference.100-6229455.en.html) palettes and [table wizard](../WritePro/writeprointerface.md#table-wizard)|`WP PictureSettings`, `WP ShowTabPages`, `WP SwitchToolbar`, `WP UpdateWidget`|
+|[4D WritePro Interface](https://github.com/4d/4D-WritePro-Interface)|Manage [4D Write Pro palettes](https://doc.4d.com/4Dv20R9/4D/20-R9/Entry-areas.300-7543821.en.html and [table wizard](../WritePro/writeprointerface.md#table-wizard)|`WP PictureSettings`, `WP ShowTabPages`, `WP SwitchToolbar`, `WP UpdateWidget`|
 
 
 ## Third-party components

docs/Notes/updates.md

@@ -21,6 +21,8 @@ Read [**What’s new in 4D 20 R9**](https://blog.4d.com/en-whats-new-in-4d-v20-R
 - 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-form-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. 
+- [**Fixed bug list**](https://bugs.4d.fr/fixedbugslist?version=20_R9): list of all bugs that have been fixed in 4D 20 R9.
+
 
 ## 4D 20 R8
 

docs/ORDA/ordaClasses.md

@@ -157,17 +157,14 @@ The `City Class` provides an API:
 
 Class extends DataClass
 
-Function getCityName()
-	var $1; $zipcode : Integer
+Function getCityName($zipcode : Integer) -> $cityName : Text
 	var $zip : 4D.Entity
-	var $0 : Text
 
-	$zipcode:=$1
 	$zip:=ds.ZipCode.get($zipcode)
-	$0:=""
+	$cityName:=""
 
 	If ($zip#Null)
-		$0:=$zip.city.name
+		$cityName:=$zip.city.name
 	End if
 ```
 

docs/REST/ClassFunctions.md

@@ -522,17 +522,13 @@ In this example, we associate an existing school to a Students entity. The `Stud
 
 Class extends Entity
 
-exposed Function putToSchool()
-	var $1, $school , $0, $status : Object
+exposed Function putToSchool($school : Object) -> $status : Object
 
-		//$1 is a Schools entity
-	$school:=$1
+		//$school is a Schools entity
 		//Associate the related entity school to the current Students entity
 	This.school:=$school
 
 	$status:=This.save()
-
-	$0:=$status
 ```
 
 You run this request, called on a Students entity :
@@ -566,18 +562,12 @@ In the `Students` Dataclass class, the `setFinalExam()` function updates a recei
 
 Class extends DataClass
 
-exposed Function setFinalExam()
-
+exposed Function setFinalExam($es : Object ; $examResult : Text) -> $keys : Collection
 
-    var $1, $es, $student, $status : Object
-    var $2, $examResult : Text
 
-    var $keys, $0 : Collection
+    var $student, $status : Object
 
-      //Entity selection
-    $es:=$1
-
-    $examResult:=$2
+      //$es is an Entity selection
 
     $keys:=New collection()
 
@@ -589,8 +579,6 @@ exposed Function setFinalExam()
             $keys.push($student.ID)
         End if
     End for each
-
-    $0:=$keys
 ```
 
 An entity set is first created with this request:   

docs/code-editor/write-class-method.md

@@ -845,7 +845,7 @@ The `<method>` tag allows you to generate and use macro-commands that execute 4D
 
 The code of a called method is executed in a new process. This process is killed once the method is executed.
 
-> The structure process remains frozen until the called method execution is completed. You must make sure that the execution is quick and that there is no risk of it blocking the application. If this occurs, use the **Ctrl+F8** (Windows) or **Command+F8** (Mac OS) command to "kill" the process.
+> The structure process remains frozen until the called method execution is completed. You must make sure that the execution is quick and that there is no risk of it blocking the application. If this occurs, use the **Ctrl+F8** (Windows) or **Command+F8** (macOS) command to "kill" the process.
 
 ### Calling macros  
 

docs/commands-legacy/append-data-to-pasteboard.md

@@ -20,7 +20,7 @@ displayed_sidebar: docs
 
 **Note:** In the case of copy/paste operations, the pasteboard is equivalent to the Clipboard. 
 
-In *dataType*, pass a value specifying the type of data to be added. You can pass a 4D signature, a UTI type (Mac OS), a format name/number (Windows), or a 4-character type (compatibility). For more information about these types, please refer to the *Managing Pasteboards* section. 
+In *dataType*, pass a value specifying the type of data to be added. You can pass a 4D signature, a UTI type (macOS), a format name/number (Windows), or a 4-character type (compatibility). For more information about these types, please refer to the *Managing Pasteboards* section. 
 
 **Note for Windows users:** When the command is used with Text type data (*dataType* is "TEXT", com.4d.private.text.native or com.4d.private.text.utf16), the string contained in the BLOB parameter *data* must end with the NULL character under Windows. 
 

docs/commands-legacy/display-selection.md

@@ -43,7 +43,7 @@ Keep in mind that with the **DISPLAY SELECTION** command, this parameter only al
 
 If the selection contains only one record and the first optional *\** is not used, the record appears in the input form instead of the output form. If the first optional *\** is specified, a one-record selection is displayed, using the output form. If the first optional *\** is specified and the user displays the record in the input form by double-clicking on it, the scroll bars will be hidden in the input form. To reverse this effect, pass the second optional \*.
 
-Custom buttons may be put in the Footer or Header area of the output form in order to terminate the execution of the **DISPLAY SELECTION** command. You can use automatic Accept or Cancel buttons to exit, or use an object method that calls [ACCEPT](accept.md) or [CANCEL](cancel.md). When an output form called by the **DISPLAY SELECTION** command has no buttons, only the **Escape** (Windows) or **Esc** (Mac OS) key can be used to exit the list.
+Custom buttons may be put in the Footer or Header area of the output form in order to terminate the execution of the **DISPLAY SELECTION** command. You can use automatic Accept or Cancel buttons to exit, or use an object method that calls [ACCEPT](accept.md) or [CANCEL](cancel.md). When an output form called by the **DISPLAY SELECTION** command has no buttons, only the **Escape** (Windows) or **Esc** (macOS) key can be used to exit the list.
 
 During and after execution of **DISPLAY SELECTION**, the records that the user highlighted (selected) are kept in a set named UserSet. The UserSet is available within the selection display for object methods when a button is clicked or a menu item is chosen. It is also available to the project method that called **DISPLAY SELECTION** after the command was completed.
 

docs/commands-legacy/export-data.md

@@ -57,23 +57,21 @@ This example illustrates the use of the EXPORT DATA command to export data in bi
 * Here is the code for the ExportBinary method:
 
 ```4d
- var $1 : Pointer //table
- var $2 : Text //path of destination file
- var $3 : Boolean //export all records
+#DECLARE ($tablePtr : Pointer ; $path : Text ; $all : Boolean)
  var $i : Integer
  var $ref : Text
  $ref:=DOM Create XML Ref("settings-import-export")
-  // Export the table "$1" in '4D' binary format, all the records or only the current selection
- DOM SET XML ATTRIBUTE($ref;"table_no";Table($1);"format";"4D";"all_records";$3)
+  // Export the table "$tablePtr" in '4D' binary format, all the records or only the current selection
+ DOM SET XML ATTRIBUTE($ref;"table_no";Table($tablePtr);"format";"4D";"all_records";$all)
   // Definition of fields to export
- For($i;1;Last field number($1))
-    If(Is field number valid($1;$i))
-       $elt:=DOM Create XML element($ref;"field";"table_no";Table($1);"field_no";$i)
+ For($i;1;Last field number($tablePtr))
+    If(Is field number valid($tablePtr;$i))
+       $elt:=DOM Create XML element($ref;"field";"table_no";Table($tablePtr);"field_no";$i)
     End if
  End for
- EXPORT DATA($2;$ref)
+ EXPORT DATA($path;$ref)
  If(Ok=0)
-    ALERT("Error during export of table "+Table name($1))
+    ALERT("Error during export of table "+Table name($tablePtr))
  End if
  DOM CLOSE XML($ref)
 ```

docs/commands-legacy/find-in-array.md

@@ -37,11 +37,11 @@ The following project method deletes all empty elements from the string or text
   // CLEAN UP ARRAY ( Pointer )
   // CLEAN UP ARRAY ( -> Text or String array )
  
- var $1 : Pointer
+ #DECLARE ($arrPtr : Pointer) : Pointer
  Repeat
-    $vlElem:=Find in array($1->;"")
+    $vlElem:=Find in array($arrPtr->;"")
     If($vlElem>0)
-       DELETE FROM ARRAY($1->;$vlElem)
+       DELETE FROM ARRAY($arrPtr->;$vlElem)
     End if
  Until($vlElem<0)
 ```
@@ -66,9 +66,10 @@ The following project method selects the first element of an array whose pointer
   // SELECT ELEMENT ( Pointer ; Pointer)
   // SELECT ELEMENT ( -> Text or String array ; -> Text or String variable or field )
  
- $1->:=Find in array($1->;$2->)
- If($1->=-1)
-    $1->:=0 // If no element was found, set the array to no selected element
+ #DECLARE($arrPtr : Pointer ; $varPtr : Pointer)
+$arrPtr->:=Find in array($arrPtr->; $varPtr->)
+ If($tabPtr->=-1)
+    $tabPtr->:=0 // If no element was found, set the array to no selected element
  End if
 ```
 

docs/commands-legacy/get-document-properties.md

@@ -47,18 +47,14 @@ The Time stamp project method listed below calculates the time stamp for a speci
   // Time stamp { ( date ; Time ) } -> Long
   // Time stamp { ( date ; Time ) } -> Number of seconds since Jan, 1st 1995
  
- var $1;$vdDate : Date
- var $2;$vhTime : Time
- var $0 : Integer
+ #DECLARE ($vdDate : Date ; $vhTime : Time) : Integer
  
  If(Count parameters=0)
     $vdDate:=Current date
     $vhTime:=Current time
- Else
-    $vdDate:=$1
-    $vhTime:=$2
  End if
- $0:=(($vdDate-!01/01/95!)*86400)+$vhTime
+ return (($vdDate-!01/01/95!)*86400)+$vhTime
+
 ```
 
 **Note:** Using this method, you can encode dates and times from the *01/01/95* at *00:00:00* to the *01/19/2063* at *03:14:07* which cover the long integer range *0* to *2^31* minus one.
@@ -70,19 +66,19 @@ Conversely, the Time stamp to date and Time stamp to time project methods listed
   // Time stamp to date ( Long ) -> Date
   // Time stamp to date ( Time stamp ) -> Extracted date
  
- var $0 : Date
- var $1 : Integer
- 
- $0:=!01/01/95!+($1\86400)
- 
+#DECLARE ($timeStamp : Integer) : Date
+
+return !01/01/95!+($timeStamp\86400)
+```
+
+```4d
   // Time stamp to time Project Method
   // Time stamp to time ( Long ) -> Date
   // Time stamp to time ( Time stamp ) -> Extracted time
  
- var $0 : Time
- var $1 : Integer
- 
- $0:=Time(Time string(†00:00:00†+($1%86400)))
+#DECLARE ($timeStamp : Integer) : Time
+
+return Time(Time string(?00:00:00?+($timeStamp %86400)))
 ```
 
 For ensuring that the records have their time stamps correctly updated no matter the way they are created or modified, we just need to enforce that rule using the trigger of the table *\[Documents\]*:
@@ -103,7 +99,7 @@ Once this is implemented in the database, we have all we need to write the proje
 ```4d
   // CREATE DOCUMENTATION Project Method
  
- C_STRING(255;$vsPath;$vsDocPathName;$vsDocName)
+ C_TEXT($vsPath;$vsDocPathName;$vsDocName)
  var $vlDoc : Integer
  var $vbOnWindows;$vbDoIt;$vbLocked;$vbInvisible : Boolean
  var $vhDocRef;$vhCreatedAt;$vhModifiedAt : Time