aboutsummaryrefslogtreecommitdiff
path: root/source/cs/helpcontent2/source/text/sbasic/shared/03.po
diff options
context:
space:
mode:
authorChristian Lohmaier <lohmaier+LibreOffice@googlemail.com>2021-09-14 13:23:14 +0200
committerChristian Lohmaier <lohmaier+LibreOffice@googlemail.com>2021-09-14 13:39:38 +0200
commit561c214c699f3b563ba2507fd1ad9a709cf16653 (patch)
tree9115b32cddb880b72ecb721e4d62643401f08073 /source/cs/helpcontent2/source/text/sbasic/shared/03.po
parent4460c7babd574c5040a528d10fe51001c27680bc (diff)
update translations for master
and foce-fix errors using pocheck Change-Id: I12d26e666d46993fd4ff26616c09be9e5bf82fcd
Diffstat (limited to 'source/cs/helpcontent2/source/text/sbasic/shared/03.po')
-rw-r--r--source/cs/helpcontent2/source/text/sbasic/shared/03.po3169
1 files changed, 1706 insertions, 1463 deletions
diff --git a/source/cs/helpcontent2/source/text/sbasic/shared/03.po b/source/cs/helpcontent2/source/text/sbasic/shared/03.po
index 8b84da2cbae..8ebda15acb8 100644
--- a/source/cs/helpcontent2/source/text/sbasic/shared/03.po
+++ b/source/cs/helpcontent2/source/text/sbasic/shared/03.po
@@ -3,7 +3,7 @@ msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: https://bugs.libreoffice.org/enter_bug.cgi?product=LibreOffice&bug_status=UNCONFIRMED&component=UI\n"
-"POT-Creation-Date: 2021-07-01 17:53+0200\n"
+"POT-Creation-Date: 2021-09-10 23:11+0200\n"
"PO-Revision-Date: 2021-08-04 12:59+0000\n"
"Last-Translator: Stanislav Horáček <stanislav.horacek@gmail.com>\n"
"Language-Team: Czech <https://translations.documentfoundation.org/projects/libo_help-master/textsbasicshared03/cs/>\n"
@@ -13,7 +13,7 @@ msgstr ""
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n"
"X-Accelerator-Marker: ~\n"
-"X-Generator: Weblate 4.6.2\n"
+"X-Generator: LibreOffice\n"
"X-POOTLE-MTIME: 1564160910.000000\n"
#. ViEWM
@@ -61,6 +61,24 @@ msgctxt ""
msgid "This property is not available in Python."
msgstr "Tato vlastnost není k dispozici v jazyce Python."
+#. J3r7B
+#: avail_release.xhp
+msgctxt ""
+"avail_release.xhp\n"
+"par_id291613654389793\n"
+"help.text"
+msgid "This method is available from %PRODUCTNAME 7.3 onwards."
+msgstr ""
+
+#. ajeAa
+#: avail_release.xhp
+msgctxt ""
+"avail_release.xhp\n"
+"par_id201613654593537\n"
+"help.text"
+msgid "This property is available from %PRODUCTNAME 7.3 onwards."
+msgstr ""
+
#. 7KtXf
#: avail_release.xhp
msgctxt ""
@@ -1106,22 +1124,22 @@ msgctxt ""
msgid "The following code snippets show the various ways to call methods in the <literal>Array</literal> service (the <literal>Append</literal> method is used as an example):"
msgstr ""
-#. qfbfm
+#. PZxWC
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id571609956486468\n"
"help.text"
-msgid "The <literal>CreateScriptService</literal> method is only available after you have loaded the <literal>ScriptForge</literal> library."
+msgid "Because Python has built-in list and tuple support, most of the methods in the <literal>Array</literal> service are available for Basic scripts only. The only exception is <literal>ImportFromCSVFile</literal> which is supported in both Basic and Python."
msgstr ""
-#. yDQWY
+#. SFTcE
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id651606319520519\n"
"help.text"
-msgid "Methods"
+msgid "List of Methods in the Array Service"
msgstr ""
#. qDYGe
@@ -1142,22 +1160,22 @@ msgctxt ""
msgid "Appends the items listed as arguments to the end of the input array."
msgstr ""
-#. EGFyc
+#. 2keb6
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id471582548992953\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
+msgid "<emph>array_1d</emph>: The pre-existing array, may be empty."
msgstr ""
-#. FfdqS
+#. WaggZ
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id531582548992953\n"
"help.text"
-msgid "<emph>arg0, ...</emph> : a list of items to append to Array_1D."
+msgid "<emph>arg0, arg1, ...</emph>: Items that will be appended to <literal>array_1d</literal>."
msgstr ""
#. SkBjv
@@ -1169,22 +1187,22 @@ msgctxt ""
msgid "Appends a new column to the right side of a two dimensional array. The resulting array has the same lower bounds as the initial two dimensional array."
msgstr ""
-#. iGG8W
+#. dCSCb
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id461582549679175\n"
"help.text"
-msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has only one dimension, it is considered as the first column of the resulting two-dimensional array."
+msgid "<emph>array_2d</emph>: The pre-existing array, may be empty. If that array has only one dimension, it is considered as the first column of the resulting two-dimensional array."
msgstr ""
-#. sBuFx
+#. NLrB4
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id991582549679175\n"
"help.text"
-msgid "<emph>New_Column</emph> : a 1-dimensional array with as many items as there are rows in <literal>Array_2D</literal>."
+msgid "<emph>column</emph>: A 1-dimensional array with as many items as there are rows in <literal>array_2d</literal>."
msgstr ""
#. KDB9L
@@ -1196,22 +1214,22 @@ msgctxt ""
msgid "Append to the bottom of a two dimension array a new row. The resulting array has the same lower bounds as the initial two dimension array."
msgstr ""
-#. uKD5Q
+#. HEpVM
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id631582551461984\n"
"help.text"
-msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the first row of the resulting 2 dimension array."
+msgid "<emph>array_2d</emph>: The pre-existing array, may be empty. If that array has 1 dimension, it is considered as the first row of the resulting 2 dimension array."
msgstr ""
-#. ZmnBs
+#. SZZEA
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id101582551483685\n"
"help.text"
-msgid "<emph>Row</emph> : a 1D array with as many items as there are columns in Array_2D."
+msgid "<emph>row</emph>: A 1-dimensional array with as many items as there are columns in <literal>array_2d</literal>."
msgstr ""
#. aM65P
@@ -1223,40 +1241,40 @@ msgctxt ""
msgid "Check if a one dimension array contains a certain number, text or date. Text comparison can be case-sensitive or not. <br/>Sorted input arrays must be filled homogeneously, meaning all items must be scalars of the same type (<literal>Empty</literal> and <literal>Null</literal> items are forbidden). <br/>The result of the method is unpredictable when the array is announced as sorted and is in reality not. <br/>A binary search is done when the array is sorted, otherwise, it is simply scanned from top to bottom and <literal>Empty</literal> and <literal>Null</literal> items are ignored."
msgstr ""
-#. ho7Rr
+#. CuUGw
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id451582552517871\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the array to scan."
+msgid "<emph>array_1d</emph>: The array to scan."
msgstr ""
-#. ADj73
+#. WZiqW
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id221582552517872\n"
"help.text"
-msgid "<emph>ToFind</emph> : a number, a date or a string to find."
+msgid "<emph>tofind</emph>: A number, a date or a string to find."
msgstr ""
-#. 3iQDC
+#. jFfok
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id981582552517872\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Only for string comparisons (Default = <literal>False</literal>)."
msgstr ""
-#. NBAGy
+#. 5ARWv
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id641582553128490\n"
"help.text"
-msgid "<emph>SortOrder</emph> : \"ASC\", \"DESC\" or \"\" (= not sorted, default)"
+msgid "<emph>sortorder</emph>: It can be either \"ASC\", \"DESC\" or \"\" (not sorted). The default value is \"\"."
msgstr ""
#. HVqG3
@@ -1268,31 +1286,121 @@ msgctxt ""
msgid "Store the content of a 2-columns array into a <link href=\"text/sbasic/shared/03/sf_dictionary.xhp\" name=\"dictionary\">ScriptForge.Dictionary</link> object. <br/>The key will be extracted from the first column, the item from the second."
msgstr ""
-#. CMssn
+#. AdhMA
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id561582557214489\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the first column must contain exclusively strings with a length > 0, in any order."
+msgid "<emph>array_2d</emph>: Data to be converted into a <literal>ScriptForge.Dictionary</literal> object."
+msgstr ""
+
+#. 9B9aE
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id781626977460310\n"
+"help.text"
+msgid "The first column must contain exclusively strings with a length greater than zero, in any order. These values will be used as labels in the dictionary."
+msgstr ""
+
+#. GYEkD
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id511626977461127\n"
+"help.text"
+msgid "The second column contains the data that will be associated to the corresponding label in the dictionary."
+msgstr ""
+
+#. fyDBX
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"hd_id991627154151529\n"
+"help.text"
+msgid "Copy"
+msgstr ""
+
+#. bGXKd
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id571627154604275\n"
+"help.text"
+msgid "Creates a copy of a 1D or 2D array."
+msgstr ""
+
+#. EYuiH
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id191627155816815\n"
+"help.text"
+msgid "<emph>array_nd</emph>: The 1D or 2D array to be copied."
+msgstr ""
+
+#. 76Guf
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id451627155478940\n"
+"help.text"
+msgid "A simple assignment of an <literal>Array</literal> object will copy its reference instead of creating a copy of the object's contents. See the example below:"
+msgstr ""
+
+#. B2KZj
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"bas_id801627155939671\n"
+"help.text"
+msgid "' The assignment below is made by reference"
+msgstr ""
+
+#. SoKPK
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"bas_id291627156013810\n"
+"help.text"
+msgid "' Hence changing values in \"b\" will also change \"a\""
+msgstr ""
+
+#. 6NbNZ
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id701627155874259\n"
+"help.text"
+msgid "By using the <literal>Copy</literal> method, a copy of the whole <literal>Array</literal> object is made. In the example below, <literal>a</literal> and <literal>b</literal> are different objects and changing values in <literal>b</literal> will not affect values in <literal>a</literal>."
+msgstr ""
+
+#. UycBx
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"bas_id141627156152196\n"
+"help.text"
+msgid "' Creates a copy of \"a\" using the \"Copy\" method"
msgstr ""
-#. fngum
+#. bYzRV
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id671582558126025\n"
"help.text"
-msgid "Count the number of dimensions of an array. The result can be greater than two. <br/>If the argument is not an array, returns -1 <br/>If the array is not initialized, returns 0."
+msgid "Count the number of dimensions of an array. The result can be greater than two. <br/>If the argument is not an array, returns -1 <br/>If the array is not initialized, returns 0."
msgstr ""
-#. tGdVE
+#. xbtFE
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id771582558126027\n"
"help.text"
-msgid "<emph>Array_ND</emph> : the array to examine."
+msgid "<emph>array_nd</emph>: The array to examine."
msgstr ""
#. n2AxD
@@ -1304,31 +1412,31 @@ msgctxt ""
msgid "Build a set, as a zero-based array, by applying the difference operator on the two input arrays. Resulting items originate from the first array and not from the second. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
msgstr ""
-#. NGKHH
+#. FTb9n
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id271582558644287\n"
"help.text"
-msgid "<emph>Array1_1D</emph> : A 1 dimension reference array, whose items are examined for removal."
+msgid "<emph>array1_1d</emph>: A 1-dimensional reference array, whose items are examined for removal."
msgstr ""
-#. gPEJE
+#. JXqBK
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id141582558644287\n"
"help.text"
-msgid "<emph>Array2_1D</emph> : A 1 dimension array, whose items are subtracted from the first input array."
+msgid "<emph>array2_1d</emph>: A 1-dimensional array, whose items are subtracted from the first input array."
msgstr ""
-#. z2QT8
+#. jK4zC
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id291582559651473\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only if the arrays are populated with strings, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: This argument is only applicable if the arrays are populated with strings (Default = <literal>False</literal>)."
msgstr ""
#. mzRus
@@ -1340,31 +1448,31 @@ msgctxt ""
msgid "Write all items of the array sequentially to a text file. If the file exists already, it will be overwritten without warning."
msgstr ""
-#. igBEo
+#. 9mNLT
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id100158617970719\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to export. It must contain only strings."
+msgid "<emph>array_1d</emph>: The array to export. It must contain only strings."
msgstr ""
-#. gXh53
+#. kXJDE
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id101586179707232\n"
"help.text"
-msgid "<emph>FileName</emph> : the name of the text file containing the data. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default = any (both the URL format and the native operating system format are admitted)."
+msgid "<emph>filename</emph>: The name of the text file where the data will be written to. The name must be expressed according to the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service."
msgstr ""
-#. wqGeq
+#. fAeZV
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id70158617970791\n"
"help.text"
-msgid "<emph>Encoding</emph> : The character set that should be used. Use one of the names listed in <link href=\"https://www.iana.org/assignments/character-sets/character-sets.xhtml\" name=\"IANA character sets\">IANA character sets</link>. Note that %PRODUCTNAME may not implement all existing character sets. Default is \"UTF-8\"."
+msgid "<emph>encoding</emph>: The character set that should be used. Use one of the names listed in <link href=\"https://www.iana.org/assignments/character-sets/character-sets.xhtml\" name=\"IANA character sets\">IANA character sets</link>. Note that %PRODUCTNAME may not implement all existing character sets (Default is \"UTF-8\")."
msgstr ""
#. TtHbe
@@ -1376,22 +1484,22 @@ msgctxt ""
msgid "Extract from a two dimension array a specific column as a new array. <br/>Its lower <literal>LBound</literal> and upper <literal>UBound</literal> boundaries are identical to that of the first dimension of the input array."
msgstr ""
-#. EnMKp
+#. j2CVW
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id301582560281083\n"
"help.text"
-msgid "<emph>Array_2D</emph> : The array from which to extract."
+msgid "<emph>array_2d</emph>: The array from which to extract."
msgstr ""
-#. z3M4K
+#. QDqrA
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id421582560281084\n"
"help.text"
-msgid "<emph>ColumnIndex</emph> : The column number to extract - must be in the interval <literal>[LBound, UBound]</literal>."
+msgid "<emph>columnindex</emph>: The column number to extract - must be in the interval <literal>[LBound, UBound]</literal>."
msgstr ""
#. AJxYE
@@ -1421,22 +1529,22 @@ msgctxt ""
msgid "Extract from a two dimension array a specific row as a new array. <br/>Its lower <literal>LBound</literal> and upper <literal>UBound</literal> boundaries are identical to that of the second dimension of the input array."
msgstr ""
-#. BY5S6
+#. VCBJA
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id911582561542889\n"
"help.text"
-msgid "<emph>Array_2D</emph> : The array from which to extract."
+msgid "<emph>array_2d</emph>: The array from which to extract."
msgstr ""
-#. bdCja
+#. MjXTV
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id441582561551202\n"
"help.text"
-msgid "<emph>RowIndex</emph> : The row number to extract - must be in the interval <literal>[LBound, UBound]</literal>."
+msgid "<emph>rowindex</emph>: The row number to extract - must be in the interval <literal>[LBound, UBound]</literal>."
msgstr ""
#. AajEu
@@ -1466,13 +1574,13 @@ msgctxt ""
msgid "Stack all single items of an array and all items in its subarrays into one new array without subarrays. Empty subarrays are ignored and subarrays with a number of dimensions greater than one are not flattened."
msgstr ""
-#. j2LdZ
+#. CNFGJ
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id431585757822869\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
+msgid "<emph>array_1d</emph>: The pre-existing array, may be empty."
msgstr ""
#. DDwn4
@@ -1556,40 +1664,49 @@ msgctxt ""
msgid "If a line contains less or more fields than the first line in the file, an exception will be raised. Empty lines however are simply ignored. If the size of the file exceeds the number of items limit (see inside the code), a warning is raised and the array is truncated."
msgstr ""
-#. zbUFJ
+#. zGf5A
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id441585561482121\n"
"help.text"
-msgid "<emph>FileName</emph> : the name of the text file containing the data. The name is expressed as given by the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service. Default = any (both the URL format and the native operating system format are admitted)."
+msgid "<emph>filename</emph>: The name of the text file containing the data. The name must be expressed according to the current <literal>FileNaming</literal> property of the <literal>SF_FileSystem</literal> service."
msgstr ""
-#. eQNz4
+#. SBuiC
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id251585561482929\n"
"help.text"
-msgid "<emph>Delimiter</emph> : A single character, usually, a comma, a semicolon or a TAB character. Default = <literal>\",\"</literal>."
+msgid "<emph>delimiter</emph>: A single character, usually, a comma, a semicolon or a TAB character (Default = \",\")."
msgstr ""
-#. xZgEn
+#. Ehoz6
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id631585563491559\n"
"help.text"
-msgid "<emph>DateFormat</emph> : A special mechanism handles dates when <literal>DateFormat</literal> is either \"YYYY-MM-DD\", \"DD-MM-YYYY\" or \"MM-DD-YYYY\". The dash (-) may be replaced by a dot (.), a slash (/) or a space. Other date formats will be ignored. Dates defaulting to \"\" are considered as normal text."
+msgid "<emph>dateformat</emph>: A special mechanism handles dates when <literal>dateformat</literal> is either \"YYYY-MM-DD\", \"DD-MM-YYYY\" or \"MM-DD-YYYY\". The dash (-) may be replaced by a dot (.), a slash (/) or a space. Other date formats will be ignored. Dates defaulting to an empty string \"\" are considered as normal text."
msgstr ""
-#. MVUwS
+#. oj4Th
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id61585564516409\n"
"help.text"
-msgid "Given this CSV file:"
+msgid "Consider the CSV file \"myFile.csv\" with the following contents:"
+msgstr ""
+
+#. xNCNA
+#: sf_array.xhp
+msgctxt ""
+"sf_array.xhp\n"
+"par_id181626979812772\n"
+"help.text"
+msgid "The examples below in Basic and Python read the contents of the CSV file into an <literal>Array</literal> object."
msgstr ""
#. xCx7D
@@ -1601,40 +1718,40 @@ msgctxt ""
msgid "Look in a one dimension array for a number, a string or a date. Text comparison can be case-sensitive or not. <br/>If the array is sorted it must be filled homogeneously, which means that all items must be scalars of the same type (<literal>Empty</literal> and <literal>Null</literal> items are forbidden). <br/>The result of the method is unpredictable when the array is announced as sorted and actually is not. <br/>A binary search is performed on sorted arrays. Otherwise, arrays are simply scanned from top to bottom and <literal>Empty</literal> and <literal>Null</literal> items are ignored. <br/> <br/>The method returns <literal>LBound(input array) - 1</literal> if the search was not successful."
msgstr ""
-#. mg7DA
+#. Bm5Um
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id315825627687760\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the array to scan."
+msgid "<emph>array_1d</emph>: The array to scan."
msgstr ""
-#. 4CuFE
+#. B5FFj
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id511582562775516\n"
"help.text"
-msgid "<emph>ToFind</emph> : a number, a date or a string to find."
+msgid "<emph>tofind</emph>: A number, a date or a string to find."
msgstr ""
-#. 4YGrJ
+#. i4XQT
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id311582562787187\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Only for string comparisons (Default = <literal>False</literal>)."
msgstr ""
-#. KHzrp
+#. gd5ZZ
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id421582562794501\n"
"help.text"
-msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal>, <literal>\"DESC\"</literal> or <literal>\"\"</literal> (= not sorted, default)"
+msgid "<emph>sortorder</emph>: It can be either \"ASC\", \"DESC\" or \"\" (not sorted). The default value is \"\"."
msgstr ""
#. AWJHj
@@ -1646,76 +1763,76 @@ msgctxt ""
msgid "Insert before a given index of the input array the items listed as arguments. <br/>Arguments are inserted blindly. Each of them might be either a scalar of any type or a subarray."
msgstr ""
-#. 32Nui
+#. FwHz6
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id251582626951111\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
+msgid "<emph>array_1d</emph>: The pre-existing array, may be empty."
msgstr ""
-#. BYjmR
+#. zEACt
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id361582626951111\n"
"help.text"
-msgid "<emph>Before</emph> : the index before which to insert; must be in the interval <literal>[LBound, UBound + 1]</literal>."
+msgid "<emph>before</emph>: The index before which to insert; must be in the interval <literal>[LBound, UBound + 1]</literal>."
msgstr ""
-#. uEZky
+#. iYFC5
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id41582626951111\n"
"help.text"
-msgid "<emph>arg0, ...</emph> : a list of items to insert inside <literal>Array_1D</literal>."
+msgid "<emph>arg0, arg1, ...</emph>: Items that will be inserted into <literal>array_1d</literal>."
msgstr ""
-#. RLTGT
+#. rA4FE
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id441582627664147\n"
"help.text"
-msgid "Insert in a sorted array a new item on its place. <br/>The array must be filled homogeneously, meaning that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are forbidden."
+msgid "Inserts into a sorted array a new item on its place. <br/>The array must be filled homogeneously, meaning that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are forbidden."
msgstr ""
-#. 7q2JZ
+#. jBpdF
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id121582627664147\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to sort."
+msgid "<emph>array_1d</emph>: The array into which the value will be inserted."
msgstr ""
-#. GygFp
+#. 36fZG
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id315826276641480\n"
"help.text"
-msgid "<emph>Item</emph> : The scalar value to insert, of the same type as the existing array items."
+msgid "<emph>item</emph>: The scalar value to insert, of the same type as the existing array items."
msgstr ""
-#. LFGs8
+#. dHYTn
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id415826279771170\n"
"help.text"
-msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
+msgid "<emph>sortorder</emph>: It can be either \"ASC\" (default) or \"DESC\"."
msgstr ""
-#. CwMCp
+#. TJanG
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id701582627970037\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Only for string comparisons (Default = <literal>False</literal>)."
msgstr ""
#. t9UFn
@@ -1727,31 +1844,31 @@ msgctxt ""
msgid "Build a set, as a zero-based array, by applying the intersection set operator on the two input arrays. Resulting items are contained in both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, in other words all items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
msgstr ""
-#. NxFNB
+#. vCyDN
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id881582629216169\n"
"help.text"
-msgid "<emph>Array1_1D</emph> : The first input array."
+msgid "<emph>array1_1d</emph>: The first input array."
msgstr ""
-#. UPgfZ
+#. NhXEb
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id191582629223038\n"
"help.text"
-msgid "<emph>Array2_1D</emph> : The second input array."
+msgid "<emph>array2_1d</emph>: The second input array."
msgstr ""
-#. xHAQT
+#. Dx32U
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id71582629230275\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Applies to arrays populated with text items, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Applies to arrays populated with text items (Default = <literal>False</literal>)."
msgstr ""
#. cirZm
@@ -1763,40 +1880,40 @@ msgctxt ""
msgid "Join a two-dimensional array with two delimiters, one for the columns, one for the rows."
msgstr ""
-#. 6Cm9k
+#. 8xwfF
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id821583064481534\n"
"help.text"
-msgid "<emph>Array_2D</emph> : Each item must be either text, a number, a date or a boolean. <br/>Dates are transformed into the YYYY-MM-DD hh:mm:ss format. <br/>Invalid items are replaced by a zero-length string."
+msgid "<emph>array_2d</emph>: Each item must be either text, a number, a date or a boolean. <br/>Dates are transformed into the YYYY-MM-DD hh:mm:ss format. <br/>Invalid items are replaced by a zero-length string."
msgstr ""
-#. QxLvV
+#. TiqUm
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id171583066989446\n"
"help.text"
-msgid "<emph>ColumnDelimiter</emph> : Delimits each column (default = Tab/Chr(9))."
+msgid "<emph>columndelimiter</emph>: Delimits each column (default = Tab/Chr(9))."
msgstr ""
-#. f9DAW
+#. WG5wm
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id431583067008842\n"
"help.text"
-msgid "<emph>RowDelimiter</emph>: delimits each row (default = LineFeed/Chr(10))"
+msgid "<emph>rowdelimiter</emph>: Delimits each row (default = LineFeed/Chr(10))"
msgstr ""
-#. bB9bB
+#. VrBJV
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id541583067456273\n"
"help.text"
-msgid "<emph>Quote</emph> : if <literal>True</literal>, protect strings with double quotes. The default is <literal>False</literal>."
+msgid "<emph>quote</emph>: If <literal>True</literal>, protect strings with double quotes. The default is <literal>False</literal>."
msgstr ""
#. CEE7o
@@ -1808,22 +1925,22 @@ msgctxt ""
msgid "Prepend at the beginning of the input array the items listed as arguments."
msgstr ""
-#. j5HX9
+#. HSbWh
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id321582630107068\n"
"help.text"
-msgid "<emph>Array_1D</emph> : the pre-existing array, may be empty."
+msgid "<emph>array_1d</emph>: The pre-existing array, may be empty."
msgstr ""
-#. tMmfH
+#. jszVE
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id915826301138550\n"
"help.text"
-msgid "<emph>arg0, ...</emph> : a list of items to prepend to <literal>Array_1D</literal>."
+msgid "<emph>arg0, arg1, ...</emph>: A list of items to prepend to <literal>array_1d</literal>."
msgstr ""
#. BokfB
@@ -1835,22 +1952,22 @@ msgctxt ""
msgid "Prepend to the left side of a two dimension array a new column. The resulting array has the same lower boundaries as the initial two dimension array."
msgstr ""
-#. iBZMy
+#. iBqEm
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id621582643223545\n"
"help.text"
-msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last column of the resulting 2 dimension array."
+msgid "<emph>array_2d</emph>: The pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last column of the resulting 2 dimension array."
msgstr ""
-#. pferZ
+#. aKJwC
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id381582643223870\n"
"help.text"
-msgid "<emph>Column</emph> : a 1 dimension array with as many items as there are rows in <literal>Array_2D</literal>."
+msgid "<emph>column</emph>: A 1-dimensional array with as many items as there are rows in <literal>array_2d</literal>."
msgstr ""
#. xAruD
@@ -1862,22 +1979,22 @@ msgctxt ""
msgid "Prepend at the beginning of a two dimension array a new row. The resulting array has the same lower boundaries as the initial two dimension array."
msgstr ""
-#. gN2hG
+#. nBfC8
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id991582643611645\n"
"help.text"
-msgid "<emph>Array_2D</emph> : the pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last row of the resulting 2 dimension array."
+msgid "<emph>array_2d</emph>: The pre-existing array, may be empty. If that array has 1 dimension, it is considered as the last row of the resulting 2 dimension array."
msgstr ""
-#. mZ2uk
+#. SBF4d
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id321582643611415\n"
"help.text"
-msgid "<emph>Row</emph> : a 1 dimension array containing as many items as there are rows in <literal>Array_2D</literal>."
+msgid "<emph>row</emph>: A 1-dimensional array containing as many items as there are rows in <literal>array_2d</literal>."
msgstr ""
#. WmxAd
@@ -1889,31 +2006,31 @@ msgctxt ""
msgid "Initialize a new zero-based array with numeric values."
msgstr ""
-#. ArYNC
+#. EVXVL
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id591582648204013\n"
"help.text"
-msgid "<emph>From</emph> : value of the first item."
+msgid "<emph>from</emph>: Value of the first item."
msgstr ""
-#. DFUaf
+#. ciMBJ
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id31582648204013\n"
"help.text"
-msgid "<emph>UpTo</emph> : The last item should not exceed <literal>UpTo</literal>."
+msgid "<emph>upto</emph>: The last item should not exceed <literal>UpTo</literal>."
msgstr ""
-#. AJLMR
+#. 2QZtd
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id581582648204014\n"
"help.text"
-msgid "<emph>ByStep</emph> : The difference between two successive items (default = 1)."
+msgid "<emph>bystep</emph>: The difference between two successive items (Default = 1)."
msgstr ""
#. SbVGG
@@ -1925,76 +2042,76 @@ msgctxt ""
msgid "Return the reversed one dimension input array."
msgstr ""
-#. zvyHb
+#. dG6d8
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id31582648806765\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to reverse."
+msgid "<emph>array_1d</emph>: The array to reverse."
msgstr ""
-#. FGBiV
+#. tkEUv
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id151582649200088\n"
"help.text"
-msgid "Return a random permutation of a one dimension array."
+msgid "Returns a random permutation of a one-dimensional array."
msgstr ""
-#. 3NPAi
+#. xFwWY
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id11582649200088\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to shuffle."
+msgid "<emph>array_1d</emph>: The array to shuffle."
msgstr ""
-#. ATiL8
+#. BvV5v
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"bas_id611582649200089\n"
"help.text"
-msgid "' Unpredictable"
+msgid "' Array \"a\" is now in random order, f.i. (2, 3, 1, 4)"
msgstr ""
-#. 9Xgaq
+#. GhFBG
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id111586184185502\n"
"help.text"
-msgid "Return a subset of a one dimension array."
+msgid "Returns a subset of a one-dimensional array."
msgstr ""
-#. QavhQ
+#. YeRkh
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id201586184185438\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to slice."
+msgid "<emph>array_1d</emph>: The array to slice."
msgstr ""
-#. hVu6E
+#. UzHmT
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id921586184482370\n"
"help.text"
-msgid "<emph>From</emph> : The lower index in <literal>Array_1D</literal> of the subarray to extract (<literal>From</literal> included)"
+msgid "<emph>from</emph>: The lower index in <literal>array_1d</literal> of the subarray to extract (<literal>from</literal> included)"
msgstr ""
-#. 968pV
+#. 326GB
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id211586184471488\n"
"help.text"
-msgid "<emph>UpTo</emph> : The upper index in <literal>Array_1D</literal> of the subarray to extract (<literal>UpTo</literal> included). Default = upper bound of <literal>Array_1D</literal>. If <literal>UpTo</literal> < <literal>From</literal> then the returned array is empty."
+msgid "<emph>upto</emph>: The upper index in <literal>array_1d</literal> of the subarray to extract (<literal>upto</literal> included). The default value is the upper bound of <literal>array_1d</literal>. If <literal>upto</literal> < <literal>from</literal> then the returned array is empty."
msgstr ""
#. oBwcF
@@ -2006,31 +2123,31 @@ msgctxt ""
msgid "Sort a one dimension array in ascending or descending order. Text comparisons can be case-sensitive or not. <br/>The array must be filled homogeneously, which means that items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value."
msgstr ""
-#. ABuRp
+#. eNuB8
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id71158264948346\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to sort."
+msgid "<emph>array_1d</emph>: The array to sort."
msgstr ""
-#. zSoB2
+#. 7S2Bq
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id21582649483175\n"
"help.text"
-msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
+msgid "<emph>sortorder</emph>: It can be either \"ASC\" (default) or \"DESC\"."
msgstr ""
-#. cYvQY
+#. K4GrR
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id301582649483187\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Only for string comparisons (Default = <literal>False</literal>)."
msgstr ""
#. 6CkrZ
@@ -2042,40 +2159,40 @@ msgctxt ""
msgid "Return a permutation of the columns of a two dimension array, sorted on the values of a given row. <br/>The row must be filled homogeneously, which means that all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value."
msgstr ""
-#. EGBcR
+#. ww7Us
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id921582650186869\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to sort."
+msgid "<emph>array_2d</emph>: The 2-dimensional array to sort."
msgstr ""
-#. cBvze
+#. GdFxm
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id311582650186221\n"
"help.text"
-msgid "<emph>RowIndex</emph> : The index of the row to sort the columns on."
+msgid "<emph>rowindex</emph>: The index of the row that will be used as reference to sort the columns."
msgstr ""
-#. hJKGY
+#. toBNF
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id34158265018698\n"
"help.text"
-msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
+msgid "<emph>sortorder</emph>: It can be either \"ASC\" (default) or \"DESC\"."
msgstr ""
-#. UdJPV
+#. BFduL
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id91158265018699\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Only for string comparisons (Default = <literal>False</literal>)."
msgstr ""
#. 7GkBx
@@ -2087,58 +2204,58 @@ msgctxt ""
msgid "Return a permutation of the rows of a two dimension array, sorted on the values of a given column. <br/>The column must be filled homogeneously, therefore all items must be scalars of the same type. <br/><literal>Empty</literal> and <literal>Null</literal> items are allowed. Conventionally <literal>Empty</literal> < <literal>Null</literal> < any other scalar value."
msgstr ""
-#. MCFqq
+#. durL8
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id621582650954370\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to sort."
+msgid "<emph>array_2d</emph>: The array to sort."
msgstr ""
-#. FeVrv
+#. HZqQi
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id361582650954796\n"
"help.text"
-msgid "<emph>RowIndex</emph> : The index of the column to sort the rows on."
+msgid "<emph>columnindex</emph>: The index of the column that will be used as reference to sort the rows."
msgstr ""
-#. rxXiT
+#. 7TDWy
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id471582650954416\n"
"help.text"
-msgid "<emph>SortOrder</emph> : <literal>\"ASC\"</literal> (default) or <literal>\"DESC\"</literal>."
+msgid "<emph>sortorder</emph>: It can be either \"ASC\" (default) or \"DESC\"."
msgstr ""
-#. u4SYA
+#. 9YDzi
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id111582650954690\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only for string comparisons, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Only for string comparisons (Default = <literal>False</literal>)."
msgstr ""
-#. R8mAZ
+#. skzGA
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id611582651575637\n"
"help.text"
-msgid "Swap rows and columns in a two dimension array."
+msgid "Swaps rows and columns in a two-dimensional array."
msgstr ""
-#. bAzjH
+#. gcbVN
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id61582651575188\n"
"help.text"
-msgid "<emph>Array_2D</emph> : The array to transpose."
+msgid "<emph>array_2d</emph>: The 2-dimensional array to transpose."
msgstr ""
#. dwAVQ
@@ -2150,49 +2267,49 @@ msgctxt ""
msgid "Remove from a one dimension array all <literal>Null</literal>, <literal>Empty</literal> and zero-length entries. <br/>String items are trimmed with %PRODUCTNAME Basic <literal>Trim()</literal> function."
msgstr ""
-#. pgrAD
+#. L8FQg
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id111582652996147\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The array to scan."
+msgid "<emph>array_1d</emph>: The array to trim."
msgstr ""
-#. W6HBB
+#. bjHF2
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id461582653148663\n"
"help.text"
-msgid "Build a set, as a zero-based array, by applying the union operator on the two input arrays. Resulting items originate from both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
+msgid "Build a set, as a zero-based array, by applying the union operator on the two input arrays. Resulting items originate from any of both arrays. <br/>The resulting array is sorted in ascending order. <br/>Both input arrays must be filled homogeneously, their items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
msgstr ""
-#. ZSpA9
+#. oHeQj
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id4715826531488\n"
"help.text"
-msgid "<emph>Array1_1D</emph> : The first input array."
+msgid "<emph>array1_1d</emph>: The first input array."
msgstr ""
-#. bD9nv
+#. GJuXQ
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id51158265314898\n"
"help.text"
-msgid "<emph>Array2_1D</emph> : The second input array."
+msgid "<emph>array2_1d</emph>: The second input array."
msgstr ""
-#. k5Xve
+#. HNhsz
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id821582653148126\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only if the arrays are populated with strings, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Applicable only if the arrays are populated with strings (Default = <literal>False</literal>)."
msgstr ""
#. CGMRq
@@ -2204,22 +2321,22 @@ msgctxt ""
msgid "Build a set of unique values derived from the input array. <br/>The input array must be filled homogeneously, its items must be scalars of the same type. <literal>Empty</literal> and <literal>Null</literal> items are forbidden. <br/>Text comparison can be case sensitive or not."
msgstr ""
-#. g5SkL
+#. bcFGM
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id521582653464553\n"
"help.text"
-msgid "<emph>Array_1D</emph> : The input array."
+msgid "<emph>array_1d</emph>: The input array."
msgstr ""
-#. V4F4E
+#. MYeE2
#: sf_array.xhp
msgctxt ""
"sf_array.xhp\n"
"par_id41158265346441\n"
"help.text"
-msgid "<emph>CaseSensitive</emph> : Only if the array is populated with texts, default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: Applicable only if the array is populated with strings (Default = <literal>False</literal>)."
msgstr ""
#. GAXAU
@@ -2366,6 +2483,33 @@ msgctxt ""
msgid "List of Methods in the Base Service"
msgstr ""
+#. TvfQt
+#: sf_base.xhp
+msgctxt ""
+"sf_base.xhp\n"
+"par_id801916099743199\n"
+"help.text"
+msgid "Closes the given form document. Returns <literal>True</literal> if closure is successful."
+msgstr ""
+
+#. HFyny
+#: sf_base.xhp
+msgctxt ""
+"sf_base.xhp\n"
+"par_id941619079997810\n"
+"help.text"
+msgid "<emph>formDocument:</emph> The name of the <literal>FormDocument</literal> to be closed, as a case-sensitive string."
+msgstr ""
+
+#. aLKLw
+#: sf_base.xhp
+msgctxt ""
+"sf_base.xhp\n"
+"par_id351619100723505\n"
+"help.text"
+msgid "If form documents are organized in folders, it is necessary to include the folder name to specify the form document to be opened, as illustrated in the following examples:"
+msgstr ""
+
#. ZQnqj
#: sf_base.xhp
msgctxt ""
@@ -2564,15 +2708,6 @@ msgctxt ""
msgid "Most form documents are stored in the root of the Base document and they can be opened simply using their names, as in the example below:"
msgstr ""
-#. pv3RA
-#: sf_base.xhp
-msgctxt ""
-"sf_base.xhp\n"
-"bas_id461619100283210\n"
-"help.text"
-msgid "oDoc.OpenFormDocument(\"myFormDocument\")"
-msgstr ""
-
#. ACLqQ
#: sf_base.xhp
msgctxt ""
@@ -2582,15 +2717,6 @@ msgctxt ""
msgid "If form documents are organized in folders, it becomes necessary to include the folder name to specify the form document to be opened, as illustrated in the following example:"
msgstr ""
-#. mLgzR
-#: sf_base.xhp
-msgctxt ""
-"sf_base.xhp\n"
-"bas_id461619100283712\n"
-"help.text"
-msgid "oDoc.OpenFormDocument(\"myFolder/myFormDocument\")"
-msgstr ""
-
#. 3RzkD
#: sf_basic.xhp
msgctxt ""
@@ -2708,15 +2834,6 @@ msgctxt ""
msgid "Description"
msgstr ""
-#. W8eh6
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id541619003984227\n"
-"help.text"
-msgid "MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_YESNO, MB_YESNOCANCEL"
-msgstr ""
-
#. KuiAD
#: sf_basic.xhp
msgctxt ""
@@ -2726,15 +2843,6 @@ msgctxt ""
msgid "Yes"
msgstr ""
-#. TkYXL
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id111619004011627\n"
-"help.text"
-msgid "integer"
-msgstr ""
-
#. 7DG4F
#: sf_basic.xhp
msgctxt ""
@@ -2744,15 +2852,6 @@ msgctxt ""
msgid "Values: 0, 1, 5, 4, 3"
msgstr ""
-#. oASRR
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id161619003998035\n"
-"help.text"
-msgid "MB_ICONEXCLAMATION, MB_ICONINFORMATION, MB_ICONQUESTION, MB_ICONSTOP"
-msgstr ""
-
#. 8ie8B
#: sf_basic.xhp
msgctxt ""
@@ -2762,15 +2861,6 @@ msgctxt ""
msgid "Yes"
msgstr ""
-#. GNqXc
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id981619004098700\n"
-"help.text"
-msgid "integer"
-msgstr ""
-
#. DQkGQ
#: sf_basic.xhp
msgctxt ""
@@ -2780,15 +2870,6 @@ msgctxt ""
msgid "Values: 48, 64, 32, 16<br/>"
msgstr ""
-#. RBdBG
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id831618922991909\n"
-"help.text"
-msgid "MB_ABORTRETRYIGNORE, MB_DEFBUTTON1, MB_DEFBUTTON2, MB_DEFBUTTON3"
-msgstr ""
-
#. mCpye
#: sf_basic.xhp
msgctxt ""
@@ -2798,15 +2879,6 @@ msgctxt ""
msgid "Yes"
msgstr ""
-#. CrG3W
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id161618922991910\n"
-"help.text"
-msgid "integer"
-msgstr ""
-
#. h3hZE
#: sf_basic.xhp
msgctxt ""
@@ -2816,15 +2888,6 @@ msgctxt ""
msgid "Values: 2, 128, 256, 512"
msgstr ""
-#. F3DMG
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id471618924470655\n"
-"help.text"
-msgid "IDABORT, IDCANCEL, IDIGNORE, IDNO, IDOK, IDRETRY, IDYES"
-msgstr ""
-
#. kLst4
#: sf_basic.xhp
msgctxt ""
@@ -2834,15 +2897,6 @@ msgctxt ""
msgid "Yes"
msgstr ""
-#. XKzky
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id571618924505303\n"
-"help.text"
-msgid "integer"
-msgstr ""
-
#. Tmtc2
#: sf_basic.xhp
msgctxt ""
@@ -2852,15 +2906,6 @@ msgctxt ""
msgid "Values: 3, 2, 5, 7, 1, 4, 6<br/>Constants indicating <literal>MsgBox</literal> selected button."
msgstr ""
-#. fHLnu
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id421619006246768\n"
-"help.text"
-msgid "StarDesktop"
-msgstr ""
-
#. BDtqm
#: sf_basic.xhp
msgctxt ""
@@ -3032,13 +3077,13 @@ msgctxt ""
msgid "Instantiates a UNO service with the <literal>ProcessServiceManager</literal>."
msgstr ""
-#. 7BvYk
+#. SF7gE
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id361589200121646\n"
"help.text"
-msgid "<emph>servicename</emph> : A fully qualified service name such as \"com.sun.star.ui.dialogs.FilePicker\" or 'com.sun.star.sheet.FunctionAccess'."
+msgid "<emph>servicename</emph>: A fully qualified service name such as <literal>com.sun.star.ui.dialogs.FilePicker</literal> or <literal>com.sun.star.sheet.FunctionAccess</literal>."
msgstr ""
#. rZoCx
@@ -3068,22 +3113,22 @@ msgctxt ""
msgid "<emph>number</emph>: A numerical expression specifying how often the <literal>interval</literal> value will be added when positive or subtracted when negative."
msgstr ""
-#. 4C2B6
+#. CCveG
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id811618561843272\n"
"help.text"
-msgid "<emph>date</emph>: A given datetime.datetime value, the <literal>interval</literal> value will be added number times to this date/time value."
+msgid "<emph>date</emph>: A given <literal>datetime.datetime</literal> value, the <literal>interval</literal> value will be added <literal>number</literal> times to this <literal>datetime.datetime</literal> value."
msgstr ""
-#. ppBnh
+#. Zcf9q
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id181618561778320\n"
"help.text"
-msgid "A datetime.datetime value."
+msgid "A <literal>datetime.datetime</literal> value."
msgstr ""
#. HAVdW
@@ -3095,22 +3140,22 @@ msgctxt ""
msgid "Returns the number of date or time intervals between two given date/time values."
msgstr ""
-#. 2HBSe
+#. 68XgA
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id481618563770490\n"
"help.text"
-msgid "<emph>interval</emph>: A string expression specifying the date interval, as detailed in above <literal>DateAdd</literal> method."
+msgid "<emph>interval</emph>: A string expression specifying the date interval, as detailed in above <literal>DateAdd</literal> method."
msgstr ""
-#. ZAKJ9
+#. DQFt3
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id121618563772932\n"
"help.text"
-msgid "<emph>date1</emph>, <emph>date2</emph>: The two datetime.datetime values to be compared."
+msgid "<emph>date1</emph>, <emph>date2</emph>: The two <literal>datetime.datetime</literal> values to be compared."
msgstr ""
#. ZR7AD
@@ -3122,22 +3167,22 @@ msgctxt ""
msgid "A number."
msgstr ""
-#. KPEWi
+#. K4Lp7
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id81589202925519\n"
"help.text"
-msgid "The DatePart function returns a specified part of a date."
+msgid "The <literal>DatePart</literal> function returns a specified part of a date."
msgstr ""
-#. ens2Q
+#. vCQGJ
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id761618672192231\n"
"help.text"
-msgid "<emph>interval</emph>: A string expression specifying the date interval, as detailed in above <literal>DateAdd</literal> method."
+msgid "<emph>interval</emph>: A string expression specifying the date interval, as detailed in above <literal>DateAdd</literal> method."
msgstr ""
#. KuDhD
@@ -3284,42 +3329,6 @@ msgctxt ""
msgid "Returns the number of system ticks provided by the operating system. You can use this function to optimize certain processes. Use this method to estimate time in milliseconds:"
msgstr ""
-#. CEtsQ
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"pyc_id251619448108905\n"
-"help.text"
-msgid "ticks_ini = svc.GetSystemTicks()"
-msgstr ""
-
-#. SG6mf
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"pyc_id181619448111210\n"
-"help.text"
-msgid "time.sleep(1)"
-msgstr ""
-
-#. MZXnC
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"pyc_id301619448111744\n"
-"help.text"
-msgid "ticks_end = svc.GetSystemTicks()"
-msgstr ""
-
-#. dSmH3
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"pyc_id651619448112320\n"
-"help.text"
-msgid "svc.MsgBox(\"{} - {} = {}\".format(ticks_end, ticks_ini,ticks_end - ticks_ini))"
-msgstr ""
-
#. t3ADN
#: sf_basic.xhp
msgctxt ""
@@ -3401,15 +3410,6 @@ msgctxt ""
msgid "<bookmark_value>Basic service;InputBox</bookmark_value>"
msgstr ""
-#. 7GPZv
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id21619008398677\n"
-"help.text"
-msgid "string"
-msgstr ""
-
#. qRtw5
#: sf_basic.xhp
msgctxt ""
@@ -3419,13 +3419,13 @@ msgctxt ""
msgid "txt = s.InputBox('Please enter a phrase:', \"Dear user\")"
msgstr ""
-#. UgiDk
+#. B2mnv
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"pyc_id261619081319555\n"
"help.text"
-msgid "s.MsgBox(txt, MB_ICONINFORMATION, \"Confirmation of phrase\")"
+msgid "s.MsgBox(txt, s.MB_ICONINFORMATION, \"Confirmation of phrase\")"
msgstr ""
#. 42vSm
@@ -3500,24 +3500,6 @@ msgctxt ""
msgid "Returns an integer color value consisting of red, green, and blue components."
msgstr ""
-#. vPBAA
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id201619096429785\n"
-"help.text"
-msgid "<input>svc.RGB(red:int, green: int, blue: int): int</input>"
-msgstr ""
-
-#. AAeE4
-#: sf_basic.xhp
-msgctxt ""
-"sf_basic.xhp\n"
-"par_id381619096830033\n"
-"help.text"
-msgid "integer"
-msgstr ""
-
#. SDu3C
#: sf_basic.xhp
msgctxt ""
@@ -3599,13 +3581,13 @@ msgctxt ""
msgid "Inspect Uno objects or variables."
msgstr ""
-#. 2A4om
+#. CDCQx
#: sf_basic.xhp
msgctxt ""
"sf_basic.xhp\n"
"par_id21619094660345\n"
"help.text"
-msgid "<emph>obj</emph>: A variable or Uno object."
+msgid "<emph>obj</emph>: A variable or UNO object."
msgstr ""
#. fMbAm
@@ -3635,22 +3617,22 @@ msgctxt ""
msgid "<variable id=\"CalcService\"><link href=\"text/sbasic/shared/03/sf_calc.xhp\" name=\"Calc service\"><literal>SFDocuments</literal>.<literal>Calc</literal> service</link></variable>"
msgstr ""
-#. DGXCA
+#. EkFAT
#: sf_calc.xhp
msgctxt ""
"sf_calc.xhp\n"
"par_id381589189355849\n"
"help.text"
-msgid "The <literal>SFDocuments</literal> library provides a number of methods and properties to facilitate the management and handling of %PRODUCTNAME Calc documents."
+msgid "The <literal>SFDocuments</literal> shared library provides a number of methods and properties to facilitate the management and handling of %PRODUCTNAME documents."
msgstr ""
-#. m4FFE
+#. r34Cu
#: sf_calc.xhp
msgctxt ""
"sf_calc.xhp\n"
"par_id351591014177269\n"
"help.text"
-msgid "Some methods are generic for all types of documents and are inherited from the <literal>Document</literal> service, whereas other methods are specific for the <literal>SF_Calc</literal> module."
+msgid "Some methods are generic for all types of documents and are inherited from the <literal>SF_Document</literal> module, whereas other methods that are specific for Calc documents are defined in the <literal>SF_Calc</literal> module."
msgstr ""
#. kTVJM
@@ -4868,15 +4850,6 @@ msgctxt ""
msgid "Copy from one file to another:"
msgstr ""
-#. 2fvZe
-#: sf_calc.xhp
-msgctxt ""
-"sf_calc.xhp\n"
-"pyc_id761621538667290\n"
-"help.text"
-msgid "doc.CopyToRange(\"SheetX.A1:F10\", \"SheetY.C5:J5\")"
-msgstr ""
-
#. so8uw
#: sf_calc.xhp
msgctxt ""
@@ -4967,42 +4940,6 @@ msgctxt ""
msgid "In the following examples, the first line gets the names of all forms stored in \"Sheet1\" and the second line retrieves the <literal>Form</literal> object of the form named \"Form_A\" which is stored in \"Sheet1\"."
msgstr ""
-#. G9yMh
-#: sf_calc.xhp
-msgctxt ""
-"sf_calc.xhp\n"
-"bas_id191623063399519\n"
-"help.text"
-msgid "Set FormNames = oDoc.Forms(\"Sheet1\")"
-msgstr ""
-
-#. cFBZw
-#: sf_calc.xhp
-msgctxt ""
-"sf_calc.xhp\n"
-"bas_id691623063399711\n"
-"help.text"
-msgid "Set FormA = oDoc.Forms(\"Sheet1\", \"Form_A\")"
-msgstr ""
-
-#. NY6Wb
-#: sf_calc.xhp
-msgctxt ""
-"sf_calc.xhp\n"
-"pyc_id271623063215023\n"
-"help.text"
-msgid "form_names = doc.Forms(\"Sheet1\")"
-msgstr ""
-
-#. DQsCo
-#: sf_calc.xhp
-msgctxt ""
-"sf_calc.xhp\n"
-"pyc_id961623063234990\n"
-"help.text"
-msgid "form_A = doc.Forms(\"Sheet1\", \"Form_A\")"
-msgstr ""
-
#. y9kCE
#: sf_calc.xhp
msgctxt ""
@@ -5507,15 +5444,6 @@ msgctxt ""
msgid "Removes an existing sheet from the document."
msgstr ""
-#. Gwe7Z
-#: sf_calc.xhp
-msgctxt ""
-"sf_calc.xhp\n"
-"par_id991621620588147\n"
-"help.text"
-msgid "<input>svc.RemoveSheet(sheetname: str): bool</input>"
-msgstr ""
-
#. dVxiA
#: sf_calc.xhp
msgctxt ""
@@ -5993,13 +5921,22 @@ msgctxt ""
msgid "Run SQL action statements such as <literal>INSERT</literal>, <literal>UPDATE</literal>, <literal>DELETE</literal>, etc."
msgstr ""
-#. ABgYk
+#. 7CSTo
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id811599407236602\n"
"help.text"
-msgid "Each instance of the <literal>Database</literal> service represents a single database and gives access to its tables, queries and data. This service does not provide access to forms or reports in the Base document."
+msgid "Each instance of the <literal>Database</literal> service represents a single database and gives access to its tables, queries and data."
+msgstr ""
+
+#. JopCB
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"par_id111625692871642\n"
+"help.text"
+msgid "This service does not provide access to forms or reports in the Base document that contains the database. To access forms in a Base document, refer to the method <link href=\"text/sbasic/shared/03/sf_base.xhp#FormDocuments\" name=\"FormDocuments\"><literal>FormDocuments</literal></link> of the <literal>Base</literal> service."
msgstr ""
#. Snu6R
@@ -6029,13 +5966,13 @@ msgctxt ""
msgid "The provided interfaces include simple tables and queries lists, as well as access to database data."
msgstr ""
-#. N3J98
+#. 644XA
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id891599407280007\n"
"help.text"
-msgid "To make SQL statements more readable, you can use optional square brackets to enclose tables, queries and fields instead of using other enclosing characters that may be exclusive to certain Relational Database Management Systems (RDBMS)."
+msgid "To make SQL statements more readable, you may use square brackets \"[ ]\" to enclose names of tables, queries and fields instead of using other enclosing characters that may be exclusive to certain Relational Database Management Systems (RDBMS). But beware that enclosing characters are mandatory in this context."
msgstr ""
#. CAFnK
@@ -6047,67 +5984,85 @@ msgctxt ""
msgid "Service invocation"
msgstr ""
-#. GBCxf
+#. Cr4oo
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id541599408159668\n"
"help.text"
-msgid "The code snippet below shows how to access any database with the <literal>Database</literal> service."
+msgid "To create a instance of the <literal>Database</literal> service you can use the <literal>CreateScriptService</literal> method:"
msgstr ""
-#. RApNW
+#. ArhV5
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
-"bas_id471599408248873\n"
+"par_id551625693442959\n"
"help.text"
-msgid "' ... Run queries, SQL statements, ..."
+msgid "In the syntax described above you can use either \"SFDatabases.Database\" or simply \"Database\" as the first argument of the <literal>CreateScriptService</literal> method."
msgstr ""
-#. f2tV4
+#. S7oNc
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id111615146818256\n"
"help.text"
-msgid "<emph>FileName</emph>: The name of the Base file. Must be expressed using <literal>SF_FileSystem.FileNaming</literal> notation."
+msgid "<emph>filename</emph>: The name of the Base file. Must be expressed using <literal>SF_FileSystem.FileNaming</literal> notation."
msgstr ""
-#. yg5bv
+#. fUxEZ
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id771615146944307\n"
"help.text"
-msgid "<emph>RegistrationName</emph>: The name of a registered database. If a file name is provided, this argument should not be used."
+msgid "<emph>registrationname</emph>: The name of a registered database. If <literal>filename</literal> is provided, this argument should not be used."
msgstr ""
-#. RM9c6
+#. J2NA3
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id491615147048748\n"
"help.text"
-msgid "Conversely, if a <literal>RegistrationName</literal> is specified, the <literal>FileName</literal> parameter should not be defined."
+msgid "Conversely, if a <literal>registrationname</literal> is specified, the <literal>filename</literal> parameter should not be defined."
msgstr ""
-#. Bc97U
+#. YQF4D
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id841615147168279\n"
"help.text"
-msgid "<emph>ReadOnly</emph>: Determines if the database will be opened as readonly (Default = <literal>True</literal>)."
+msgid "<emph>readonly</emph>: Determines if the database will be opened as readonly (Default = <literal>True</literal>)."
msgstr ""
-#. Gn7AF
+#. 9FEG5
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id291615147236001\n"
"help.text"
-msgid "<emph>User, Password</emph>: Additional connection parameters to the database server."
+msgid "<emph>user, password</emph>: Additional connection parameters to the database server."
+msgstr ""
+
+#. ZG5pH
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"bas_id871625698095504\n"
+"help.text"
+msgid "' Run queries, SQL statements, ..."
+msgstr ""
+
+#. uWJrQ
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id791625698186675\n"
+"help.text"
+msgid "# Run queries, SQL statements, ..."
msgstr ""
#. Z2VVg
@@ -6119,13 +6074,13 @@ msgctxt ""
msgid "Accessing Databases with the UI Service"
msgstr ""
-#. 6s3Hr
+#. 5Kifs
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id901599408410712\n"
"help.text"
-msgid "It is also possible to access the database associated with a Base document using the <link href=\"text/sbasic/shared/03/sf_ui.xhp\" name=\"UI Service\"><literal>ScriptForge.UI</literal></link> service, as shown in the example below:"
+msgid "It is also possible to access the database associated with a Base document using the <link href=\"text/sbasic/shared/03/sf_ui.xhp\" name=\"UI Service\"><literal>ScriptForge.UI</literal></link> service, as shown in the examples below:"
msgstr ""
#. T6mkQ
@@ -6137,13 +6092,76 @@ msgctxt ""
msgid "' User and password are supplied below, if needed"
msgstr ""
-#. 88wGG
+#. F43tz
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"bas_id921599408791887\n"
"help.text"
-msgid "' ... Run queries, SQL statements, ..."
+msgid "' Run queries, SQL statements, ..."
+msgstr ""
+
+#. VDFaU
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id881625699438103\n"
+"help.text"
+msgid "ui = CreateScriptService(\"UI\")"
+msgstr ""
+
+#. EeDew
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id111625699438354\n"
+"help.text"
+msgid "doc = ui.OpenBaseDocument(\"/home/user/Documents/myDB.odb\")"
+msgstr ""
+
+#. FsCDs
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id731625699527917\n"
+"help.text"
+msgid "# User and password are supplied below, if needed"
+msgstr ""
+
+#. b8DCF
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id741625699438527\n"
+"help.text"
+msgid "myDatabase = doc.GetDatabase()"
+msgstr ""
+
+#. BDNDo
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id201625699438702\n"
+"help.text"
+msgid "# Run queries, SQL statements, ..."
+msgstr ""
+
+#. yL6GV
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id171625699438887\n"
+"help.text"
+msgid "myDatabase.CloseDatabase()"
+msgstr ""
+
+#. SAyeP
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"pyc_id231625699570502\n"
+"help.text"
+msgid "doc.CloseDocument()"
msgstr ""
#. AVkg5
@@ -6326,31 +6344,31 @@ msgctxt ""
msgid "Optionally, a SQL <literal>WHERE</literal> clause can be specified as a filter that will be applied prior to the aggregate function."
msgstr ""
-#. rKxVP
+#. AKqei
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id441596554849949\n"
"help.text"
-msgid "<emph>Expression</emph>: A SQL expression in which the field names are surrounded with square brackets."
+msgid "<emph>expression</emph>: A SQL expression in which the field names are surrounded with square brackets."
msgstr ""
-#. 3PSmS
+#. c2Rzq
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id381596554849698\n"
"help.text"
-msgid "<emph>TableName</emph>: A table name (without square brackets)."
+msgid "<emph>tablename</emph>: A table name (without square brackets)."
msgstr ""
-#. F4AAZ
+#. cjGPp
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id521596554849185\n"
"help.text"
-msgid "<emph>Criteria</emph>: A <literal>WHERE</literal> clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets."
+msgid "<emph>criteria</emph>: A <literal>WHERE</literal> clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets."
msgstr ""
#. AGBFS
@@ -6407,40 +6425,40 @@ msgctxt ""
msgid "If the query returns multiple records, only the first one is considered. Use the <literal>OrderClause</literal> parameter to determine how query results are sorted."
msgstr ""
-#. CNwh2
+#. tNnSe
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id671599488113986\n"
"help.text"
-msgid "<emph>Expression</emph>: A SQL expression in which the field names are surrounded with square brackets."
+msgid "<emph>expression</emph>: A SQL expression in which the field names are surrounded with square brackets."
msgstr ""
-#. 5DGVh
+#. eGbAr
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id441599488113247\n"
"help.text"
-msgid "<emph>TableName</emph>: A table name (without square brackets)."
+msgid "<emph>tablename</emph>: A table name (without square brackets)."
msgstr ""
-#. jtrX7
+#. F9xaH
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id40159948811316\n"
"help.text"
-msgid "<emph>Criteria</emph>: A <literal>WHERE</literal> clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets."
+msgid "<emph>criteria</emph>: A <literal>WHERE</literal> clause without the \"WHERE\" keyword, in which field names are surrounded with square brackets."
msgstr ""
-#. X5HJp
+#. SusUk
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id71599488689029\n"
"help.text"
-msgid "<emph>OrderClause</emph>: An <literal>ORDER BY</literal> clause without the \"ORDER BY\" keywords. Field names should be surrounded with square brackets."
+msgid "<emph>orderclause</emph>: An <literal>ORDER BY</literal> clause without the \"ORDER BY\" keywords. Field names should be surrounded with square brackets."
msgstr ""
#. CPoBx
@@ -6470,40 +6488,40 @@ msgctxt ""
msgid "The returned array will be empty if no rows are returned and the column headers are not required."
msgstr ""
-#. dURZU
+#. y5u8i
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id451599489278429\n"
"help.text"
-msgid "<emph>SQLCommand</emph>: A table or query name (without square brackets) or a <literal>SELECT</literal> SQL statement."
+msgid "<emph>sqlcommand</emph>: A table or query name (without square brackets) or a <literal>SELECT</literal> SQL statement."
msgstr ""
-#. fFFFd
+#. xAbDx
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id271599489278141\n"
"help.text"
-msgid "<emph>DirectSQL</emph>: When <literal>True</literal>, the SQL command is sent to the database engine without pre-analysis. Default is <literal>False</literal>. This argument is ignored for tables. For queries, the applied option is the one set when the query was defined."
+msgid "<emph>directsql</emph>: When <literal>True</literal>, the SQL command is sent to the database engine without pre-analysis. Default is <literal>False</literal>. This argument is ignored for tables. For queries, the applied option is the one set when the query was defined."
msgstr ""
-#. unoDn
+#. DEzQD
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id941599489278747\n"
"help.text"
-msgid "<emph>Header</emph>: When <literal>True</literal>, the first row of the returned array contains the column headers."
+msgid "<emph>header</emph>: When <literal>True</literal>, the first row of the returned array contains the column headers."
msgstr ""
-#. BZxwK
+#. P2SMx
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id591599489278926\n"
"help.text"
-msgid "<emph>MaxRows</emph>: The maximum number of rows to return. The default is zero, meaning there is no limit to the number of returned rows."
+msgid "<emph>maxrows</emph>: The maximum number of rows to return. The default is zero, meaning there is no limit to the number of returned rows."
msgstr ""
#. 3XZPf
@@ -6560,22 +6578,31 @@ msgctxt ""
msgid "The <literal>RunSql</literal> method is rejected with an error message in case the database was previously opened in read-only mode."
msgstr ""
-#. cMjus
+#. AN4H9
+#: sf_database.xhp
+msgctxt ""
+"sf_database.xhp\n"
+"par_id421625701780046\n"
+"help.text"
+msgid "<input>db.RunSql(sqlcommand: str, directsql: bool = False): bool</input>"
+msgstr ""
+
+#. WnUpF
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id701599490609473\n"
"help.text"
-msgid "<emph>SQLCommand</emph>: A query name (without square brackets) or a SQL statement."
+msgid "<emph>sqlcommand</emph>: A query name (without square brackets) or a SQL statement."
msgstr ""
-#. kngXb
+#. uNMDN
#: sf_database.xhp
msgctxt ""
"sf_database.xhp\n"
"par_id51599490609377\n"
"help.text"
-msgid "<emph>DirectSQL</emph>: When <literal>True</literal>, the SQL command is sent to the database engine without pre-analysis. (Default = <literal>False</literal>). For queries, the applied option is the one set when the query was defined."
+msgid "<emph>directsql</emph>: When <literal>True</literal>, the SQL command is sent to the database engine without pre-analysis. (Default = <literal>False</literal>). For queries, the applied option is the one set when the query was defined."
msgstr ""
#. BC4Sc
@@ -9170,6 +9197,60 @@ msgctxt ""
msgid "It is recommended to free resources after use:"
msgstr ""
+#. gpGvc
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"par_id551626869252987\n"
+"help.text"
+msgid "The example below creates an empty instance of the <literal>Dictionary</literal> service and uses the Python native <literal>update</literal> method to populate it with the contents of a Python <literal>dict</literal> object."
+msgstr ""
+
+#. bnDdK
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"pyc_id61626869417128\n"
+"help.text"
+msgid "# Initialize myDict as an empty dict object"
+msgstr ""
+
+#. Zijqj
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"pyc_id921626869402748\n"
+"help.text"
+msgid "# Load the values of dico into myDict"
+msgstr ""
+
+#. G4WCE
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"par_id981626869718081\n"
+"help.text"
+msgid "It is possible to create an instance of the <literal>Dictionary</literal> service using a Python <literal>dict</literal> object as argument as shown in the following example."
+msgstr ""
+
+#. ymvAC
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"pyc_id201626869185236\n"
+"help.text"
+msgid "# Initialize myDict with the content of dico"
+msgstr ""
+
+#. UHQFC
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"par_id211626699007613\n"
+"help.text"
+msgid "Because Python has built-in dictionary support, most of the methods in the <literal>Dictionary</literal> service are available for Basic scripts only. Exceptions are <literal>ConvertToPropertyValues</literal> and <literal>ImportFromPropertyValues</literal> that are supported in both Basic and Python."
+msgstr ""
+
#. Dd4Pp
#: sf_dictionary.xhp
msgctxt ""
@@ -9323,22 +9404,22 @@ msgctxt ""
msgid "Adds a new key-item pair into the dictionary. Returns <literal>True</literal> if successful."
msgstr ""
-#. 3MMGU
+#. 4zw8b
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id341582887670030\n"
"help.text"
-msgid "<emph>Key</emph> : String value used to identify the Item. The key is not case-sensitive."
+msgid "<emph>key</emph>: String value used to identify the Item. The key is not case-sensitive."
msgstr ""
-#. aGgh9
+#. UFFFG
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id401582887670030\n"
"help.text"
-msgid "<emph>Item</emph> : Any value, including an array, a Basic object, a UNO object, a dictionary, etc."
+msgid "<emph>item</emph>: Any value, including an array, a Basic object, a UNO object, a dictionary, etc."
msgstr ""
#. aNDWv
@@ -9395,22 +9476,22 @@ msgctxt ""
msgid "This method supports the following data types: <literal>String</literal>, <literal>Boolean</literal>, numbers, <literal>Null</literal> and <literal>Empty</literal>. Arrays containing items of those types are also allowed, whatever their dimensions. Dates are converted into strings, however they cannot be used inside Arrays. Other data types are converted to their string representation using the <literal>SF_String.Represent</literal> service."
msgstr ""
-#. Nmzcs
+#. stuTQ
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id8816012968362\n"
"help.text"
-msgid "<emph>Indent</emph> : When <literal>Indent</literal> is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative <literal>Indent</literal> value will add new lines with no indentation. <literal>Indent</literal> default value \"\" selects the most compact representation. Using a positive integer for <literal>Indent</literal> indents that many spaces per level. When <literal>Indent</literal> is a string, such as <literal>Chr(9)</literal> or <literal>Tab(1)</literal>, the Tab character is used to indent each level."
+msgid "<emph>indent</emph>: When <literal>indent</literal> is a positive number or a text, JSON array elements and object members are pretty-printed with that indentation level. A negative <literal>indent</literal> value will add new lines with no indentation. The default value is an empty string \"\" which selects the most compact representation. Using a positive integer for <literal>indent</literal> indents that many spaces per level. When <literal>indent</literal> is a string, such as <literal>Chr(9)</literal> or <literal>Tab(1)</literal>, the Tab character is used to indent each level."
msgstr ""
-#. pipLz
+#. sQuKi
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id151582889470596\n"
"help.text"
-msgid "Store the content of the dictionary in an array of <literal>PropertyValues</literal>."
+msgid "Stores the contents of the dictionary into an array of <literal>PropertyValues</literal>."
msgstr ""
#. rTa2V
@@ -9449,6 +9530,15 @@ msgctxt ""
msgid "'Converts to an Array of PropertyValue objects"
msgstr ""
+#. XCGFp
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"par_id771626700938786\n"
+"help.text"
+msgid "Note in the example below that a Python dictionary needs to be passed as the second argument of the <literal>CreateScriptService</literal> method."
+msgstr ""
+
#. wTUQt
#: sf_dictionary.xhp
msgctxt ""
@@ -9467,13 +9557,13 @@ msgctxt ""
msgid "Determines if a key exists in the dictionary."
msgstr ""
-#. 9akGN
+#. RgUSD
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id971582889812917\n"
"help.text"
-msgid "<emph>Key</emph> : The key to be looked up in the dictionary."
+msgid "<emph>key</emph>: The key to be looked up in the dictionary."
msgstr ""
#. UAkEx
@@ -9521,22 +9611,22 @@ msgctxt ""
msgid "An attempt is made to convert text to date if the item matches one of these patterns: YYYY-MM-DD, HH:MM:SS or YYYY-MM-DD HH:MM:SS."
msgstr ""
-#. Ghov2
+#. 5cknM
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id69160139198061\n"
"help.text"
-msgid "<emph>InputStr</emph> : The string to import."
+msgid "<emph>inputstr</emph>: The string to import."
msgstr ""
-#. LW97u
+#. GDAGm
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id201601391980268\n"
"help.text"
-msgid "<emph>Overwrite</emph> : When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Beware that dictionary keys are not case-sensitive while names are case-sensitive in JSON strings."
+msgid "<emph>overwrite</emph>: When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Beware that dictionary keys are not case-sensitive while names are case-sensitive in JSON strings."
msgstr ""
#. aBFC5
@@ -9557,22 +9647,31 @@ msgctxt ""
msgid "Inserts the contents of an array of <literal>PropertyValue</literal> objects into the current dictionary. <literal>PropertyValue</literal> Names are used as Keys in the dictionary, whereas Values contain the corresponding values. Returns <literal>True</literal> if successful."
msgstr ""
-#. jYVUA
+#. 95A5W
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id751588941968522\n"
"help.text"
-msgid "<emph>PropertyValues</emph> : A zero-based 1 dimensional array containing <literal>com.sun.star.beans.PropertyValue</literal> objects. This parameter may also be a single <literal>PropertyValue</literal> object not contained in an Array."
+msgid "<emph>propertyvalues</emph>: A zero-based 1-dimensional array containing <literal>com.sun.star.beans.PropertyValue</literal> objects. This parameter may also be a single <literal>propertyvalue</literal> object not contained in an Array."
msgstr ""
-#. TvJoT
+#. g5bHm
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id21588941968131\n"
"help.text"
-msgid "<emph>Overwrite</emph> : When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive, whereas names are case-sensitive in sets of property values."
+msgid "<emph>overwrite</emph>: When <literal>True</literal>, entries with same name may exist in the dictionary and their values are overwritten. When <literal>False</literal> (default), repeated keys will raise an error. Note that dictionary keys are not case-sensitive in Basic, whereas names are case-sensitive in sets of property values and in Python dictionaries."
+msgstr ""
+
+#. GKtsH
+#: sf_dictionary.xhp
+msgctxt ""
+"sf_dictionary.xhp\n"
+"par_id641626703615898\n"
+"help.text"
+msgid "The examples below first create an array with two <literal>PropertyValue</literal> objects and then convert it to a dictionary."
msgstr ""
#. 3rJRP
@@ -9584,13 +9683,13 @@ msgctxt ""
msgid "Retrieves an existing dictionary entry based on its key. Returns the value of the item if successful, otherwise returns <literal>Empty</literal>."
msgstr ""
-#. UP6qF
+#. CGLFi
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id551582890399669\n"
"help.text"
-msgid "<emph>Key</emph> : Not case-sensitive. Must exist in the dictionary, otherwise a <literal>UNKNOWNKEYERROR</literal> error is raised."
+msgid "<emph>key</emph>: Not case-sensitive. Must exist in the dictionary, otherwise an <literal>UNKNOWNKEYERROR</literal> error is raised."
msgstr ""
#. rGqyT
@@ -9611,13 +9710,13 @@ msgctxt ""
msgid "Removes an existing dictionary entry based on its key. Returns <literal>True</literal> if successful."
msgstr ""
-#. eEKAA
+#. EhVL2
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id551582890366999\n"
"help.text"
-msgid "<emph>Key</emph> : Not case-sensitive. Must exist in the dictionary, otherwise an <literal>UNKNOWNKEYERROR</literal> error is raised."
+msgid "<emph>key</emph>: Not case-sensitive. Must exist in the dictionary, otherwise an <literal>UNKNOWNKEYERROR</literal> error is raised."
msgstr ""
#. GyK3j
@@ -9638,22 +9737,22 @@ msgctxt ""
msgid "Replaces an existing item value based on its key. Returns <literal>True</literal> if successful."
msgstr ""
-#. pSQCe
+#. w4w9A
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id991582895615535\n"
"help.text"
-msgid "<emph>Key</emph> : String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised."
+msgid "<emph>key</emph>: String value representing the key whose value will be replaced. Not case-sensitive. If the key does not exist in the dictionary, an <literal>UNKNOWNKEYERROR</literal> error is raised."
msgstr ""
-#. B9QCk
+#. FA4hz
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id721582895615186\n"
"help.text"
-msgid "<emph>Value</emph> : The new value of the item referred to with the Key parameter."
+msgid "<emph>value</emph>: The new value of the item referred to with the <literal>key</literal> parameter."
msgstr ""
#. Y46D4
@@ -9665,22 +9764,22 @@ msgctxt ""
msgid "Replaces an existing key in the dictionary by a new key. The item value is left unchanged. Returns <literal>True</literal> if successful."
msgstr ""
-#. SxyfK
+#. jKp7C
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id911582896597619\n"
"help.text"
-msgid "<emph>Key</emph> : String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised."
+msgid "<emph>key</emph>: String value representing the key to be replaced. Not case-sensitive. If the key does not exist in the dictionary, a <literal>UNKNOWNKEYERROR</literal> error is raised."
msgstr ""
-#. Eu4DG
+#. Dku2D
#: sf_dictionary.xhp
msgctxt ""
"sf_dictionary.xhp\n"
"par_id531582896597989\n"
"help.text"
-msgid "<emph>Value</emph> : String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, a <literal>DUPLICATEKEYERROR</literal> error is raised."
+msgid "<emph>value</emph>: String value for the new key. Not case-sensitive. If the new key already exists in the dictionary, an <literal>DUPLICATEKEYERROR</literal> error is raised."
msgstr ""
#. jasej
@@ -9836,33 +9935,6 @@ msgctxt ""
msgid "Except when the document was closed by program with the CloseDocument method (it is then superfluous), it is recommended to free resources after use:"
msgstr ""
-#. 2odf5
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"pyc_id551622819064247\n"
-"help.text"
-msgid "def RunEvent(event)"
-msgstr ""
-
-#. oHQNa
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"pyc_id311622819064554\n"
-"help.text"
-msgid "doc = CreateScriptService(\"SFDocuments.DocumentEvent\", Event)"
-msgstr ""
-
-#. sHApS
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"pyc_id221622819064967\n"
-"help.text"
-msgid "# (...)"
-msgstr ""
-
#. LyvNw
#: sf_document.xhp
msgctxt ""
@@ -10205,15 +10277,6 @@ msgctxt ""
msgid "<emph>saveask</emph> : If <literal>True</literal> (default), the user is invited to confirm if the changes should be written on disk. This argument is ignored if the document was not modified."
msgstr ""
-#. STq4L
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"bas_id751622827903730\n"
-"help.text"
-msgid "End If"
-msgstr ""
-
#. vp56r
#: sf_document.xhp
msgctxt ""
@@ -10268,42 +10331,6 @@ msgctxt ""
msgid "In the following examples, the first line gets the names of all forms in the document and the second line retrieves the <literal>Form</literal> object of the form named \"Form_A\"."
msgstr ""
-#. 8GoMk
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"bas_id191623063399519\n"
-"help.text"
-msgid "Set FormNames = oDoc.Forms()"
-msgstr ""
-
-#. uCcpo
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"bas_id691623063399711\n"
-"help.text"
-msgid "Set FormA = oDoc.Forms(\"Form_A\")"
-msgstr ""
-
-#. 9gHMA
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"pyc_id271623063215023\n"
-"help.text"
-msgid "form_names = doc.Forms()"
-msgstr ""
-
-#. H3946
-#: sf_document.xhp
-msgctxt ""
-"sf_document.xhp\n"
-"pyc_id961623063234990\n"
-"help.text"
-msgid "form_A = doc.Forms(\"Form_A\")"
-msgstr ""
-
#. Nmwv9
#: sf_document.xhp
msgctxt ""
@@ -11015,6 +11042,42 @@ msgctxt ""
msgid "<emph>arg0[, arg1, ...]</emph>: Any number of arguments of any type."
msgstr ""
+#. ZxYFC
+#: sf_exception.xhp
+msgctxt ""
+"sf_exception.xhp\n"
+"par_id111621624672183\n"
+"help.text"
+msgid "Displays the list of arguments in a readable form in the Python shell (APSO) console. Arguments are separated by a TAB character (simulated by spaces)."
+msgstr ""
+
+#. ujSFu
+#: sf_exception.xhp
+msgctxt ""
+"sf_exception.xhp\n"
+"par_id841621426229467\n"
+"help.text"
+msgid "The same string is added to the ScriptForge debug console."
+msgstr ""
+
+#. ixNfF
+#: sf_exception.xhp
+msgctxt ""
+"sf_exception.xhp\n"
+"par_id391126449167833\n"
+"help.text"
+msgid "<emph>arg0[, arg1, ...]</emph>: Any number of arguments of any type. The maximum length of each individual argument is 1024 characters."
+msgstr ""
+
+#. f5WaM
+#: sf_exception.xhp
+msgctxt ""
+"sf_exception.xhp\n"
+"par_id261123015276160\n"
+"help.text"
+msgid "In python use simply the builtin print() statement."
+msgstr ""
+
#. CUoch
#: sf_exception.xhp
msgctxt ""
@@ -11411,22 +11474,22 @@ msgctxt ""
msgid "An example of the URL notation is <emph>file:///C:/Documents/my_file.odt</emph>. Whenever possible consider using the URL notation because it is a more portable alternative."
msgstr ""
-#. mao7x
+#. QrDqQ
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"hd_id581582885621841\n"
+"par_id931626652451855\n"
"help.text"
-msgid "Service invocation"
+msgid "The use of the shortcut \"~\" (tilde), which is common in Linux-based operating systems, is not supported to express a path to a folder and file name. Instead of using <emph>\"~/Documents/my_file.odt\"</emph> use the full path <emph>\"/home/user/Documents/my_file.odt\"</emph>."
msgstr ""
-#. ms88h
+#. mao7x
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"par_id141610734722352\n"
+"hd_id581582885621841\n"
"help.text"
-msgid "Before using the <literal>FileSystem</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
+msgid "Service invocation"
msgstr ""
#. Miw3e
@@ -11681,22 +11744,22 @@ msgctxt ""
msgid "Joins a folder path and the name of a file and returns the full file name with a valid path separator. The path separator is added only if necessary."
msgstr ""
-#. EDmLL
+#. 2pwBF
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id90158393307695\n"
"help.text"
-msgid "<emph>FolderName</emph>: The path with which <literal>Name</literal> will be combined. The specified path does not need to be an existing folder."
+msgid "<emph>foldername</emph>: The path with which <literal>name</literal> will be combined. The specified path does not need to be an existing folder."
msgstr ""
-#. TqBVA
+#. xFCWJ
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id891583933076975\n"
"help.text"
-msgid "<emph>Name</emph>: The name of the file to be appended to <literal>FolderName</literal>. This parameter uses the notation of the current operating system."
+msgid "<emph>name</emph>: The name of the file to be appended to <literal>foldername</literal>. This parameter uses the notation of the current operating system."
msgstr ""
#. DwTpc
@@ -11708,31 +11771,31 @@ msgctxt ""
msgid "Compares two files and returns <literal>True</literal> when they seem identical."
msgstr ""
-#. CrUQx
+#. 6A5Da
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id631601119001315\n"
"help.text"
-msgid "Depending on the value of the <literal>CompareContents</literal> argument, the comparison between both files can be either based only on file attributes (such as the last modified date), or based on the file contents."
+msgid "Depending on the value of the <literal>comparecontents</literal> argument, the comparison between both files can be either based only on file attributes (such as the last modified date), or based on the file contents."
msgstr ""
-#. kYy2f
+#. MGA4A
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id481601118910755\n"
"help.text"
-msgid "<emph>FileName1, FileName2</emph>: The files to compare."
+msgid "<emph>filename1, filename2</emph>: The files to compare."
msgstr ""
-#. mXZPN
+#. aKfwh
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id111601118910848\n"
"help.text"
-msgid "<emph>CompareContents</emph>: When <literal>True</literal>, the contents of the files are compared (default = <literal>False</literal>)."
+msgid "<emph>comparecontents</emph>: When <literal>True</literal>, the contents of the files are compared (default = <literal>False</literal>)."
msgstr ""
#. EZNG5
@@ -11744,13 +11807,13 @@ msgctxt ""
msgid "Copies one or more files from one location to another. Returns <literal>True</literal> if at least one file has been copied or <literal>False</literal> if an error occurred."
msgstr ""
-#. EFfEH
+#. xE9SU
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id401612998805699\n"
"help.text"
-msgid "An error will also occur if the <literal>Source</literal> parameter uses wildcard characters and does not match any files."
+msgid "An error will also occur if the <literal>source</literal> parameter uses wildcard characters and does not match any files."
msgstr ""
#. AZCsn
@@ -11762,67 +11825,67 @@ msgctxt ""
msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred."
msgstr ""
-#. cxNda
+#. aVGzZ
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id1001584541257789\n"
"help.text"
-msgid "<emph>Source</emph>: It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be copied."
+msgid "<emph>source</emph>: It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be copied."
msgstr ""
-#. pwEq9
+#. ycEpt
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id111584542310166\n"
"help.text"
-msgid "<emph>Destination</emph>: It can be either a <literal>FileName</literal> specifying where the single <literal>Source</literal> file is to be copied, or a <literal>FolderName</literal> into which the multiple files from <literal>Source</literal> are to be copied."
+msgid "<emph>destination</emph>: It can be either a <literal>FileName</literal> specifying where the single <literal>source</literal> file is to be copied, or a <literal>FolderName</literal> into which the multiple files from <literal>source</literal> are to be copied."
msgstr ""
-#. FCpqn
+#. frwD2
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id491612999134752\n"
"help.text"
-msgid "If <literal>FolderName</literal> does not exist, it is created."
+msgid "If <literal>destination</literal> does not exist, it is created."
msgstr ""
-#. 4ArCt
+#. z3Tok
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id591612999166788\n"
"help.text"
-msgid "Wildcard characters are not allowed in <literal>Destination</literal>."
+msgid "Wildcard characters are not allowed in <literal>destination</literal>."
msgstr ""
-#. 48FYf
+#. zFyVX
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id251584542431558\n"
"help.text"
-msgid "<emph>Overwrite</emph>: If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>Destination</literal> is readonly, regardless of the value specified in <literal>Overwrite</literal>."
+msgid "<emph>overwrite</emph>: If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>destination</literal> is readonly, regardless of the value specified in <literal>overwrite</literal>."
msgstr ""
-#. KerV3
+#. uRMe8
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id211613000903194\n"
+"par_id691626216252568\n"
"help.text"
-msgid "' Copies a single file"
+msgid "In the examples below the first line copies a single file whereas the second line copies multiple files using wildcards."
msgstr ""
-#. HKFaH
+#. GevfF
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id841584541257574\n"
+"par_id411626216328023\n"
"help.text"
-msgid "' Copies multiple files. Only files are copied, subfolders are not."
+msgid "Beware that subfolders and their contents are not copied when wildcards are used in the <emph>source</emph> argument."
msgstr ""
#. TdGi7
@@ -11834,13 +11897,13 @@ msgctxt ""
msgid "Copies one or more folders from one location to another. Returns <literal>True</literal> if at least one folder has been copied or <literal>False</literal> if an error occurred."
msgstr ""
-#. TymFf
+#. TSLCU
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id21612999775377\n"
"help.text"
-msgid "An error will also occur if the <literal>Source</literal> parameter uses wildcard characters and does not match any folders."
+msgid "An error will also occur if the <literal>source</literal> parameter uses wildcard characters and does not match any folders."
msgstr ""
#. m3Hzh
@@ -11852,58 +11915,58 @@ msgctxt ""
msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred."
msgstr ""
-#. isESD
+#. GCCf3
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id851584544734202\n"
"help.text"
-msgid "<emph>Source</emph>: It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be copied."
+msgid "<emph>source</emph>: It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be copied."
msgstr ""
-#. 5fFnt
+#. msqGq
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id321584544734273\n"
"help.text"
-msgid "<emph>Destination</emph>: Specifies the <literal>FolderName</literal> into which the single or multiple folders defined in <literal>Source</literal> are to be copied."
+msgid "<emph>destination</emph>: Specifies the <literal>FolderName</literal> into which the single or multiple folders defined in <literal>source</literal> are to be copied."
msgstr ""
-#. CzQ9A
+#. iLKYc
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id491612999134762\n"
"help.text"
-msgid "If <literal>FolderName</literal> does not exist, it is created."
+msgid "If <literal>destination</literal> does not exist, it is created."
msgstr ""
-#. Uqyna
+#. TvYDS
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id591612999166740\n"
"help.text"
-msgid "Wildcard characters are not allowed in <literal>Destination</literal>."
+msgid "Wildcard characters are not allowed in <literal>destination</literal>."
msgstr ""
-#. 2ziFA
+#. 3A2C2
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id251584542431525\n"
"help.text"
-msgid "<emph>Overwrite</emph>: If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>Destination</literal> is readonly, regardless of the value specified in <literal>Overwrite</literal>."
+msgid "<emph>overwrite</emph>: If <literal>True</literal> (default), files may be overwritten. The method will fail if <literal>destination</literal> is readonly, regardless of the value specified in <literal>overwrite</literal>."
msgstr ""
-#. niaPD
+#. 7CxBB
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id541584544734497\n"
+"par_id751626216627481\n"
"help.text"
-msgid "' Folders, their files and their subfolders are copied"
+msgid "In the examples below all files, folders and subfolders are copied."
msgstr ""
#. fNBgH
@@ -11924,22 +11987,22 @@ msgctxt ""
msgid "If the specified folder has a parent folder that does not exist, it is created."
msgstr ""
-#. G2A8N
+#. 7gTts
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id491584540675469\n"
"help.text"
-msgid "<emph>FolderName</emph>: A string representing the folder to be created. If the folder already exists, an exception will be raised."
+msgid "<emph>foldername</emph>: A string representing the folder to be created. If the folder already exists, an exception will be raised."
msgstr ""
-#. EYSCS
+#. 2zcfH
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id731585322689518\n"
"help.text"
-msgid "Creates a specified file and returns a <literal>TextStream</literal> object that can be used to write to the file."
+msgid "Creates a specified file and returns a <literal>TextStream</literal> service instance that can be used to write to the file."
msgstr ""
#. YMZDA
@@ -11951,31 +12014,31 @@ msgctxt ""
msgid "The method returns a <literal>Null</literal> object if an error occurred."
msgstr ""
-#. hBQSN
+#. 2NPVD
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id901585322689715\n"
"help.text"
-msgid "<emph>FileName</emph>: The name of the file to be created."
+msgid "<emph>filename</emph>: The name of the file to be created."
msgstr ""
-#. VkGyb
+#. gEJA4
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id501585322689209\n"
"help.text"
-msgid "<emph>Overwrite</emph>: Boolean value that determines if <literal>FileName</literal> can be overwritten (default = <literal>True</literal>)."
+msgid "<emph>overwrite</emph>: Boolean value that determines if <literal>filename</literal> can be overwritten (default = <literal>True</literal>)."
msgstr ""
-#. Zp6H3
+#. CkbhC
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id551585322689192\n"
"help.text"
-msgid "<emph>Encoding</emph>: The character set to be used. The default encoding is \"UTF-8\"."
+msgid "<emph>encoding</emph>: The character set to be used. The default encoding is \"UTF-8\"."
msgstr ""
#. eoE92
@@ -11996,13 +12059,13 @@ msgctxt ""
msgid "Deletes one or more files. Returns <literal>True</literal> if at least one file has been deleted or <literal>False</literal> if an error occurred."
msgstr ""
-#. DQEzT
+#. y69YZ
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id21612999775356\n"
"help.text"
-msgid "An error will also occur if the <literal>FileName</literal> parameter uses wildcard characters and does not match any files."
+msgid "An error will also occur if the <literal>filename</literal> parameter uses wildcard characters and does not match any files."
msgstr ""
#. TWJRd
@@ -12023,22 +12086,22 @@ msgctxt ""
msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred."
msgstr ""
-#. 2k57M
+#. DkCdk
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id441584882040860\n"
"help.text"
-msgid "<emph>FileName</emph>: It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be deleted."
+msgid "<emph>filename</emph>: It can be a <literal>FileName</literal> or a <literal>NamePattern</literal> indicating one or more files to be deleted."
msgstr ""
-#. YtAfH
+#. FnaSi
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id181584882040535\n"
+"par_id851626217167909\n"
"help.text"
-msgid "' Only files are deleted, subfolders are not"
+msgid "In the examples below only files are deleted, subfolders are not deleted."
msgstr ""
#. c9ZCd
@@ -12050,13 +12113,13 @@ msgctxt ""
msgid "Deletes one or more folders. Returns <literal>True</literal> if at least one folder has been deleted or <literal>False</literal> if an error occurred."
msgstr ""
-#. xmtzX
+#. bGmGo
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id21612999775346\n"
"help.text"
-msgid "An error will also occur if the <literal>FolderName</literal> parameter uses wildcard characters and does not match any folders."
+msgid "An error will also occur if the <literal>foldername</literal> parameter uses wildcard characters and does not match any folders."
msgstr ""
#. GsqDD
@@ -12077,22 +12140,22 @@ msgctxt ""
msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred."
msgstr ""
-#. ecg9D
+#. 7YCXM
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id451584882542247\n"
"help.text"
-msgid "<emph>FolderName</emph>: It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be deleted."
+msgid "<emph>foldername</emph>: It can be a <literal>FolderName</literal> or a <literal>NamePattern</literal> indicating one or more folders to be deleted."
msgstr ""
-#. ECKGi
+#. cCnG9
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id491584882542177\n"
+"par_id651626217314709\n"
"help.text"
-msgid "' Only folders are deleted, files in the top folder (C:\\Temp\\) are not"
+msgid "In the examples below only folders and their contents are deleted. Files in the parent folder \"C:\\Temp\" are not deleted."
msgstr ""
#. ZbyLn
@@ -12104,22 +12167,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if a given file name is valid and exists, otherwise the method returns <literal>False</literal>."
msgstr ""
-#. BNEmC
+#. 7j5TN
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id91613003122613\n"
"help.text"
-msgid "If the <literal>FileName</literal> parameter is actually an existing folder name, the method returns <literal>False</literal>."
+msgid "If the <literal>filename</literal> parameter is actually an existing folder name, the method returns <literal>False</literal>."
msgstr ""
-#. 7pDFB
+#. fr2Ei
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id361583764426547\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing the file to be tested."
+msgid "<emph>filename</emph>: A string representing the file to be tested."
msgstr ""
#. ChDCL
@@ -12131,13 +12194,13 @@ msgctxt ""
msgid "Returns a zero-based array of the files stored in a given folder. Each entry in the array is a string containing the full path and file name."
msgstr ""
-#. HT5PM
+#. JVjE3
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id641613003790120\n"
"help.text"
-msgid "If <literal>FolderName</literal> does not exist, an exception is raised."
+msgid "If the argument <literal>foldername</literal> specifies a folder that does not exist, an exception is raised."
msgstr ""
#. nFaPD
@@ -12149,22 +12212,22 @@ msgctxt ""
msgid "The resulting list may be filtered with wildcards."
msgstr ""
-#. YsYdQ
+#. bq6vD
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id731583944543140\n"
"help.text"
-msgid "<emph>FolderName</emph>: A string representing a folder. The folder must exist. <literal>FolderName</literal> must not designate a file."
+msgid "<emph>foldername</emph>: A string representing a folder. The folder must exist. This argument must not designate a file."
msgstr ""
-#. V95Bm
+#. EM5cJ
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id591585648450060\n"
"help.text"
-msgid "<emph>Filter</emph>: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")."
+msgid "<emph>filter</emph>: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of files (default = \"\")."
msgstr ""
#. zG7ec
@@ -12176,22 +12239,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the specified <literal>FolderName</literal> is valid and exists, otherwise the method returns <literal>False</literal>."
msgstr ""
-#. G4Rcz
+#. 9xtCG
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id151613004111990\n"
"help.text"
-msgid "If the <literal>FolderName</literal> parameter is actually an existing file name, the method returns <literal>False</literal>."
+msgid "If the <literal>foldername</literal> parameter is actually an existing file name, the method returns <literal>False</literal>."
msgstr ""
-#. Z46FB
+#. qrf4A
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id1001583765642211\n"
"help.text"
-msgid "<emph>FolderName</emph>: A string representing the folder to be tested."
+msgid "<emph>foldername</emph>: A string representing the folder to be tested."
msgstr ""
#. eAFVs
@@ -12212,31 +12275,22 @@ msgctxt ""
msgid "The method does not check if the specified file or folder exists."
msgstr ""
-#. B3jVo
+#. 3FPjB
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id691584110618308\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing the file name and its path."
+msgid "<emph>filename</emph>: A string representing the file name and its path."
msgstr ""
-#. VcGyZ
+#. jwFaP
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id861584110618986\n"
+"par_id1001626271201609\n"
"help.text"
-msgid "' If the input parameter is a folder, it returns the last component of the path"
-msgstr ""
-
-#. xmK9A
-#: sf_filesystem.xhp
-msgctxt ""
-"sf_filesystem.xhp\n"
-"bas_id591613004793431\n"
-"help.text"
-msgid "' If the input parameter is a file, the method returns the file name without the extension and the path"
+msgid "In the examples below, the first <literal>GetBaseName</literal> method call corresponds to a folder, so the function returns the last component of the path. The second call receives a file name as input, so the name of the file is returned without its extension."
msgstr ""
#. A56XC
@@ -12266,13 +12320,13 @@ msgctxt ""
msgid "If this method is applied to a folder name or to a file without an extension, then an empty string is returned."
msgstr ""
-#. GDoGW
+#. NzK5z
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id821584032680311\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing the file name and its path."
+msgid "<emph>filename</emph>: A string representing the file name and its path."
msgstr ""
#. Am6Bu
@@ -12293,13 +12347,13 @@ msgctxt ""
msgid "The <literal>GetFileLen</literal> method can handle files with much larger sizes by returning a <literal>Currency</literal> value."
msgstr ""
-#. FvwV6
+#. PK2Fo
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id161600685050367\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing an existing file."
+msgid "<emph>filename</emph>: A string representing an existing file."
msgstr ""
#. o2GGJ
@@ -12311,13 +12365,13 @@ msgctxt ""
msgid "Returns the last modified date of a given file."
msgstr ""
-#. dxpgz
+#. VMB4i
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id25158481147822\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing an existing file."
+msgid "<emph>filename</emph>: A string representing an existing file."
msgstr ""
#. VEZR6
@@ -12338,13 +12392,13 @@ msgctxt ""
msgid "The method does not check if the specified file or folder exists."
msgstr ""
-#. VWPoq
+#. iajZD
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id671584032366193\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing the file name and its path."
+msgid "<emph>filename</emph>: A string representing the file name and its path."
msgstr ""
#. ffxFe
@@ -12365,13 +12419,13 @@ msgctxt ""
msgid "The method does not check if the specified file or folder exists."
msgstr ""
-#. XDmYQ
+#. YUAQ3
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id471584113432231\n"
"help.text"
-msgid "<emph>FileName</emph>: A string with the file or folder name to be analyzed."
+msgid "<emph>filename</emph>: A string with the file or folder name to be analyzed."
msgstr ""
#. Uc93M
@@ -12428,22 +12482,22 @@ msgctxt ""
msgid "The hash algorithms supported are: <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA224</literal>, <literal>SHA256</literal>, <literal>SHA384</literal> and <literal>SHA512</literal>."
msgstr ""
-#. jTMPS
+#. s5ZiA
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id28160104251451\n"
"help.text"
-msgid "<emph>FileName</emph>: A string representing an existing file."
+msgid "<emph>filename</emph>: A string representing an existing file."
msgstr ""
-#. F86KG
+#. Eomhm
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id71601042959846\n"
"help.text"
-msgid "<emph>Algorithm</emph>: One of the supported algorithms."
+msgid "<emph>algorithm</emph>: One of the supported algorithms."
msgstr ""
#. HzFs2
@@ -12455,13 +12509,13 @@ msgctxt ""
msgid "Moves one or more files from one location to another. Returns <literal>True</literal> if at least one file has been moved or <literal>False</literal> if an error occurred."
msgstr ""
-#. oEPar
+#. RFrNE
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id631613062890648\n"
"help.text"
-msgid "An error will also occur if the <literal>Source</literal> parameter uses wildcard characters and does not match any files."
+msgid "An error will also occur if the <literal>source</literal> parameter uses wildcard characters and does not match any files."
msgstr ""
#. ETmEP
@@ -12473,58 +12527,58 @@ msgctxt ""
msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred."
msgstr ""
-#. LAeis
+#. DbC6F
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id721584791330406\n"
"help.text"
-msgid "<emph>Source</emph>: It can be a <literal>FileName</literal> or <literal>NamePattern</literal> to designate one or more files to be moved."
+msgid "<emph>source</emph>: It can be a <literal>FileName</literal> or <literal>NamePattern</literal> to designate one or more files to be moved."
msgstr ""
-#. rgNqi
+#. BHa7Y
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id291584791330181\n"
"help.text"
-msgid "<emph>Destination</emph>: If <literal>Source</literal> is a <literal>FileName</literal> then this parameter indicates the new path and file name of the moved file."
+msgid "<emph>destination</emph>: If <literal>source</literal> is a <literal>FileName</literal> then this parameter indicates the new path and file name of the moved file."
msgstr ""
-#. E4opD
+#. ZzA3Y
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id31613063334246\n"
"help.text"
-msgid "If the move operation involves multiple files, then <literal>Destination</literal> must be a folder name. If it does not exist, it is created."
+msgid "If the move operation involves multiple files, then <literal>destination</literal> must be a folder name. If it does not exist, it is created."
msgstr ""
-#. BvhBP
+#. 39oR8
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id391613063494599\n"
"help.text"
-msgid "If <literal>Source</literal> and <literal>Destination</literal> have the same parent folder, the method will rename the <literal>Source</literal>."
+msgid "If <literal>source</literal> and <literal>destination</literal> have the same parent folder, the method will rename the <literal>source</literal>."
msgstr ""
-#. 6UKxC
+#. 7bzK4
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id941613063476533\n"
"help.text"
-msgid "Wildcard characters are not allowed in <literal>Destination</literal>."
+msgid "Wildcard characters are not allowed in <literal>destination</literal>."
msgstr ""
-#. qPvQA
+#. Bysqd
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id331584791330495\n"
+"par_id91626272612758\n"
"help.text"
-msgid "' Only files are moved, subfolders are not"
+msgid "In the following examples only files are moved, subfolders are not."
msgstr ""
#. iYBMe
@@ -12536,13 +12590,13 @@ msgctxt ""
msgid "Moves one or more folders from one location to another. Returns <literal>True</literal> if at least one folder has been moved or <literal>False</literal> if an error occurred."
msgstr ""
-#. R9Jrz
+#. RHjYG
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id411613072570664\n"
"help.text"
-msgid "An error will also occur if the <literal>Source</literal> parameter uses wildcard characters and does not match any folders."
+msgid "An error will also occur if the <literal>source</literal> parameter uses wildcard characters and does not match any folders."
msgstr ""
#. F2DaD
@@ -12554,40 +12608,40 @@ msgctxt ""
msgid "The method stops immediately after it encounters an error. The method does not roll back nor does it undo changes made before the error occurred."
msgstr ""
-#. tLxAt
+#. xVGBy
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id541584791330777\n"
"help.text"
-msgid "<emph>Source</emph>: It can be a <literal>FolderName</literal> or <literal>NamePattern</literal> to designate one or more folders to be moved."
+msgid "<emph>source</emph>: It can be a <literal>FolderName</literal> or <literal>NamePattern</literal> to designate one or more folders to be moved."
msgstr ""
-#. bTWWF
+#. 4Ampu
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id551584791330279\n"
"help.text"
-msgid "<emph>Destination</emph>: If the move operation involves a single folder, then <literal>Destination</literal> is the name and path of the moved folder and it must not exist."
+msgid "<emph>destination</emph>: If the move operation involves a single folder, then <literal>destination</literal> is the name and path of the moved folder and it must not exist."
msgstr ""
-#. rNbq3
+#. dD7SB
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id11613072890641\n"
"help.text"
-msgid "If multiple folders are being moved, then <literal>Destination</literal> designates where the folders in <literal>Source</literal> will be moved into. If <literal>Destination</literal> does not exist, it is created."
+msgid "If multiple folders are being moved, then <literal>destination</literal> designates where the folders in <literal>source</literal> will be moved into. If <literal>destination</literal> does not exist, it is created."
msgstr ""
-#. DFBsa
+#. A69QS
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id301613072928159\n"
"help.text"
-msgid "Wildcard characters are not allowed in <literal>Destination</literal>."
+msgid "Wildcard characters are not allowed in <literal>destination</literal>."
msgstr ""
#. JNTia
@@ -12608,40 +12662,40 @@ msgctxt ""
msgid "Note that the method does not check if the given file is really a text file."
msgstr ""
-#. p6VFZ
+#. SGJCd
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id951613073135036\n"
"help.text"
-msgid "The method returns a <literal>Null</literal> object if an error occurred."
+msgid "The method returns a <literal>Null</literal> object (in Basic) or <literal>None</literal> (in Python) if an error occurred."
msgstr ""
-#. R5a4m
+#. mxuwo
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id551585320922678\n"
"help.text"
-msgid "<emph>FileName</emph>: Identifies the file to open."
+msgid "<emph>filename</emph>: Identifies the file to open."
msgstr ""
-#. FUxVH
+#. tsRLR
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id671585320922388\n"
"help.text"
-msgid "<emph>IOMode</emph>: Indicates the input/output mode. It can be one of three constants: <literal>FSO.ForReading</literal> (default), <literal>FSO.ForWriting</literal>, or <literal>FSO.ForAppending</literal>."
+msgid "<emph>iomode</emph>: Indicates the input/output mode. It can be one of three constants: <literal>svc.ForReading</literal> (default), <literal>svc.ForWriting</literal>, or <literal>svc.ForAppending</literal>."
msgstr ""
-#. ttSYS
+#. z27vT
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id21585321398586\n"
"help.text"
-msgid "<emph>Create</emph>: Boolean value that indicates whether a new file can be created if the specified filename doesn't exist:"
+msgid "<emph>create</emph>: Boolean value that indicates whether a new file can be created if the specified <literal>filename</literal> doesn't exist:"
msgstr ""
#. VDFAi
@@ -12662,13 +12716,13 @@ msgctxt ""
msgid "If <literal>False</literal> then new files are not created (default)."
msgstr ""
-#. BoVQQ
+#. wjGYH
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id771585321576210\n"
"help.text"
-msgid "<emph>Encoding</emph>: The character set to be used. The default encoding is \"UTF-8\"."
+msgid "<emph>encoding</emph>: The character set to be used. The default encoding is \"UTF-8\"."
msgstr ""
#. FuYwe
@@ -12689,13 +12743,13 @@ msgctxt ""
msgid "If the <literal>SAVE</literal> mode is set and the picked file exists, a warning message will be displayed."
msgstr ""
-#. PAaAH
+#. YgsLZ
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id481583670342502\n"
"help.text"
-msgid "<emph>DefaultFile</emph>: This argument is a string composed of a folder and file name:"
+msgid "<emph>defaultfile</emph>: This argument is a string composed of a folder and file name:"
msgstr ""
#. fyVCs
@@ -12716,31 +12770,31 @@ msgctxt ""
msgid "The file part designates the default file to open or save."
msgstr ""
-#. rcast
+#. fBHyg
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id981583670342502\n"
"help.text"
-msgid "<emph>Mode</emph>: <literal>OPEN</literal> (input file) or <literal>SAVE</literal> (output file). The default value is <literal>OPEN</literal>."
+msgid "<emph>mode</emph>: A string value that can be either \"OPEN\" (for input files) or \"SAVE\" (for output files). The default value is \"OPEN\"."
msgstr ""
-#. Dtmio
+#. uvwDP
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id31583670342502\n"
"help.text"
-msgid "<emph>Filter</emph>: The extension of the files displayed when the dialog is opened (default = no filter)."
+msgid "<emph>filter</emph>: The extension of the files displayed when the dialog is opened (default = no filter)."
msgstr ""
-#. 8WirR
+#. niaGR
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"bas_id941583670925672\n"
+"par_id881626276134300\n"
"help.text"
-msgid "' Only *.txt files are displayed"
+msgid "The examples below open a file picker with the \"txt\" filter applied."
msgstr ""
#. HkwaR
@@ -12752,85 +12806,76 @@ msgctxt ""
msgid "Opens a dialog box to select a folder."
msgstr ""
-#. coL3A
+#. mG6QD
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id951583671701872\n"
"help.text"
-msgid "<emph>DefaultFolder</emph>: A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)."
+msgid "<emph>defaultfolder</emph>: A string containing the folder name that will be displayed when the dialog is opened (default = the last selected folder)."
msgstr ""
-#. esSGJ
+#. ymABK
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"par_id821583671701764\n"
"help.text"
-msgid "<emph>FreeText</emph>: Text to display in the dialog (default = \"\")."
+msgid "<emph>freetext</emph>: Text to display in the dialog (default = \"\")."
msgstr ""
-#. GMYtx
+#. 4FFby
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
"bas_id921583671701610\n"
"help.text"
-msgid "a = FSO.PickFolder(\"C:\\\", \"Choose a folder or press Cancel\")"
-msgstr ""
-
-#. C3UA9
-#: sf_filesystem.xhp
-msgctxt ""
-"sf_filesystem.xhp\n"
-"par_id431584016761996\n"
-"help.text"
-msgid "Returns a zero-based array of the folders stored in a given <literal>FolderName</literal>."
+msgid "aFolder = FSO.PickFolder(\"C:\\Documents\", \"Choose a folder or press Cancel\")"
msgstr ""
-#. LVNZq
+#. ENDba
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"par_id431613075267241\n"
+"pyc_id631626276402296\n"
"help.text"
-msgid "The list may be filtered with wildcards."
+msgid "aFolder = fso.PickFolder(r\"C:\\Documents\", \"Choose a folder or press Cancel\")"
msgstr ""
-#. ApGN7
+#. xdfBh
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"par_id701584016761945\n"
+"par_id431584016761996\n"
"help.text"
-msgid "<emph>FolderName</emph>: A string representing a folder. The folder must exist. <literal>FolderName</literal> must not designate a file."
+msgid "Returns a zero-based array of strings corresponding to the folders stored in a given <literal>foldername</literal>."
msgstr ""
-#. zHooS
+#. LVNZq
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"par_id471585648674921\n"
+"par_id431613075267241\n"
"help.text"
-msgid "<emph>Filter</emph>: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")."
+msgid "The list may be filtered with wildcards."
msgstr ""
-#. WVhEh
+#. 7pDiA
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"par_id301613075694148\n"
+"par_id701584016761945\n"
"help.text"
-msgid "<link href=\"text/sbasic/shared/03160000.xhp\" name=\"Input function\">Input Function</link>"
+msgid "<emph>foldername</emph>: A string representing a folder. The folder must exist. <literal>foldername</literal> must not designate a file."
msgstr ""
-#. QhSzj
+#. Xmg8b
#: sf_filesystem.xhp
msgctxt ""
"sf_filesystem.xhp\n"
-"par_id271612398715438\n"
+"par_id471585648674921\n"
"help.text"
-msgid "<link href=\"text/sbasic/shared/03020103.xhp\" name=\"Open statement\">Open Statement</link>"
+msgid "<emph>filter</emph>: A string containing wildcards (\"?\" and \"*\") that will be applied to the resulting list of folders (default = \"\")."
msgstr ""
#. XQG8t
@@ -16424,22 +16469,22 @@ msgctxt ""
msgid "To invoke the <literal>L10N</literal> service, two optional arguments can be specified to determine the folder where PO files are located and the locale to be used, as described below."
msgstr ""
-#. u3ENa
+#. cCwBS
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id331585843652877\n"
"help.text"
-msgid "<emph>FolderName</emph>: The folder containing the PO files. It must be expressed in the <literal>FileSystem.FileNaming</literal> notation."
+msgid "<emph>foldername</emph>: The folder containing the PO files. It must be expressed in the <literal>FileSystem.FileNaming</literal> notation."
msgstr ""
-#. 8PpqQ
+#. oQD4m
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id581585843652789\n"
"help.text"
-msgid "<emph>Locale</emph>: A string in the form \"la-CO\" (language-COUNTRY) or in the form \"la\" (language) only."
+msgid "<emph>locale</emph>: A string in the form \"la-CO\" (language-COUNTRY) or in the form \"la\" (language) only."
msgstr ""
#. Z5Pb3
@@ -16469,6 +16514,15 @@ msgctxt ""
msgid "The example below specifies the folder containing the PO files. Because the locale is not defined, the service instance will use the current %PRODUCTNAME locale settings."
msgstr ""
+#. F998n
+#: sf_l10n.xhp
+msgctxt ""
+"sf_l10n.xhp\n"
+"par_id391625855630975\n"
+"help.text"
+msgid "The example above will result in an runtime error if the PO file for the current locale does not exist in the specified folder."
+msgstr ""
+
#. Ab7iH
#: sf_l10n.xhp
msgctxt ""
@@ -16478,13 +16532,13 @@ msgctxt ""
msgid "In the example below, both the folder name and locale settings are explicitly defined to be Belgian French."
msgstr ""
-#. zEgWG
+#. YhDVT
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"bas_id661614358846464\n"
"help.text"
-msgid "Set myPO = CreateScriptService(\"L10N\", \"C:\\myPOFiles\\\", \"fr-BE\")"
+msgid "Set myPO = CreateScriptService(\"L10N\", \"C:\\myPOFiles\", \"fr-BE\")"
msgstr ""
#. UGFWB
@@ -16505,6 +16559,15 @@ msgctxt ""
msgid "It is recommended to free resources after use:"
msgstr ""
+#. CmhnJ
+#: sf_l10n.xhp
+msgctxt ""
+"sf_l10n.xhp\n"
+"par_id281625854773330\n"
+"help.text"
+msgid "The examples above can be translated to Python as follows:"
+msgstr ""
+
#. 6mcLb
#: sf_l10n.xhp
msgctxt ""
@@ -16622,40 +16685,49 @@ msgctxt ""
msgid "Adds a new entry in the list of localizable strings. It must not exist yet."
msgstr ""
-#. WPVrn
+#. 5Fs5v
+#: sf_l10n.xhp
+msgctxt ""
+"sf_l10n.xhp\n"
+"par_id641625855725050\n"
+"help.text"
+msgid "The method returns <literal>True</literal> if successful."
+msgstr ""
+
+#. gyUYQ
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id391585843652753\n"
"help.text"
-msgid "<emph>Context</emph>: The key to retrieve the translated string with the <literal>GetText</literal> method. This parameter has a default value of \"\"."
+msgid "<emph>context</emph>: The key to retrieve the translated string with the <literal>GetText</literal> method. This parameter has a default value of \"\"."
msgstr ""
-#. EC7wb
+#. YVUWx
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id581585844419114\n"
"help.text"
-msgid "<emph>MsgId</emph>: The untranslated string, which is the text appearing in the program code. It must not be empty. The <literal>MsgId</literal> becomes the key to retrieve the translated string via <literal>GetText</literal> method when <literal>Context</literal> is empty."
+msgid "<emph>msgid</emph>: The untranslated string, which is the text appearing in the program code. It must not be empty. The <literal>msgid</literal> becomes the key to retrieve the translated string via <literal>GetText</literal> method when <literal>context</literal> is empty."
msgstr ""
-#. X3F7E
+#. 7FDE9
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id311614361926844\n"
"help.text"
-msgid "The <literal>MsgId</literal> string may contain any number of placeholders (%1 %2 %3 ...) for dynamically modifying the string at runtime."
+msgid "The <literal>msgid</literal> string may contain any number of placeholders (%1 %2 %3 ...) for dynamically modifying the string at runtime."
msgstr ""
-#. 9Jgn8
+#. ioGmP
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id541585844475331\n"
"help.text"
-msgid "<emph>Comment</emph>: Optional comment to be added alongside the string to help translators."
+msgid "<emph>comment</emph>: Optional comment to be added alongside the string to help translators."
msgstr ""
#. TAyPG
@@ -16676,49 +16748,58 @@ msgctxt ""
msgid "Exports a set of untranslated strings as a POT file."
msgstr ""
-#. zTKQ4
+#. NABBq
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id711586102939257\n"
"help.text"
-msgid "To build a set of strings you can use either a succession of <literal>AddText</literal> method calls, or by a successful invocation of the <literal>L10N</literal> service with the <literal>FolderName</literal> argument present. It is also possible to use a combination of both techniques."
+msgid "To build a set of strings you can use either a succession of <literal>AddText</literal> method calls, or by a successful invocation of the <literal>L10N</literal> service with the <literal>foldername</literal> argument present. It is also possible to use a combination of both techniques."
+msgstr ""
+
+#. Pb4VF
+#: sf_l10n.xhp
+msgctxt ""
+"sf_l10n.xhp\n"
+"par_id641625855725141\n"
+"help.text"
+msgid "The method returns <literal>True</literal> if successful."
msgstr ""
-#. WiqHy
+#. BsmCX
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id31586102707537\n"
"help.text"
-msgid "<emph>FileName</emph>: The output file in <literal>FileSystem.FileNaming</literal> notation."
+msgid "<emph>filename</emph>: The output file in <literal>FileSystem.FileNaming</literal> notation."
msgstr ""
-#. BkEjG
+#. jQV77
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id851586102707579\n"
"help.text"
-msgid "<emph>Header</emph>: Comments that will be added on top of the generated POT file."
+msgid "<emph>header</emph>: Comments that will be added on top of the generated POT file."
msgstr ""
-#. qfPvB
+#. YhYbQ
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id111614364686973\n"
"help.text"
-msgid "Do not include any leading \"#\" characters. If you want the header to be broken into multiple lines, insert escape sequences (\\n) where relevant. A standard header will be added alongside the text specified in the <literal>Header</literal> argument."
+msgid "Do not include any leading \"#\" characters. If you want the header to be broken into multiple lines, insert escape sequences (\\n) where relevant. A standard header will be added alongside the text specified in the <literal>header</literal> argument."
msgstr ""
-#. rUUCt
+#. E2Loj
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id5158610270728\n"
"help.text"
-msgid "<emph>Encoding</emph>: The character set to be used (Default = \"UTF-8\")."
+msgid "<emph>encoding</emph>: The character set to be used (Default = \"UTF-8\")."
msgstr ""
#. uDu7z
@@ -16730,13 +16811,13 @@ msgctxt ""
msgid "The generated file should successfully pass the <literal>msgfmt --check</literal> GNU command."
msgstr ""
-#. wBAjb
+#. 32fPj
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id891586165768715\n"
"help.text"
-msgid "Gets the translated string corresponding to the given <literal>MsgId</literal> argument."
+msgid "Gets the translated string corresponding to the given <literal>msgid</literal> argument."
msgstr ""
#. NzGZC
@@ -16766,58 +16847,58 @@ msgctxt ""
msgid "This method can be called either by the full name <literal>GetText</literal> or by the shortcut <literal>_</literal> (a single underscore):"
msgstr ""
-#. NzdBC
+#. mvB66
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id421614967136502\n"
"help.text"
-msgid "In the ScriptForge library, all methods starting with the \"_\" character are reserved for internal use only. However, the shortcut <literal>_</literal> used for <literal>GetText</literal> is the only exception to this rule, hence it can be safely used in Basic scripts."
+msgid "In the ScriptForge library, all methods starting with the \"_\" character are reserved for internal use only. However, the shortcut <literal>_</literal> used for <literal>GetText</literal> is the only exception to this rule, hence it can be safely used in Basic and Python scripts."
msgstr ""
-#. rNrAw
+#. 2ZVAQ
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id51586165768525\n"
"help.text"
-msgid "<emph>MsgId</emph>: The untranslated string, which is the text appearing in the program code. It must not be empty. It may contain any number of placeholders (%1 %2 %3 ...) that can be used to dynamically insert text at runtime."
+msgid "<emph>msgid</emph>: The untranslated string, which is the text appearing in the program code. It must not be empty. It may contain any number of placeholders (%1 %2 %3 ...) that can be used to dynamically insert text at runtime."
msgstr ""
-#. Fummg
+#. dALxK
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id11614365537450\n"
"help.text"
-msgid "Besides using a single <literal>MsgId</literal> string, this method also accepts the following formats:"
+msgid "Besides using a single <literal>msgid</literal> string, this method also accepts the following formats:"
msgstr ""
-#. fD2Bg
+#. Q7Bbm
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id961614365557277\n"
"help.text"
-msgid "The <literal>Context</literal> string with which the method will retrieve the <literal>MsgId</literal> in the PO file, or;"
+msgid "The <literal>context</literal> string with which the method will retrieve the <literal>msgid</literal> in the PO file, or;"
msgstr ""
-#. v6nVR
+#. rTDrq
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id981614365589866\n"
"help.text"
-msgid "A combination <literal>Context|MsgId</literal>, instructing the method to retrieve the <literal>MsgId</literal> using specified <literal>Context</literal> value. The second part of the argument is used to improve code readability."
+msgid "A combination <literal>context|msgid</literal>, instructing the method to retrieve the <literal>msgid</literal> using specified <literal>context</literal> value. The second part of the argument is used to improve code readability."
msgstr ""
-#. 5zB4f
+#. dW6RE
#: sf_l10n.xhp
msgctxt ""
"sf_l10n.xhp\n"
"par_id571586165768106\n"
"help.text"
-msgid "<emph>Arg1, ...</emph>: Values to be inserted into the placeholders. Any variable type is allowed, however only strings, numbers and dates will be considered."
+msgid "<emph>args</emph>: Values to be inserted into the placeholders. Any variable type is allowed, however only strings, numbers and dates will be considered."
msgstr ""
#. cCZDK
@@ -16829,13 +16910,328 @@ msgctxt ""
msgid "Consider the following code is running on a %PRODUCTNAME installation with locale set to \"es-ES\". Additionally, there is a file \"es-ES.po\" inside the specified folder that translates the string passed to the <literal>GetText</literal> method:"
msgstr ""
-#. zJaES
-#: sf_l10n.xhp
+#. yYNtX
+#: sf_methods.xhp
msgctxt ""
-"sf_l10n.xhp\n"
-"par_id301613075694148\n"
+"sf_methods.xhp\n"
+"tit\n"
+"help.text"
+msgid "ScriptForge Method Signatures"
+msgstr ""
+
+#. ycA6s
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"hd_id31529004750471\n"
"help.text"
-msgid "<link href=\"text/sbasic/guide/translation.xhp\" name=\"Controls Translation\">Translation of Controls in the Dialog Editor</link>"
+msgid "<variable id=\"SF_Signatures\"><link href=\"text/sbasic/shared/03/sf_methods.xhp\" name=\"ScriptForge Method Signatures\"><literal>ScriptForge</literal> Method Signatures</link></variable>"
+msgstr ""
+
+#. gEAos
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"bm_id491529070339774\n"
+"help.text"
+msgid "<bookmark_value>ScriptForge; Method signatures</bookmark_value>"
+msgstr ""
+
+#. Xq2N5
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id681619700336879\n"
+"help.text"
+msgid "ScriptForge libraries aggregate macro scripting resources for %PRODUCTNAME to be invoked from Basic macros or Python scripts. Its modules and classes are invoked from user scripts as \"Services\" that expose properties, methods and events."
+msgstr ""
+
+#. paARG
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id681623415196030\n"
+"help.text"
+msgid "Whenever service methods are proposed solely for %PRODUCTNAME Basic, their syntax presentation matches that of Basic subroutines, functions or properties."
+msgstr ""
+
+#. 4dWnv
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id401623415235965\n"
+"help.text"
+msgid "Whenever service methods are proposed for Python and Basic, or solely for Python, their syntax and arguments use a specific textual layout."
+msgstr ""
+
+#. McY36
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"hd_id1001623415980365\n"
+"help.text"
+msgid "Basic only service method"
+msgstr ""
+
+#. tCvuL
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id791623418737799\n"
+"help.text"
+msgid "Typographical characters such as brackets, ellipsis or curly braces denote optional, repetitive or compulsory arguments:"
+msgstr ""
+
+#. FkDFy
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"hd_id711623416000470\n"
+"help.text"
+msgid "Python or Basic service methods"
+msgstr ""
+
+#. 8C6EM
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id221623415475781\n"
+"help.text"
+msgid "The following typographical rules are mixing the UML notation, the API documentation layout and the UNO object inspector user interface:"
+msgstr ""
+
+#. aSSDq
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id661623417427142\n"
+"help.text"
+msgid "Optional parameters are indicated with either opt, '=' accompanying a default value, or '[ ]' brackets."
+msgstr ""
+
+#. 534sD
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id351623417430814\n"
+"help.text"
+msgid "arguments are lowercased, in order to comply with Python PEP 8 while Basic is case-agnostic."
+msgstr ""
+
+#. kFDAg
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id781623417432494\n"
+"help.text"
+msgid "Collections arguments or API sequences are denoted using UML multiplicity. That applies also to return values."
+msgstr ""
+
+#. bmVjq
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id741623417433319\n"
+"help.text"
+msgid "Basic data types and Python annotations are syntactically transposed as:"
+msgstr ""
+
+#. GGeNU
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id441613838858931\n"
+"help.text"
+msgid "Syntax"
+msgstr ""
+
+#. ENqPg
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id851613847558931\n"
+"help.text"
+msgid "Boolean"
+msgstr ""
+
+#. KvECx
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id541623420256687\n"
+"help.text"
+msgid "datetime"
+msgstr ""
+
+#. gEDv5
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id421623420257224\n"
+"help.text"
+msgid "datetime"
+msgstr ""
+
+#. KyGCx
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id321623420281678\n"
+"help.text"
+msgid "float"
+msgstr ""
+
+#. TCZND
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id471623420282320\n"
+"help.text"
+msgid "float"
+msgstr ""
+
+#. CYgLM
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id971623420314751\n"
+"help.text"
+msgid "int"
+msgstr ""
+
+#. 6SGDq
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id561623420315278\n"
+"help.text"
+msgid "int"
+msgstr ""
+
+#. gQx34
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id451623420342159\n"
+"help.text"
+msgid "int"
+msgstr ""
+
+#. BxcdG
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id591623420343208\n"
+"help.text"
+msgid "int"
+msgstr ""
+
+#. n2DgV
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id601623420375543\n"
+"help.text"
+msgid "obj"
+msgstr ""
+
+#. AophW
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id821623420532337\n"
+"help.text"
+msgid "float"
+msgstr ""
+
+#. gegJw
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id351623420532936\n"
+"help.text"
+msgid "float"
+msgstr ""
+
+#. RFbyb
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id211623420546503\n"
+"help.text"
+msgid "str"
+msgstr ""
+
+#. Eex5K
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id681623420559167\n"
+"help.text"
+msgid "str"
+msgstr ""
+
+#. BxTYx
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id81623420571390\n"
+"help.text"
+msgid "any"
+msgstr ""
+
+#. vWABe
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id931623419595424\n"
+"help.text"
+msgid "UNO Object"
+msgstr ""
+
+#. cE5KS
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id821623420607671\n"
+"help.text"
+msgid "uno"
+msgstr ""
+
+#. 2q5Bk
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id951623419595631\n"
+"help.text"
+msgid "User Defined<br/>Type (UDT)"
+msgstr ""
+
+#. yATCd
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id491623420626262\n"
+"help.text"
+msgid "obj"
+msgstr ""
+
+#. h4Tu4
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id451623419793734\n"
+"help.text"
+msgid "<literal>ScriptForge</literal><br/>service"
+msgstr ""
+
+#. tBcFF
+#: sf_methods.xhp
+msgctxt ""
+"sf_methods.xhp\n"
+"par_id761623420648335\n"
+"help.text"
+msgid "svc"
msgstr ""
#. Ah5Gj
@@ -16919,13 +17315,13 @@ msgctxt ""
msgid "Service invocation"
msgstr ""
-#. Emisv
+#. mHGZk
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
"par_id321614902851541\n"
"help.text"
-msgid "The code snippet below instantiates the <literal>Platform</literal> service and accesses the <literal>Architecture</literal> property."
+msgid "The examples below in Basic and Python instantiate the <literal>Platform</literal> service and access the <literal>Architecture</literal> property."
msgstr ""
#. KC5eN
@@ -17180,67 +17576,67 @@ msgctxt ""
msgid "Example: '<literal>#50-Ubuntu SMP Tue Feb 9 06:29:41 UTC 2021</literal>'"
msgstr ""
-#. fCdYi
+#. E8DzK
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id941600789527698\n"
+"par_id941608709527698\n"
"help.text"
msgid "Yes"
msgstr ""
-#. wkthE
+#. ArFcn
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id631600789527859\n"
+"par_id661300789527859\n"
"help.text"
-msgid "The real processor name. Example: '<literal>amdk6</literal>'."
+msgid "The list of available printers as a zero-based array."
msgstr ""
-#. MYY9M
+#. nN5EG
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id111614902598396\n"
+"par_id111614952098396\n"
"help.text"
-msgid "This property may return the same value as the <literal>Machine</literal> property."
+msgid "The default printer is put in the first position of the list (index = 0)."
msgstr ""
-#. 4pnPw
+#. fCdYi
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id301613075694148\n"
+"par_id941600789527698\n"
"help.text"
-msgid "<link href=\"text/sbasic/python/python_platform.xhp\" name=\"OS python\">Identifying the operating system</link>"
+msgid "Yes"
msgstr ""
-#. UCfLb
+#. wkthE
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id301613065794148\n"
+"par_id631600789527859\n"
"help.text"
-msgid "<link href=\"text/scalc/01/04060104.xhp\" name=\"Platform information with Calc INFO formula\">Platform information with INFO(\"system\") Calc formula</link>"
+msgid "The real processor name. Example: '<literal>amdk6</literal>'."
msgstr ""
-#. PqDHG
+#. MYY9M
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id103613075694148\n"
+"par_id111614902598396\n"
"help.text"
-msgid "<link href=\"text/sbasic/shared/03132100.xhp\" name=\"GetGuiType Function\">GetGuiType function</link>"
+msgid "This property may return the same value as the <literal>Machine</literal> property."
msgstr ""
-#. DAfoV
+#. 3yeMr
#: sf_platform.xhp
msgctxt ""
"sf_platform.xhp\n"
-"par_id301316075694148\n"
+"par_id301613065794148\n"
"help.text"
-msgid "<link href=\"text/sbasic/shared/03/lib_tools.xhp\" name=\"Tools library\">Tools library</link>"
+msgid "<link href=\"text/scalc/01/04060104.xhp#bm_id3691824\" name=\"Calc_Info\">Platform information with INFO(\"system\") Calc formula</link>"
msgstr ""
#. GpvmN
@@ -17261,193 +17657,103 @@ msgctxt ""
msgid "<variable id=\"ScriptForgeServices\"><link href=\"text/sbasic/shared/03/sf_services.xhp\" name=\"Services service\"><literal>ScriptForge</literal>.<literal>Services</literal> service</link></variable>"
msgstr ""
-#. 2TqZf
+#. SDbDJ
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id351582710868545\n"
+"par_id241627513489594\n"
"help.text"
-msgid "The ScriptForge library is built upon an extensible collection of so-called \"Services\". <br/>This collection is implemented as categories of Basic libraries or Python modules:"
+msgid "The main purpose of the <literal>Services</literal> module is to provide access to the <literal>CreateScriptService</literal> method, which can be called in user scripts to instantiate services that are implemented using the ScriptForge framework."
msgstr ""
-#. G2GDr
+#. 7B2KJ
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id751582711417284\n"
-"help.text"
-msgid "the standard <literal>ScriptForge</literal> library shipped with %PRODUCTNAME"
-msgstr ""
-
-#. pyGFM
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id711582711434921\n"
-"help.text"
-msgid "a number of \"associated\" libraries shipped with %PRODUCTNAME as well"
-msgstr ""
-
-#. DLRfn
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id11582711444725\n"
-"help.text"
-msgid "any user/contributor LibreOffice extension wanting to fit into the same framework"
-msgstr ""
-
-#. WZtZa
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id211596296017810\n"
-"help.text"
-msgid "A <emph>service</emph> is a collection of properties or methods which implement the service."
-msgstr ""
-
-#. 8yaDQ
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id301596296901387\n"
-"help.text"
-msgid "For the author of a user script, a service may be either a <emph>module</emph> within a library, or an <emph>instance</emph> of a class module."
-msgstr ""
-
-#. pJ7ic
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id411596296395830\n"
-"help.text"
-msgid "An <emph>event manager</emph> is a script contained in a library which binds an event triggering a macro - usually defined by the <menuitem>Tools - Customize</menuitem> menu - to the concerned service instance."
-msgstr ""
-
-#. 8tKxb
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id771596296933669\n"
-"help.text"
-msgid "As an example, if several documents trigger the same macro when they are loaded, it might be useful to know which document triggered the macro this time. That's where an event manager plays its role."
-msgstr ""
-
-#. vpUVp
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id191582711902530\n"
-"help.text"
-msgid "The following methods make up the kernel of the <literal>ScriptForge</literal> framework:"
-msgstr ""
-
-#. td8Cp
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id351582712098824\n"
-"help.text"
-msgid "Called internally by <literal>ScriptForge</literal> to register for a library the list of services it implements. <br/>Each library associated to <literal>Scriptforge</literal> or extending it must implement its own <literal>RegisterScriptServices</literal> method."
-msgstr ""
-
-#. Adbws
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id671595847982308\n"
-"help.text"
-msgid "Called - as many times as there are services to register in the library - by <literal>RegisterScriptServices</literal>."
-msgstr ""
-
-#. vsobg
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id241596294275434\n"
+"par_id351582710868545\n"
"help.text"
-msgid "Called to register a library event manager by <literal>RegisterScriptServices</literal>."
+msgid "In ScriptForge terminology a service is a collection of methods and properties that can be used for a common purpose. For example, the <literal>String</literal> service provides methods for manipulating strings whereas the <literal>FileSystem</literal> service allows for the manipulation of files and folders."
msgstr ""
-#. sZBHB
+#. NW4BS
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id741582712156448\n"
+"par_id541627513771828\n"
"help.text"
-msgid "Called by user scripts to get an object giving access to the service given as argument. <br/>All services should be invoked through the <literal>CreateScriptService</literal> method."
+msgid "The <literal>Services</literal> module of the ScriptForge library provides additional methods that are used either internally to register available services or by developers who are interested in extending ScriptForge by creating new services. The only method that is relevant for user scripts is <literal>CreateScriptService</literal>."
msgstr ""
-#. 9Geac
+#. FW4FC
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id651582712806415\n"
+"par_id871582714020043\n"
"help.text"
-msgid "Conventionally, the <literal>String</literal>, <literal>Array</literal> and <literal>Exception</literal> services may be invoked directly respectively as <literal>SF_String</literal>, <literal>SF_Array</literal> and <literal>SF_Exception</literal>."
+msgid "This method is used to instantiate a ScriptForge service so it can be called in user scripts."
msgstr ""
-#. BzHaE
+#. jG6U9
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id891611613601554\n"
+"par_id711627514310039\n"
"help.text"
-msgid "List of Methods in the Services Service"
+msgid "The returned value is a Basic object or <literal>Nothing</literal> if an error occurred."
msgstr ""
-#. howve
+#. Vrzc9
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id871582714020043\n"
+"par_id961627475353964\n"
"help.text"
-msgid "Gain access to one of the services of a library for the benefit of a user script. <br/> The returned value is a Basic object or <literal>Nothing</literal> if an error occurred."
+msgid "<input>svc.CreateScriptService(service: str, [arg0: any] ...): svc</input>"
msgstr ""
-#. KweBC
+#. oojMF
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id101582714266656\n"
+"par_id971582714020045\n"
"help.text"
-msgid "A service can be understood as either:"
+msgid "<emph>service</emph>: The name of the service identified as a string in the format \"library.service\":"
msgstr ""
-#. w7Czn
+#. CEqku
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id531582714337820\n"
+"par_id11627475954271\n"
"help.text"
-msgid "as a set of methods gathered in a Basic standard module"
+msgid "The <emph>library</emph> is a Basic library that must exist in the <link href=\"text/sbasic/shared/03131900.xhp\" name=\"GlobalScope\">GlobalScope</link>. The default value is \"ScriptForge\"."
msgstr ""
-#. rfAFT
+#. BBFeA
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id291582714347134\n"
+"par_id811627475954641\n"
"help.text"
-msgid "or a set of methods and properties gathered in a Basic class module."
+msgid "The <emph>service</emph> is one of the services registered by the ScriptForge library."
msgstr ""
-#. VuLrG
+#. btbtw
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id971582714020045\n"
+"par_id391582714020045\n"
"help.text"
-msgid "<emph>Service</emph>: The name of the service identified as \"library.service\". <br/>The library is a Basic library that must exist in the <link href=\"text/sbasic/shared/03131900.xhp\" name=\"GlobalScope\">GlobalScope</link>. The default value is \"ScriptForge\". <br/>The service is one of the services registered by the library via the <literal>RegisterScriptServices()</literal> method."
+msgid "<emph>arg0, ...</emph>: A list of arguments required by the invoked service."
msgstr ""
-#. q97vs
+#. yAaks
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id391582714020045\n"
+"par_id841627475900817\n"
"help.text"
-msgid "<emph>arg0, ...</emph>: A list of arguments required by the invoked service. <br/>If the first argument refers to an event manager, then arg0 is mandatory and must be the UNO object representing the event provided as argument to the user macro."
+msgid "If the first argument refers to an event manager, then <literal>arg0</literal> is mandatory and must be the UNO object representing the event provided as argument to the user macro."
msgstr ""
#. wuR7S
@@ -17513,211 +17819,40 @@ msgctxt ""
msgid "' Returns the instance of the Document class that fired the event"
msgstr ""
-#. AsuMY
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id1315827229793\n"
-"help.text"
-msgid "By executing a series of invocations of <literal>RegisterService()</literal> and <literal>RegisterEventManager()</literal>, the <literal>RegisterScriptServices()</literal> method incorporates a library into the <literal>ScriptForge</literal> framework. <br/>Each library pertaining to the framework must implement its own version of this method."
-msgstr ""
-
-#. 8FgEA
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id411582723190195\n"
-"help.text"
-msgid "The method has to be stored in a <emph>standard</emph> Basic module as opposed to a class module."
-msgstr ""
-
-#. jEAZb
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id351582724127926\n"
-"help.text"
-msgid "A service is either:"
-msgstr ""
-
-#. oC8wx
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id171582722979820\n"
-"help.text"
-msgid "a Basic standard module passed as a Basic object."
-msgstr ""
-
-#. r98Hy
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id121582722979649\n"
-"help.text"
-msgid "or a string designating the function to execute to get an instance of the service. It is in fact the function containing the <literal>New</literal> keyword of a <link href=\"text/sbasic/shared/03103700.xhp\" name=\"Set statement\">Set</link> statement creating the instance."
-msgstr ""
-
-#. FKqFQ
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id771582725815107\n"
-"help.text"
-msgid "GlobalScope.LibraryName.ModuleName ' Object"
-msgstr ""
-
-#. DYyWS
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"bas_id721582724496873\n"
-"help.text"
-msgid "\"LibraryName.ModuleName.FunctionName\" ' String"
-msgstr ""
-
-#. uej6R
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"bas_id11582725353585\n"
-"help.text"
-msgid "' Refer to a Basic standard module implementing the service as a set of methods"
-msgstr ""
-
-#. jCUWF
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"bas_id341582725374064\n"
-"help.text"
-msgid "' The function should return an instance of a Basic object class implementing the service"
-msgstr ""
-
-#. iwekv
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id741582727674249\n"
-"help.text"
-msgid "When a user script contains a statement such as:"
-msgstr ""
-
-#. ivHq4
+#. zhCyY
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id611582727701061\n"
+"par_id321627570607194\n"
"help.text"
-msgid "<br/><literal>ScriptForge</literal> performs these tasks:"
+msgid "Python scripts support keyword arguments when calling <literal>CreateScriptService</literal>. The following example illustrates this concept by instantiating the <literal>Timer</literal> and <literal>Document</literal> services using keyword arguments."
msgstr ""
-#. 8AiaU
+#. jah7F
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id511582728914523\n"
+"par_id901627576693156\n"
"help.text"
-msgid "load the library <literal>myLibrary</literal> when necessary"
+msgid "To make writing Python scripts more fluid, ScriptForge provides the <literal>Basic</literal> service which allows Python scripts to call a collection of methods with the same syntax and meaning as their homonymous native Basic functions."
msgstr ""
-#. Egm5V
+#. SDQ7m
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id441582728492537\n"
+"par_id41627644806288\n"
"help.text"
-msgid "invoke the <literal>RegisterScriptServices</literal> method to load the list of services of <literal>myLibrary</literal> in memory"
+msgid "The following example instantiates the <literal>Basic</literal> service and calls the <literal>MsgBox</literal> method, which is equivalent to the <literal>MsgBox</literal> function available in Basic:"
msgstr ""
-#. csxrp
+#. zVgQm
#: sf_services.xhp
msgctxt ""
"sf_services.xhp\n"
-"par_id531582728511341\n"
+"par_id581627645023307\n"
"help.text"
-msgid "initialize the variable <literal>myServ</literal> with the given service"
-msgstr ""
-
-#. x6Xa6
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id331595857355789\n"
-"help.text"
-msgid "The method returns <literal>True</literal> if the name-value pair given as argument could be registered successfully."
-msgstr ""
-
-#. ELGxD
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id721595857355929\n"
-"help.text"
-msgid "<emph>ServiceName</emph>: The name of the service as a case-insensitive string. The name must be unique."
-msgstr ""
-
-#. GkGcA
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id271595857355756\n"
-"help.text"
-msgid "<emph>ServiceReference</emph>: A service reference is either:"
-msgstr ""
-
-#. cmHCE
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"bas_id101595857355820\n"
-"help.text"
-msgid "' Refer to a Basic standard module implementing the service as a set of methods"
-msgstr ""
-
-#. bgCCe
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"bas_id951595857355198\n"
-"help.text"
-msgid "' The function should return an instance of a Basic object class implementing the service"
-msgstr ""
-
-#. QPDMC
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id701596299279876\n"
-"help.text"
-msgid "The method returns <literal>True</literal> if the name-value pair given as argument could be registered successfully."
-msgstr ""
-
-#. Ky8rX
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id331596299279165\n"
-"help.text"
-msgid "<emph>ServiceName</emph>: The name of the service as a case-insensitive string. The name must be unique."
-msgstr ""
-
-#. 3AXvN
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"par_id92159629927929\n"
-"help.text"
-msgid "<emph>ServiceReference</emph>: A string designating the function to execute to get an instance of the service. It is in fact the function containing the <literal>New</literal> keyword of a <link href=\"text/sbasic/shared/03103700.xhp\" name=\"Set statement\">Set</link> statement creating the instance.:"
-msgstr ""
-
-#. FKFAC
-#: sf_services.xhp
-msgctxt ""
-"sf_services.xhp\n"
-"bas_id521596299279373\n"
-"help.text"
-msgid "' The function should return an instance of a Basic object class implementing the service"
+msgid "Beware that the <literal>Basic</literal> service has to be instantiated in Python scripts using the <literal>CreateScriptService</literal> method."
msgstr ""
#. LCVem
@@ -17792,13 +17927,13 @@ msgctxt ""
msgid "Constants"
msgstr ""
-#. BuuCB
+#. zcRQu
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id82158281472034\n"
"help.text"
-msgid "Below is a list of constants available to ease the designation of the library containing a Basic or Python script to invoke. <br/>Use them as <literal>session.CONSTANT</literal>."
+msgid "Below is a list of constants available to ease the designation of the library containing a Basic or Python script to invoke. Use them as <literal>session.CONSTANT</literal>."
msgstr ""
#. yyF2R
@@ -17900,13 +18035,13 @@ msgctxt ""
msgid "List of Methods in the Session Service"
msgstr ""
-#. V4BCf
+#. JvBuZ
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id491613061572993\n"
"help.text"
-msgid "<literal>Session</literal> service methods behave as follows: <br/>Arguments are passed by value. Updates performed by the called function are not sent back to the calling script. <br/>A single value or an array of values is returned to the calling script."
+msgid "<literal>Execute...</literal> methods in <literal>Session</literal> service behave as follows: <br/>Arguments are passed by value. Changes made by the called function to the arguments do not update their values in the calling script. <br/>A single value or an array of values is returned to the calling script."
msgstr ""
#. 72GZi
@@ -17918,49 +18053,94 @@ msgctxt ""
msgid "Execute the Basic script given its name and location and fetch its result if any."
msgstr ""
-#. yWXBt
+#. yFnSG
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id921600856780901\n"
"help.text"
-msgid "If the script is not found, or if it returns nothing, the returned value is <literal>Empty</literal>."
+msgid "If the script returns nothing, which is the case of procedures defined with <literal>Sub</literal>, the returned value is <literal>Empty</literal>."
msgstr ""
-#. bWiEa
+#. VTyCE
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id631582815407231\n"
"help.text"
-msgid "<emph>Scope</emph>: \"document\" or \"application\" or one of the applicable <literal>session.CONSTANTS</literal>."
+msgid "<emph>scope</emph>: String specifying where the script is stored. It can be either \"document\" (constant <literal>session.SCRIPTISEMBEDDED</literal>) or \"application\" (constant <literal>session.SCRIPTISAPPLICATION</literal>)."
msgstr ""
-#. fxDM3
+#. SCCpE
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id691582815407231\n"
"help.text"
-msgid "<emph>Script</emph>: \"library.module.method\" as a case-sensitive string. <br/>The library is loaded in memory if necessary. <br/>The module must not be a class module. <br/>The method may be a <literal>Sub</literal> or a <literal>Function</literal>."
+msgid "<emph>script</emph>: String specifying the script to be called in the format \"library.module.method\" as a case-sensitive string."
+msgstr ""
+
+#. hS5x4
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id741626828862265\n"
+"help.text"
+msgid "The library is loaded in memory if necessary."
+msgstr ""
+
+#. D8AL6
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id981626828863001\n"
+"help.text"
+msgid "The module must not be a class module."
+msgstr ""
+
+#. VsUFD
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id721626828863257\n"
+"help.text"
+msgid "The method may be a <literal>Sub</literal> or a <literal>Function</literal>."
msgstr ""
-#. UM3xU
+#. eExjm
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id881582815407231\n"
"help.text"
-msgid "<emph>arg0, ...</emph>: The arguments to provide to the called script."
+msgid "<emph>args</emph>: The arguments to be passed to the called script."
msgstr ""
-#. bvuhY
+#. mg5WG
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
-"bas_id61582815407231\n"
+"par_id21626809513802\n"
"help.text"
-msgid "' Xray returns no value"
+msgid "Consider the following Basic function named <literal>DummyFunction</literal> that is stored in \"My Macros\" in the \"Standard\" library inside a module named \"Module1\"."
+msgstr ""
+
+#. PMyrB
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id551626810319766\n"
+"help.text"
+msgid "The function simply takes in two integer values <literal>v1</literal> and <literal>v2</literal> and return the sum of all values starting in <literal>v1</literal> and ending in <literal>v2</literal>."
+msgstr ""
+
+#. Gx6fV
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id461626810470057\n"
+"help.text"
+msgid "The examples below show how to call <literal>DummyFunction</literal> from within Basic and Python scripts."
msgstr ""
#. Yr22N
@@ -17972,22 +18152,22 @@ msgctxt ""
msgid "Execute a Calc function using its English name and based on the given arguments. <br/>If the arguments are arrays, the function is executed as an <link href=\"text/scalc/01/04060107.xhp\" name=\"array formula\">array formula</link>."
msgstr ""
-#. gG7vu
+#. EDU9x
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id771582816585183\n"
"help.text"
-msgid "<emph>CalcFunction</emph>: The English name of the function to execute."
+msgid "<emph>calcfunction</emph>: The name of the Calc function to be called, in English."
msgstr ""
-#. ULCqi
+#. FJJJh
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id371582816585183\n"
"help.text"
-msgid "<emph>arg0, ...</emph>: The arguments to provide to the called Calc function. Each argument must be either a string, a numeric value or an array of arrays combining those types."
+msgid "<emph>args</emph>: The arguments to be passed to the called Calc function. Each argument must be either a string, a numeric value or an array of arrays combining those types."
msgstr ""
#. XMfUD
@@ -18017,22 +18197,22 @@ msgctxt ""
msgid "If the script is not found, or if it returns nothing, the returned value is <literal>Empty</literal>."
msgstr ""
-#. JsjbE
+#. jdWTU
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id791582818023246\n"
"help.text"
-msgid "<emph>Scope</emph>: One of the applicable <literal>session.CONSTANTS</literal>. Default = <literal>session.SCRIPTISSHARED</literal>."
+msgid "<emph>scope</emph>: One of the applicable constants listed <link href=\"text/sbasic/shared/03/sf_session.xhp#constants\" name=\"Session constants\">above</link>. The default value is <literal>session.SCRIPTISSHARED</literal>."
msgstr ""
-#. UDbdL
+#. ELfda
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id71582818023247\n"
"help.text"
-msgid "<emph>Script</emph>: Either \"library/module.py$method\" or \"module.py$method\" or \"myExtension.oxt|myScript|module.py$method\" as a case-sensitive string."
+msgid "<emph>script</emph>: Either \"library/module.py$method\" or \"module.py$method\" or \"myExtension.oxt|myScript|module.py$method\" as a case-sensitive string."
msgstr ""
#. P6ZKD
@@ -18071,13 +18251,40 @@ msgctxt ""
msgid "method: The Python function."
msgstr ""
-#. LPeJj
+#. dWbiV
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id711582818023247\n"
"help.text"
-msgid "<emph>arg0, ...</emph>: The arguments to provide to the called script."
+msgid "<emph>args</emph>: The arguments to be passed to the called script.."
+msgstr ""
+
+#. Az2PX
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id701626817164878\n"
+"help.text"
+msgid "Consider the Python function <literal>odd_integers</literal> defined below that creates a list with odd integer values between <literal>v1</literal> an <literal>v2</literal>. Suppose this function is stored in a file named <emph>my_macros.py</emph> in your user scripts folder."
+msgstr ""
+
+#. CHr5n
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id751626817335715\n"
+"help.text"
+msgid "Read the help page <embedvar href=\"text/sbasic/python/python_locations.xhp#pythonlocations1\"/> to learn more about where Python scripts can be stored."
+msgstr ""
+
+#. vqBm9
+#: sf_session.xhp
+msgctxt ""
+"sf_session.xhp\n"
+"par_id121626817725471\n"
+"help.text"
+msgid "The following examples show how to call the function <literal>odd_integers</literal> from within Basic and Python scripts."
msgstr ""
#. Lv4iA
@@ -18089,22 +18296,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if an UNO object contains the given method. Returns <literal>False</literal> when the method is not found or when an argument is invalid."
msgstr ""
-#. AmYDH
+#. HAw32
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id921587477335673\n"
"help.text"
-msgid "<emph>UnoObject</emph>: The object to inspect."
+msgid "<emph>unoobject</emph>: The object to inspect."
msgstr ""
-#. d8D4G
+#. DDw6g
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id631587477566016\n"
"help.text"
-msgid "<emph>MethodName</emph>: the method as a case-sensitive string"
+msgid "<emph>methodname</emph>: the method as a case-sensitive string"
msgstr ""
#. gDBRB
@@ -18116,22 +18323,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if a UNO object has the given property. Returns <literal>False</literal> when the property is not found or when an argument is invalid."
msgstr ""
-#. 4Sgnh
+#. 54oXs
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id121587477832805\n"
"help.text"
-msgid "<emph>UnoObject</emph>: The object to inspect."
+msgid "<emph>unoobject</emph>: The object to inspect."
msgstr ""
-#. DGzZA
+#. hCTCk
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id701587477832750\n"
"help.text"
-msgid "<emph>PropertyName</emph>: the property as a case-sensitive string"
+msgid "<emph>propertyname</emph>: the property as a case-sensitive string"
msgstr ""
#. QWaTF
@@ -18143,40 +18350,40 @@ msgctxt ""
msgid "Open a Uniform Resource Locator (<link href=\"text/shared/00/00000002.xhp#URL\" name=\"URL\">URL</link>) in the default browser."
msgstr ""
-#. JD25Y
+#. 4tFWV
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id241601129640549\n"
"help.text"
-msgid "<emph>URL</emph>: The URL to open."
+msgid "<emph>url</emph>: The URL to open."
msgstr ""
-#. hmMBt
+#. hJqsF
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id311582819697897\n"
"help.text"
-msgid "Executes an arbitrary system command and returns <literal>True </literal> if it was launched successfully."
+msgid "Executes an arbitrary system command and returns <literal>True</literal> if it was launched successfully."
msgstr ""
-#. QgJxa
+#. D483F
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id461582819697898\n"
"help.text"
-msgid "<emph>Command</emph>: The command to execute. This may be an executable file or a document which is registered with an application so that the system knows what application to launch for that document. The command must be expressed in the current <literal>SF_FileSystem.FileNaming</literal> notation."
+msgid "<emph>command</emph>: The command to execute. This may be an executable file or a document which is registered with an application so that the system knows what application to launch for that document. The command must be expressed in the current <literal>SF_FileSystem.FileNaming</literal> notation."
msgstr ""
-#. vTm42
+#. b8hbC
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id611582819697899\n"
"help.text"
-msgid "<emph>Parameters</emph>: A list of space separated parameters as a single string. The method does not validate the given parameters, but only passes them to the specified command."
+msgid "<emph>parameters</emph>: A list of space separated parameters as a single string. The method does not validate the given parameters, but only passes them to the specified command."
msgstr ""
#. 2hTM7
@@ -18188,67 +18395,67 @@ msgctxt ""
msgid "Send a message - with optional attachments - to recipients from the user's mail client. The message may be edited by the user before sending or, alternatively, be sent immediately."
msgstr ""
-#. qdmqa
+#. FCn8e
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id701601030349896\n"
"help.text"
-msgid "<emph>Recipient</emph>: An email address (the \"To\" recipient)."
+msgid "<emph>recipient</emph>: An email address (the \"To\" recipient)."
msgstr ""
-#. xC9Lq
+#. BdMiD
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id571601030349904\n"
"help.text"
-msgid "<emph>Cc</emph>: A comma-separated list of email addresses (the \"carbon copy\" recipients)."
+msgid "<emph>cc</emph>: A comma-separated list of email addresses (the \"carbon copy\" recipients)."
msgstr ""
-#. xxBCy
+#. ADjaV
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id961601031043346\n"
"help.text"
-msgid "<emph>Bcc</emph>: A comma-separated list of email addresses (the \"blind carbon copy\" recipients)."
+msgid "<emph>bcc</emph>: A comma-separated list of email addresses (the \"blind carbon copy\" recipients)."
msgstr ""
-#. vMyR2
+#. zAkWZ
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id891601031050814\n"
"help.text"
-msgid "<emph>Subject</emph>: the header of the message."
+msgid "<emph>subject</emph>: the header of the message."
msgstr ""
-#. L7Cqy
+#. EG6ZA
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id191601031056673\n"
"help.text"
-msgid "<emph>Body</emph>: The content of the message as an unformatted text."
+msgid "<emph>body</emph>: The content of the message as an unformatted text."
msgstr ""
-#. HKGDs
+#. McuEx
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id511601031063269\n"
"help.text"
-msgid "<emph>FileNames</emph>: a comma-separated list of file names. Each file name must respect the <literal>SF_FileSystem.FileNaming</literal> notation."
+msgid "<emph>filenames</emph>: a comma-separated list of file names. Each file name must respect the <literal>SF_FileSystem.FileNaming</literal> notation."
msgstr ""
-#. k3Ssx
+#. h9Urq
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id161601032784063\n"
"help.text"
-msgid "<emph>EditMessage</emph>: When <literal>True</literal> (default), the message is edited before being sent."
+msgid "<emph>editmessage</emph>: When <literal>True</literal> (default), the message is edited before being sent."
msgstr ""
#. HtzHP
@@ -18260,13 +18467,13 @@ msgctxt ""
msgid "Returns a list of the methods callable from an UNO object. The list is a zero-based array of strings and may be empty."
msgstr ""
-#. C7NYy
+#. DX8qb
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id251587478024311\n"
"help.text"
-msgid "<emph>UnoObject</emph>: The object to inspect."
+msgid "<emph>unoobject</emph>: The object to inspect."
msgstr ""
#. sL6Ri
@@ -18278,13 +18485,13 @@ msgctxt ""
msgid "Returns a list of the properties of an UNO object. The list is a zero-based array of strings and may be empty."
msgstr ""
-#. FfvFC
+#. CFZRP
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id241587478343323\n"
"help.text"
-msgid "<emph>UnoObject</emph>: The object to inspect."
+msgid "<emph>unoobject</emph>: The object to inspect."
msgstr ""
#. Cm4eK
@@ -18296,13 +18503,13 @@ msgctxt ""
msgid "Identify the type of a UNO object as a string."
msgstr ""
-#. SudxH
+#. Cs3VC
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id921582820251349\n"
"help.text"
-msgid "<emph>UnoObject</emph>: The object to identify."
+msgid "<emph>unoobject</emph>: The object to identify."
msgstr ""
#. UAy4i
@@ -18314,13 +18521,13 @@ msgctxt ""
msgid "Get some web content from a URI."
msgstr ""
-#. C2AxK
+#. BU5XR
#: sf_session.xhp
msgctxt ""
"sf_session.xhp\n"
"par_id771582821057374\n"
"help.text"
-msgid "<emph>URI</emph>: URI text of the web service."
+msgid "<emph>uri</emph>: URI address of the web service."
msgstr ""
#. gn6AM
@@ -18629,13 +18836,31 @@ msgctxt ""
msgid "Before using the <literal>ScriptForge.String</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
msgstr ""
-#. tSsDx
+#. znLHV
+#: sf_string.xhp
+msgctxt ""
+"sf_string.xhp\n"
+"par_id271627158844922\n"
+"help.text"
+msgid "Loading the library will create the <literal>SF_String</literal> object that can be used to call the methods in the <literal>String</literal> service."
+msgstr ""
+
+#. e2Gty
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id63158659509728\n"
"help.text"
-msgid "The following code snippets show the three ways to call methods in the <literal>String</literal> service (the <literal>ExpandTabs</literal> method is used as an example):"
+msgid "The following code snippets show the three ways to call methods from the <literal>String</literal> service (the <literal>Capitalize</literal> method is used as an example):"
+msgstr ""
+
+#. UE3DL
+#: sf_string.xhp
+msgctxt ""
+"sf_string.xhp\n"
+"par_id761627158463235\n"
+"help.text"
+msgid "The code snippet below illustrates how to invoke methods from the <literal>String</literal> service in Python scripts. The <literal>IsIPv4</literal> method is used as an example."
msgstr ""
#. GfEcK
@@ -18647,13 +18872,13 @@ msgctxt ""
msgid "Properties"
msgstr ""
-#. PGBk4
+#. qKhL4
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id241611950267068\n"
"help.text"
-msgid "The <literal>SF_String</literal> object provides the following properties:"
+msgid "The <literal>SF_String</literal> object provides the following properties for Basic scripts:"
msgstr ""
#. FDjPb
@@ -18791,6 +19016,15 @@ msgctxt ""
msgid "The first argument of most methods is the string to be considered. It is always passed by reference and left unchanged. Methods such as <literal>Capitalize</literal>, <literal>Escape</literal>, etc return a new string after their execution."
msgstr ""
+#. PYcny
+#: sf_string.xhp
+msgctxt ""
+"sf_string.xhp\n"
+"par_id371627158142730\n"
+"help.text"
+msgid "Because Python has comprehensive built-in string support, most of the methods in the <literal>String</literal> service are available for Basic scripts only. The methods available for Basic and Python are: <literal>HashStr</literal>, <literal>IsADate</literal>, <literal>IsEmail</literal>, <literal>IsFileName</literal>, <literal>IsIBAN</literal>, <literal>IsIPv4</literal>, <literal>IsLike</literal>, <literal>IsSheetName</literal>, <literal>IsUrl</literal>, <literal>SplitNotQuoted</literal> and <literal>Wrap</literal>."
+msgstr ""
+
#. jaBZR
#: sf_string.xhp
msgctxt ""
@@ -18800,13 +19034,13 @@ msgctxt ""
msgid "Capitalizes the first character from each word in the input string."
msgstr ""
-#. ABfrm
+#. ibgky
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id941582304592013\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be capitalized."
+msgid "<emph>inputstr</emph>: The string to be capitalized."
msgstr ""
#. DB982
@@ -18818,40 +19052,40 @@ msgctxt ""
msgid "Counts the number of occurrences of a substring or a regular expression within a string."
msgstr ""
-#. tvxcg
+#. DxK5L
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id571582384689863\n"
"help.text"
-msgid "<emph>InputStr</emph>: The input string to be examined"
+msgid "<emph>inputstr</emph>: The input string to be examined"
msgstr ""
-#. 97Asr
+#. QUeur
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id601582384696486\n"
"help.text"
-msgid "<emph>Substring</emph>: The substring or the regular expression to be used during search"
+msgid "<emph>substring</emph>: The substring or the regular expression to be used during search"
msgstr ""
-#. i5aBr
+#. vGiqm
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id451582384703719\n"
"help.text"
-msgid "<emph>IsRegex</emph>: Use <literal>True</literal> if the substring is a regular expression (default = <literal>False</literal>)"
+msgid "<emph>isregex</emph>: Use <literal>True</literal> if the substring is a regular expression (Default = <literal>False</literal>)"
msgstr ""
-#. fxSHM
+#. WiFme
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id141582384726168\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>"
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. QcE5q
@@ -18899,31 +19133,31 @@ msgctxt ""
msgid "The function returns <literal>False</literal> when either the string or the substring have a length = 0 or when the substring is longer than the string."
msgstr ""
-#. xsyiT
+#. qk5nE
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id191579861552201\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be tested."
+msgid "<emph>inputstr</emph>: The string to be tested."
msgstr ""
-#. B5JDX
+#. 2Vipn
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id211579861561473\n"
"help.text"
-msgid "<emph>Substring</emph>: The substring to be searched at the end of <literal>InputStr</literal>."
+msgid "<emph>substring</emph>: The substring to be searched at the end of <literal>InputStr</literal>."
msgstr ""
-#. WfUif
+#. 4DKkW
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id801579861574009\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: The comparison can be case sensitive or not (default = <literal>False</literal>)."
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. gn2F8
@@ -18953,13 +19187,13 @@ msgctxt ""
msgid "Converts linebreaks and tabs contained in the input string to their equivalent escaped sequence (\\\\, \\n, \\r, \\t)."
msgstr ""
-#. KH5Qh
+#. kBiBE
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id9158592144110\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be converted."
+msgid "<emph>inputstr</emph>: The string to be converted."
msgstr ""
#. cpLKD
@@ -18989,22 +19223,22 @@ msgctxt ""
msgid "If a line break is found, a new line is started and the character counter is reset."
msgstr ""
-#. da5NH
+#. E73Ko
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id231579868290408\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be expanded"
+msgid "<emph>inputstr</emph>: The string to be expanded"
msgstr ""
-#. J3oNq
+#. 9dyYc
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id281579868299807\n"
"help.text"
-msgid "<emph>TabSize</emph>: This parameter is used to determine the Tab stops using the formula: TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (default = 8)"
+msgid "<emph>tabsize</emph>: This parameter is used to determine the Tab stops using the formula: TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (Default = 8)"
msgstr ""
#. GUoE8
@@ -19016,22 +19250,22 @@ msgctxt ""
msgid "Replaces all non-printable characters in the input string by a given character."
msgstr ""
-#. bJBrE
+#. GpHwp
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id431579874633865\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be searched"
+msgid "<emph>inputstr</emph>: The string to be searched"
msgstr ""
-#. bywcr
+#. GttDN
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id31579874656437\n"
"help.text"
-msgid "<emph>ReplacedBy</emph>: Zero, one or more characters that will replace all non-printable characters in <literal>InputStr</literal> (Default = \"\")"
+msgid "<emph>replacedby</emph>: Zero, one or more characters that will replace all non-printable characters in <literal>inputstr</literal> (Default = \"\")"
msgstr ""
#. W44TL
@@ -19043,58 +19277,58 @@ msgctxt ""
msgid "Finds in a string a substring matching a given regular expression."
msgstr ""
-#. FK83s
+#. aq28M
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id131579876314120\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be searched"
+msgid "<emph>inputstr</emph>: The string to be searched"
msgstr ""
-#. pEWGm
+#. hRrBB
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id751579876371545\n"
"help.text"
-msgid "<emph>Regex</emph>: The regular expression"
+msgid "<emph>regex</emph>: The regular expression"
msgstr ""
-#. vBGPG
+#. y2Fqs
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id881579876394584\n"
"help.text"
-msgid "<emph>Start</emph>: The position in the string where the search will begin. This parameter is passed by reference, so after execution the value of <literal>Start</literal> will point to the first character of the found substring. If no matching substring is found, <literal>Start</literal> will be set to 0."
+msgid "<emph>start</emph>: The position in the string where the search will begin. This parameter is passed by reference, so after execution the value of <literal>start</literal> will point to the first character of the found substring. If no matching substring is found, <literal>start</literal> will be set to 0."
msgstr ""
-#. 8ACCG
+#. yZMDg
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id251579876403831\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>"
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
-#. y5jTA
+#. A4JC7
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id841579876412287\n"
"help.text"
-msgid "<emph>Forward</emph>: Determines the direction of the search. If <literal>True</literal>, search moves forward. If <literal>False</literal> search moves backwards (Default = <literal>True</literal>)"
+msgid "<emph>forward</emph>: Determines the direction of the search. If <literal>True</literal>, search moves forward. If <literal>False</literal> search moves backwards (Default = <literal>True</literal>)"
msgstr ""
-#. 24fyo
+#. SkaCi
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id451612309155653\n"
"help.text"
-msgid "At the first iteration, if <literal>Forward = True</literal>, then <literal>Start</literal> should be equal to 1, whereas if <literal>Forward = False</literal> then <literal>Start</literal> should be equal to <literal>Len(InputStr)</literal>"
+msgid "At the first iteration, if <literal>forward = True</literal>, then <literal>start</literal> should be equal to 1, whereas if <literal>forward = False</literal> then <literal>start</literal> should be equal to <literal>Len(inputstr)</literal>"
msgstr ""
#. gv3oo
@@ -19133,22 +19367,22 @@ msgctxt ""
msgid "The hash algorithms supported are: <literal>MD5</literal>, <literal>SHA1</literal>, <literal>SHA224</literal>, <literal>SHA256</literal>, <literal>SHA384</literal> and <literal>SHA512</literal>."
msgstr ""
-#. xWGnD
+#. yUmmb
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id621601048983210\n"
"help.text"
-msgid "<emph>InputStr</emph> : The string to hash. It is presumed to be encoded in UTF-8. The hashing algorithm will consider the string as a stream of bytes."
+msgid "<emph>inputstr</emph>: The string to hash. It is presumed to be encoded in UTF-8. The hashing algorithm will consider the string as a stream of bytes."
msgstr ""
-#. krqwK
+#. nuQRb
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id941601048983822\n"
"help.text"
-msgid "<emph>Algorithm</emph> : One of the supported algorithms listed above, passed as a string."
+msgid "<emph>algorithm</emph>: One of the supported algorithms listed above, passed as a string."
msgstr ""
#. TXGmB
@@ -19169,13 +19403,13 @@ msgctxt ""
msgid "For example, the character <literal>é</literal> would be replaced by <literal>&eacute;</literal> or an equivalent numerical HTML code."
msgstr ""
-#. 2SAZB
+#. CGFQH
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"bas_id501579879570781\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to encode"
+msgid "<emph>inputstr</emph>: The string to encode."
msgstr ""
#. jpv97
@@ -19187,22 +19421,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the input string is a valid date according to a specified date format."
msgstr ""
-#. rhVGc
+#. tBGBH
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id151579881091821\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>"
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>"
msgstr ""
-#. J4E4L
+#. nmTv3
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id991579881107670\n"
"help.text"
-msgid "<emph>DateFormat</emph>: The date format, as a string. It can be either \"YYYY-MM-DD\" (default), \"DD-MM-YYYY\" or \"MM-DD-YYYY\""
+msgid "<emph>dateformat</emph>: The date format, as a string. It can be either \"YYYY-MM-DD\" (default), \"DD-MM-YYYY\" or \"MM-DD-YYYY\""
msgstr ""
#. GvZLC
@@ -19259,13 +19493,13 @@ msgctxt ""
msgid "Alphabetic characters are those characters defined in the <link href=\"https://unicode.org/reports/tr44/\" name=\"Unicode documentation\">Unicode Character Database</link> as <literal>Letter</literal>."
msgstr ""
-#. VMZud
+#. a9rTa
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id11579881691826\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. KaLGv
@@ -19277,13 +19511,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are alphabetic, digits or \"_\" (underscore). The first character must not be a digit."
msgstr ""
-#. LLCAz
+#. BAEB4
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id31579884464101\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. qAZpA
@@ -19295,13 +19529,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are Ascii characters."
msgstr ""
-#. AR4hr
+#. 3DNou
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id791580039528838\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. iuPF4
@@ -19313,13 +19547,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are digits."
msgstr ""
-#. njKib
+#. yU7cc
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id41580044873043\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. J8Ykx
@@ -19331,13 +19565,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the string is a valid email address."
msgstr ""
-#. DFTVq
+#. 8Pxsn
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id841580045280071\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. R6MsU
@@ -19349,22 +19583,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the string is a valid filename in a given operating system."
msgstr ""
-#. VEp6E
+#. aQbRF
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id801580047079938\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
-#. j3yDJ
+#. jWMpJ
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id781580047088954\n"
"help.text"
-msgid "<emph>OSName</emph>: The operating system name, as a string. It can be WINDOWS, LINUX, MACOSX or SOLARIS."
+msgid "<emph>osname</emph>: The operating system name, as a string. It can be \"WINDOWS\", \"LINUX\", \"MACOSX\" or \"SOLARIS\"."
msgstr ""
#. GnrxA
@@ -19385,13 +19619,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are hexadecimal digits."
msgstr ""
-#. WqaBe
+#. hWqAh
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id331580047594144\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. kEz4y
@@ -19412,13 +19646,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the string is a valid International Bank Account Number (IBAN). The comparison is not case-sensitive."
msgstr ""
-#. JZERm
+#. DnC6i
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id951880048466565\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. VgT3x
@@ -19439,13 +19673,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the string is a valid IP(v4) address."
msgstr ""
-#. m9byA
+#. rMpXB
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id981580048466565\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. yWHew
@@ -19457,22 +19691,22 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the whole input string matches a given pattern containing wildcards."
msgstr ""
-#. GDhnV
+#. PzigS
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id141580049142548\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
-#. DnQC9
+#. XEBzh
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id31580049154551\n"
"help.text"
-msgid "<emph>Pattern</emph>: The pattern as a string. Wildcard are:"
+msgid "<emph>pattern</emph>: The pattern as a string. Wildcards are:"
msgstr ""
#. ZCzDP
@@ -19493,13 +19727,13 @@ msgctxt ""
msgid "\"*\" represents zero, one, or multiple characters."
msgstr ""
-#. CntsV
+#. eLYBF
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id991580049206617\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. kSMmn
@@ -19529,13 +19763,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are printable."
msgstr ""
-#. XjiTs
+#. gUhut
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id721580051706431\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. HYBp5
@@ -19547,31 +19781,31 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the whole input string matches a given regular expression."
msgstr ""
-#. eaFWB
+#. ZuBxC
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id161580052454770\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
-#. AVFYQ
+#. mi4mi
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id581580052467973\n"
"help.text"
-msgid "<emph>Regex</emph>: The regular expression. If empty, the method returns <literal>False</literal>."
+msgid "<emph>regex</emph>: The regular expression. If empty, the method returns <literal>False</literal>."
msgstr ""
-#. FvYsk
+#. vmqZM
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id621580052654341\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. iZSEw
@@ -19583,13 +19817,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the input string is a valid Calc sheet name."
msgstr ""
-#. oFBzi
+#. xPFLm
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id671589460240552\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. uE5gz
@@ -19610,13 +19844,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the first character of every word is in uppercase and the other characters are in lowercase."
msgstr ""
-#. iiBCT
+#. uVF9U
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id471580293142283\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. 7Ryzp
@@ -19628,13 +19862,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are in uppercase. Non alphabetic characters are ignored."
msgstr ""
-#. N7DBZ
+#. HFDCW
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id391580128736809\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. BTRpG
@@ -19646,13 +19880,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if the string is a valid absolute URL (Uniform Resource Locator) address. Only the http, https and ftp protocols are supported."
msgstr ""
-#. NdBfD
+#. HrFqG
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id321580132113593\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. wBAqG
@@ -19664,13 +19898,13 @@ msgctxt ""
msgid "Returns <literal>True</literal> if all characters in the string are whitespaces"
msgstr ""
-#. DRDP8
+#. JDD85
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id801580132535511\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
+msgid "<emph>inputstr</emph>: The string to be checked. If empty, the method returns <literal>False</literal>."
msgstr ""
#. 7EBbA
@@ -19682,31 +19916,31 @@ msgctxt ""
msgid "Returns the input string center-justified."
msgstr ""
-#. ycGFR
+#. TLmnE
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id571612380829021\n"
"help.text"
-msgid "The leading and trailing white spaces are stripped and the remaining characters are completed left and right up to a specified total <literal>Length</literal> with the character <literal>Padding</literal>."
+msgid "The leading and trailing white spaces are stripped and the remaining characters are completed left and right up to a specified total <literal>length</literal> with the character <literal>padding</literal>."
msgstr ""
-#. 9aW5U
+#. 4uuQT
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id911580133391827\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be center-justified. If empty, the method returns an empty string."
+msgid "<emph>inputstr</emph>: The string to be center-justified. If empty, the method returns an empty string."
msgstr ""
-#. RXgZr
+#. jHJNT
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id671580133694946\n"
"help.text"
-msgid "<emph>Length</emph>: The length of the resulting string (default = the length of the input string)."
+msgid "<emph>length</emph>: The length of the resulting string (default = the length of the input string)."
msgstr ""
#. A3qof
@@ -19718,13 +19952,13 @@ msgctxt ""
msgid "If the specified length is shorter than the center-justified input string, then the returned string is truncated."
msgstr ""
-#. LEKsf
+#. fys4j
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id101580133705268\n"
"help.text"
-msgid "<emph>Padding</emph>: The single character to be used as padding (default = the Ascii space \" \")."
+msgid "<emph>padding</emph>: The single character to be used as padding (default = the Ascii space \" \")."
msgstr ""
#. 4zk3p
@@ -19736,31 +19970,31 @@ msgctxt ""
msgid "Returns the input string left-justified."
msgstr ""
-#. GbAcR
+#. 9KeCE
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id431612381917641\n"
"help.text"
-msgid "The leading white spaces are stripped and the remaining characters are completed to the right up to a specified total <literal>Length</literal> with the character <literal>Padding</literal>."
+msgid "The leading white spaces are stripped and the remaining characters are completed to the right up to a specified total <literal>length</literal> with the character <literal>padding</literal>."
msgstr ""
-#. rPfqE
+#. UQXSM
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id281580135523448\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be left-justified. If empty, the method returns an empty string."
+msgid "<emph>inputstr</emph>: The string to be left-justified. If empty, the method returns an empty string."
msgstr ""
-#. tUCdj
+#. EAwAa
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id431580135534910\n"
"help.text"
-msgid "<emph>Length</emph>: The length of the resulting string (default = the length of the input string)."
+msgid "<emph>length</emph>: The length of the resulting string (default = the length of the input string)."
msgstr ""
#. ntKXx
@@ -19772,13 +20006,13 @@ msgctxt ""
msgid "If the specified length is shorter than the left-justified input string, then the returned string is truncated."
msgstr ""
-#. BrEAS
+#. wBnmv
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id221580135568475\n"
"help.text"
-msgid "<emph>Padding</emph>: The single character to be used as padding (default = the Ascii space \" \")."
+msgid "<emph>padding</emph>: The single character to be used as padding (default = the Ascii space \" \")."
msgstr ""
#. TTokb
@@ -19790,31 +20024,31 @@ msgctxt ""
msgid "Returns the input string right-justified."
msgstr ""
-#. PPcZT
+#. 4fG7c
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id771612382000293\n"
"help.text"
-msgid "The leading white spaces are stripped and the remaining characters are completed to the left up to a specified total <literal>Length</literal> with the character <literal>Padding</literal>."
+msgid "The leading white spaces are stripped and the remaining characters are completed to the left up to a specified total <literal>length</literal> with the character <literal>padding</literal>."
msgstr ""
-#. MzFoN
+#. KxskT
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id201580136154170\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be right-justified. If empty, the method returns an empty string."
+msgid "<emph>inputstr</emph>: The string to be right-justified. If empty, the method returns an empty string."
msgstr ""
-#. uM4Xm
+#. FboQc
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id71580136164632\n"
"help.text"
-msgid "<emph>Length</emph>: The length of the resulting string (default = the length of the input string)."
+msgid "<emph>length</emph>: The length of the resulting string (default = the length of the input string)."
msgstr ""
#. dshKE
@@ -19826,13 +20060,13 @@ msgctxt ""
msgid "If the specified length is shorter than the right-justified input string, then the returned string is truncated."
msgstr ""
-#. f9BKD
+#. LtcVG
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id751580136200680\n"
"help.text"
-msgid "<emph>Padding</emph>: The single character to be used as padding (default = the Ascii space \" \")."
+msgid "<emph>padding</emph>: The single character to be used as padding (default = the Ascii space \" \")."
msgstr ""
#. Wn55u
@@ -19844,22 +20078,22 @@ msgctxt ""
msgid "Returns the input string enclosed in single or double quotes. Existing quotes are left unchanged, including leading and/or trailing quotes."
msgstr ""
-#. 6VRqZ
+#. YBvt4
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id811580136944674\n"
"help.text"
-msgid "<emph>InputStr</emph>: the string to quote."
+msgid "<emph>inputstr</emph>: The string to quote."
msgstr ""
-#. T8fPe
+#. GynWV
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id581599129397412\n"
"help.text"
-msgid "<emph>QuoteChar</emph> : Either the single (') or (default) double (\") quote."
+msgid "<emph>quotechar</emph>: Either the single (') or double (\") quote (default)."
msgstr ""
#. fY3PC
@@ -19889,31 +20123,31 @@ msgctxt ""
msgid "If the length of <literal>Before</literal> is greater than the length of <literal>After</literal>, the residual characters in <literal>Before</literal> are replaced by the last character in <literal>After</literal>."
msgstr ""
-#. 949cN
+#. DD2CL
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id11580139160633\n"
"help.text"
-msgid "<emph>InputStr</emph>: The input string on which replacements will occur."
+msgid "<emph>inputstr</emph>: The input string on which replacements will occur."
msgstr ""
-#. DfiCN
+#. DvaRE
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id111580139169795\n"
"help.text"
-msgid "<emph>Before</emph>: A string with the characters that will be searched in the input string for replacement."
+msgid "<emph>before</emph>: A string with the characters that will be searched in the input string for replacement."
msgstr ""
-#. jCz7k
+#. N46b3
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id851580139182113\n"
"help.text"
-msgid "<emph>After</emph>: A string with the new characters that will replace those defined in <literal>Before</literal>."
+msgid "<emph>after</emph>: A string with the new characters that will replace those defined in <literal>before</literal>."
msgstr ""
#. CDuCC
@@ -19943,40 +20177,40 @@ msgctxt ""
msgid "Replaces all occurrences of a given regular expression by a new string."
msgstr ""
-#. yT3Qw
+#. ujCyu
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id471580140311626\n"
"help.text"
-msgid "<emph>InputStr</emph>: The input string on which replacements will occur."
+msgid "<emph>inputstr</emph>: The input string on which replacements will occur."
msgstr ""
-#. hW8Q6
+#. o2DS2
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id651580140322666\n"
"help.text"
-msgid "<emph>Regex</emph>: The regular expression."
+msgid "<emph>regex</emph>: The regular expression."
msgstr ""
-#. Do29t
+#. itEEd
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id891580140334754\n"
"help.text"
-msgid "<emph>NewStr</emph>: The replacing string."
+msgid "<emph>newstr</emph>: The replacing string."
msgstr ""
-#. MwRMp
+#. gJRAr
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id581580140345221\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. ykPVR
@@ -20006,85 +20240,85 @@ msgctxt ""
msgid "Replaces in a string some or all occurrences of an array of strings by an array of new strings."
msgstr ""
-#. W4yEv
+#. SDpot
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id831580146504326\n"
"help.text"
-msgid "<emph>InputStr</emph>: The input string on which replacements will occur."
+msgid "<emph>inputstr</emph>: The input string on which replacements will occur."
msgstr ""
-#. ik56f
+#. UfuEm
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id411580146514927\n"
"help.text"
-msgid "<emph>OldStr</emph>: A single string or an array of strings. Zero-length strings are ignored."
+msgid "<emph>oldstr</emph>: A single string or an array of strings. Zero-length strings are ignored."
msgstr ""
-#. pRZAd
+#. Ukr3F
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id591580146532966\n"
"help.text"
-msgid "<emph>NewStr</emph>: The replacing string or the array of replacing strings."
+msgid "<emph>newstr</emph>: The replacing string or the array of replacing strings."
msgstr ""
-#. 97Cuk
+#. 7BQ7F
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id611612384873347\n"
"help.text"
-msgid "If <literal>OldStr</literal> is an array, each occurrence of any of the items in <literal>OldStr</literal> is replaced by <literal>NewStr</literal>."
+msgid "If <literal>oldstr</literal> is an array, each occurrence of any of the items in <literal>oldstr</literal> is replaced by <literal>newstr</literal>."
msgstr ""
-#. jLs7f
+#. AfRz6
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id611612384880820\n"
"help.text"
-msgid "If <literal>OldStr</literal> and <literal>NewStr</literal> are arrays, replacements occur one by one up to the <literal>UBound(NewStr)</literal>."
+msgid "If <literal>oldstr</literal> and <literal>newstr</literal> are arrays, replacements occur one by one up to the <literal>UBound(newstr)</literal>."
msgstr ""
-#. qUhcr
+#. E39aH
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id241612385058264\n"
"help.text"
-msgid "If <literal>OldStr</literal> has more entries than <literal>NewStr</literal>, then the residual elements in <literal>OldStr</literal> are replaced by the last element in <literal>NewStr</literal>."
+msgid "If <literal>oldstr</literal> has more entries than <literal>newstr</literal>, then the residual elements in <literal>oldstr</literal> are replaced by the last element in <literal>newstr</literal>."
msgstr ""
-#. oTqRh
+#. MkqW5
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id701580146547619\n"
"help.text"
-msgid "<emph>Occurrences</emph>: The maximum number of replacements. The default value is 0, meaning that all occurrences will be replaced."
+msgid "<emph>occurrences</emph>: The maximum number of replacements. The default value is 0, meaning that all occurrences will be replaced."
msgstr ""
-#. eigiB
+#. QX33p
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id741612385380533\n"
"help.text"
-msgid "When <literal>OldStr</literal> is an array, the <literal>Occurrence</literal> parameter is computed separately for each item in the array."
+msgid "When <literal>oldstr</literal> is an array, the <literal>occurrence</literal> parameter is computed separately for each item in the array."
msgstr ""
-#. EUziv
+#. aWrvA
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id301580146556599\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. eygyi
@@ -20096,13 +20330,13 @@ msgctxt ""
msgid "Returns a string with a readable representation of the argument, truncated at a given length. This is useful mainly for debugging or logging purposes."
msgstr ""
-#. jNrC5
+#. cU3Ev
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id11612386054691\n"
"help.text"
-msgid "If the <literal>AnyValue</literal> parameter is an object, it will be enclosed with square brackets \"[\" and \"]\"."
+msgid "If the <literal>anyvalue</literal> parameter is an object, it will be enclosed with square brackets \"[\" and \"]\"."
msgstr ""
#. gVB32
@@ -20114,31 +20348,31 @@ msgctxt ""
msgid "In strings, tabs and line breaks are replaced by \\t, \\n or \\r."
msgstr ""
-#. vnB48
+#. SfUGD
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id921612386089103\n"
"help.text"
-msgid "If the final length exceeds the <literal>MaxLength</literal> parameter, the latter part of the string is replaced by \" ... (N)\" where N is the total length of the original string before truncation."
+msgid "If the final length exceeds the <literal>maxlength</literal> parameter, the latter part of the string is replaced by \" ... (N)\" where N is the total length of the original string before truncation."
msgstr ""
-#. ukVSq
+#. zLfNR
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id91580147593626\n"
"help.text"
-msgid "<emph>AnyValue</emph>: The input value to be represented. It can be any value, such as a string, an array, a Basic object, a UNO object, etc."
+msgid "<emph>anyvalue</emph>: The input value to be represented. It can be any value, such as a string, an array, a Basic object, a UNO object, etc."
msgstr ""
-#. Gp3Gk
+#. hdDFi
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id811580147609322\n"
"help.text"
-msgid "<emph>MaxLength</emph>: The maximum length of the resulting string. The default value is 0, meaning there is no limit to the length of the resulting representation."
+msgid "<emph>maxlength</emph>: The maximum length of the resulting string. The default value is 0, meaning there is no limit to the length of the resulting representation."
msgstr ""
#. Ape7i
@@ -20186,31 +20420,31 @@ msgctxt ""
msgid "Returns the input string in reversed order."
msgstr ""
-#. 5PtEv
+#. EEyG6
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id141612387177873\n"
"help.text"
-msgid "This method is equivalent to the built-in <link href=\"text/sbasic/shared/03120412.xhp\" name=\"StrReverse function\"><literal>StrReverse</literal> Basic function</link>, however with better performance."
+msgid "This method is equivalent to the built-in <link href=\"text/sbasic/shared/03120412.xhp\" name=\"StrReverse function\"><literal>StrReverse</literal> Basic function</link>."
msgstr ""
-#. CjFDm
+#. ZEarP
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id961612387463144\n"
"help.text"
-msgid "To use the <literal>StrReverse</literal> function, the statement <literal>OpTion VBASupport 1</literal> must be present in the module."
+msgid "To use the <literal>StrReverse</literal> function, the statement <literal>Option VBASupport 1</literal> must be present in the module."
msgstr ""
-#. ScghL
+#. pSyL6
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id241580312964497\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be reversed."
+msgid "<emph>inputstr</emph>: The string to be reversed."
msgstr ""
#. KBFDk
@@ -20222,22 +20456,22 @@ msgctxt ""
msgid "Returns a zero-based array of strings with the lines in the input string. Each item in the array is obtained by splitting the input string at newline characters."
msgstr ""
-#. RRtva
+#. nuUF6
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id481580210806878\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be split."
+msgid "<emph>inputstr</emph>: The string to be split."
msgstr ""
-#. UAkXJ
+#. FEFUw
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id231580210820309\n"
"help.text"
-msgid "<emph>KeepBreaks</emph>: When <literal>True</literal>, line breaks are preserved in the output array (default = <literal>False</literal>)."
+msgid "<emph>keepbreaks</emph>: When <literal>True</literal>, line breaks are preserved in the output array (default = <literal>False</literal>)."
msgstr ""
#. HAG8Q
@@ -20258,40 +20492,49 @@ msgctxt ""
msgid "If a quoted substring contains a delimiter, it is ignored. This is useful when parsing CSV-like records that contain quoted strings."
msgstr ""
-#. mw9Lu
+#. JKAaG
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id881580211809490\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be split."
+msgid "<emph>inputstr</emph>: The string to be split."
msgstr ""
-#. sYE2m
+#. zFjwe
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id811580211821162\n"
"help.text"
-msgid "<emph>Delimiter</emph>: A string of one or more characters that will be used as delimiter. The default delimiter is the space character."
+msgid "<emph>delimiter</emph>: A string of one or more characters that will be used as delimiter. The default delimiter is the Ascii space \" \" character."
msgstr ""
-#. NBsXC
+#. 3rGRu
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id181580211833778\n"
"help.text"
-msgid "<emph>Occurrences</emph>: The maximum number of substrings to return. The default value is 0, meaning that there is no limit to the number of returned strings."
+msgid "<emph>occurrences</emph>: The maximum number of substrings to return. The default value is 0, meaning that there is no limit to the number of returned strings."
msgstr ""
-#. dzzmh
+#. W2og7
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id421599123777334\n"
"help.text"
-msgid "<emph>QuoteChar</emph> : Either the single (') or double (\") quote."
+msgid "<emph>quotechar</emph>: Either the single (') or double (\") quote."
+msgstr ""
+
+#. S63t6
+#: sf_string.xhp
+msgctxt ""
+"sf_string.xhp\n"
+"par_id661627251379676\n"
+"help.text"
+msgid "Beware of the differences between Basic and Python when representing strings. For example, in Basic two \"\" characters inside a string are interpreted as a single \" character. In Python, strings enclosed with single quotes can contain \" characters without having to double them."
msgstr ""
#. 6Q2tJ
@@ -20312,31 +20555,31 @@ msgctxt ""
msgid "This method returns <literal>False</literal> if either the input string or the substring have a length = 0 or when the substring is longer than the input string."
msgstr ""
-#. rmutH
+#. jrzxu
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id271580212876135\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be tested."
+msgid "<emph>inputstr</emph>: The string to be tested."
msgstr ""
-#. 2wa7W
+#. tE9WD
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id571580212889462\n"
"help.text"
-msgid "<emph>Substring</emph>: The substring to be searched at the start of <literal>InputStr</literal>."
+msgid "<emph>substring</emph>: The substring to be searched at the start of <literal>inputstr</literal>."
msgstr ""
-#. HAFmq
+#. ZeQP4
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id811580212900799\n"
"help.text"
-msgid "<emph>CaseSensitive</emph>: Default = <literal>False</literal>."
+msgid "<emph>casesensitive</emph>: The search can be case sensitive or not (Default = <literal>False</literal>)."
msgstr ""
#. DGgBx
@@ -20348,13 +20591,13 @@ msgctxt ""
msgid "Returns the input string without its leading and trailing whitespaces."
msgstr ""
-#. ekDEE
+#. BESEu
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id541580296044377\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to trimmed."
+msgid "<emph>inputstr</emph>: The string to trim."
msgstr ""
#. 9t9vX
@@ -20366,13 +20609,13 @@ msgctxt ""
msgid "Converts any escaped sequence (\\\\, \\n, \\r, \\t) in the input string to their corresponding Ascii character."
msgstr ""
-#. J7Fpn
+#. mzTsG
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id971580483124743\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to be converted."
+msgid "<emph>inputstr</emph>: The string to be converted."
msgstr ""
#. BoYHV
@@ -20393,40 +20636,49 @@ msgctxt ""
msgid "This is useful when parsing CSV-like records that contain quoted strings."
msgstr ""
-#. GrBsF
+#. BhVvp
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id761580213677493\n"
"help.text"
-msgid "<emph>InputStr</emph> : The string to unquote."
+msgid "<emph>inputstr</emph>: The string to unquote."
msgstr ""
-#. GYKCt
+#. gRUHA
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id211599129509890\n"
"help.text"
-msgid "<emph>QuoteChar</emph> : Either the single (') or double (\") quote (default)."
+msgid "<emph>quotechar</emph>: Either the single (') or double (\") quote (default)."
msgstr ""
-#. G368s
+#. nGq4Q
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
-"bas_id981580213799125\n"
+"bas_id371580213702598\n"
"help.text"
-msgid "s = SF_String.Unquote(\"\"\"Some text\"\"\") ' s = \"Some text\" (without enclosing quotes)"
+msgid "' s = \"Some text\" (without enclosing quotes)"
msgstr ""
-#. kyuNy
+#. Fp8ip
+#: sf_string.xhp
+msgctxt ""
+"sf_string.xhp\n"
+"bas_id51580213693694\n"
+"help.text"
+msgid "' The string below does not have enclosing quotes, so it remains unchanged"
+msgstr ""
+
+#. A4Eki
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"bas_id961612393917830\n"
"help.text"
-msgid "s = SF_String.Unquote(\"Some text\") ' s = \"Some text\" (unchanged)"
+msgid "' s = \"Some text\" (unchanged)"
msgstr ""
#. ULtxx
@@ -20438,6 +20690,15 @@ msgctxt ""
msgid "' Quotes inside the string are not removed"
msgstr ""
+#. 8w4ia
+#: sf_string.xhp
+msgctxt ""
+"sf_string.xhp\n"
+"bas_id961612394171208\n"
+"help.text"
+msgid "' s = \"The \"\"true\"\" meaning\" (unchanged)"
+msgstr ""
+
#. JGhWK
#: sf_string.xhp
msgctxt ""
@@ -20483,40 +20744,31 @@ msgctxt ""
msgid "If the wrapped output has no content, the returned array is empty."
msgstr ""
-#. J73yb
+#. SNRzH
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id251585834468498\n"
"help.text"
-msgid "<emph>InputStr</emph>: The string to wrap."
+msgid "<emph>inputstr</emph>: The string to wrap."
msgstr ""
-#. 5iowq
+#. MiptC
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id351585834773177\n"
"help.text"
-msgid "<emph>Width</emph> : The maximum number of characters in each line (default = 70)."
+msgid "<emph>width</emph>: The maximum number of characters in each line (Default = 70)."
msgstr ""
-#. GhpV4
+#. epG6z
#: sf_string.xhp
msgctxt ""
"sf_string.xhp\n"
"par_id741585834874500\n"
"help.text"
-msgid "<emph>TabSize</emph> : Before wrapping the text, the existing TAB <literal>Chr(9)</literal> characters are replaced with spaces. TabSize defines the TAB stops at TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (default = 8)."
-msgstr ""
-
-#. xDXfd
-#: sf_string.xhp
-msgctxt ""
-"sf_string.xhp\n"
-"par_id271612398715438\n"
-"help.text"
-msgid "<link href=\"text/sbasic/shared/03120202.xhp\" name=\"String function\">String built-in function</link>"
+msgid "<emph>tabsize</emph>: Before wrapping the text, the existing TAB <literal>Chr(9)</literal> characters are replaced with spaces. The argument <literal>tabsize</literal> defines the TAB stops at TabSize + 1, 2 * TabSize + 1 , ... N * TabSize + 1 (Default = 8)."
msgstr ""
#. HjZDB
@@ -20582,22 +20834,22 @@ msgctxt ""
msgid "All operations needed to read from or write to a file (open, read/write and close) are presumed to happen during the same macro run."
msgstr ""
-#. U6RHd
+#. dc5KN
#: sf_textstream.xhp
msgctxt ""
"sf_textstream.xhp\n"
"hd_id83158533078741\n"
"help.text"
-msgid "Service instantiation"
+msgid "Service invocation"
msgstr ""
-#. c7WYC
+#. AuQX2
#: sf_textstream.xhp
msgctxt ""
"sf_textstream.xhp\n"
"par_id351613598192725\n"
"help.text"
-msgid "The code snippet below uses the <literal>OpenTextFile</literal> method to create an instance of the <literal>TextStream</literal> Service."
+msgid "The examples below in Basic and Python use the <literal>OpenTextFile</literal> method to create an instance of the <literal>TextStream</literal> Service."
msgstr ""
#. UUudg
@@ -20843,13 +21095,13 @@ msgctxt ""
msgid "Consider the text file \"Students.txt\" with the following contents (a name in each line):"
msgstr ""
-#. dUSey
+#. hk7q4
#: sf_textstream.xhp
msgctxt ""
"sf_textstream.xhp\n"
"par_id391613596019750\n"
"help.text"
-msgid "The example below uses the <literal>ReadAll</literal> and <literal>SplitLines</literal> methods to read the contents of the file into an array of strings:"
+msgid "The examples below in Basic and Python use the <literal>ReadAll</literal> and <literal>SplitLines</literal> methods to read the contents of the file into an array of strings:"
msgstr ""
#. BuRJE
@@ -20924,13 +21176,13 @@ msgctxt ""
msgid "Writes a specified number of empty lines to the output stream."
msgstr ""
-#. NqNwE
+#. YsBUm
#: sf_textstream.xhp
msgctxt ""
"sf_textstream.xhp\n"
"par_id291585330787357\n"
"help.text"
-msgid "<emph>Lines</emph>: The number of empty lines to write."
+msgid "<emph>lines</emph>: The number of empty lines to write to the file."
msgstr ""
#. GCPCC
@@ -20951,13 +21203,22 @@ msgctxt ""
msgid "The character defined in the <literal>NewLine</literal> property is used as the line delimiter."
msgstr ""
-#. YRTuQ
+#. LXFPE
#: sf_textstream.xhp
msgctxt ""
"sf_textstream.xhp\n"
"par_id491585330787650\n"
"help.text"
-msgid "<emph>Line</emph>: The line to write, may be empty."
+msgid "<emph>line</emph>: The line to write, may be empty."
+msgstr ""
+
+#. PM5Bx
+#: sf_textstream.xhp
+msgctxt ""
+"sf_textstream.xhp\n"
+"par_id821626894480105\n"
+"help.text"
+msgid "The examples below in Basic and Python create a text file in CSV format in which each line contains a value and its square until <literal>lastValue</literal> is reached."
msgstr ""
#. 39u4o
@@ -21005,24 +21266,6 @@ msgctxt ""
msgid "'Closes the file and free resources"
msgstr ""
-#. nrDCn
-#: sf_textstream.xhp
-msgctxt ""
-"sf_textstream.xhp\n"
-"par_id301613075694148\n"
-"help.text"
-msgid "<link href=\"text/sbasic/shared/03160000.xhp\" name=\"Input function\">Input Function</link>"
-msgstr ""
-
-#. FnNRc
-#: sf_textstream.xhp
-msgctxt ""
-"sf_textstream.xhp\n"
-"par_id271612398715438\n"
-"help.text"
-msgid "<link href=\"text/sbasic/shared/03020103.xhp\" name=\"Open statement\">Open Statement</link>"
-msgstr ""
-
#. PCSPY
#: sf_timer.xhp
msgctxt ""
@@ -21113,15 +21356,6 @@ msgctxt ""
msgid "Service invocation"
msgstr ""
-#. 8ntzF
-#: sf_timer.xhp
-msgctxt ""
-"sf_timer.xhp\n"
-"par_id141610734722352\n"
-"help.text"
-msgid "Before using the <literal>Timer</literal> service the <literal>ScriptForge</literal> library needs to be loaded using:"
-msgstr ""
-
#. SCYEX
#: sf_timer.xhp
msgctxt ""
@@ -21419,6 +21653,15 @@ msgctxt ""
msgid "<literal>False</literal> if the timer is neither started nor suspended"
msgstr ""
+#. DuD3h
+#: sf_timer.xhp
+msgctxt ""
+"sf_timer.xhp\n"
+"par_id731626871820490\n"
+"help.text"
+msgid "The examples below in Basic and Python illustrate the use of the methods and properties in the <literal>Timer</literal> service."
+msgstr ""
+
#. UgBnC
#: sf_timer.xhp
msgctxt ""
@@ -21455,6 +21698,15 @@ msgctxt ""
msgid "If you call the <literal>Terminate</literal> method, subsequent calls for the <literal>Continue</literal> method will not resume time measurement. Similarly, after a Timer has been terminated, calling the <literal>Start</literal> method will restart it as if it were a clean new Timer."
msgstr ""
+#. DSYKj
+#: sf_timer.xhp
+msgctxt ""
+"sf_timer.xhp\n"
+"par_id391626872019832\n"
+"help.text"
+msgid "Beware that the <literal>Wait</literal> function in Basic takes in a duration argument in milliseconds whereas the <literal>sleep</literal> function in Python uses seconds in its argument."
+msgstr ""
+
#. bHEyr
#: sf_timer.xhp
msgctxt ""
@@ -21509,24 +21761,6 @@ msgctxt ""
msgid "'Terminate both timers"
msgstr ""
-#. CpzL5
-#: sf_timer.xhp
-msgctxt ""
-"sf_timer.xhp\n"
-"par_id531610970649205\n"
-"help.text"
-msgid "<link href=\"text/sbasic/shared/03030203.xhp#now\">Now function</link>"
-msgstr ""
-
-#. iuTvZ
-#: sf_timer.xhp
-msgctxt ""
-"sf_timer.xhp\n"
-"par_id221610970653662\n"
-"help.text"
-msgid "<link href=\"text/sbasic/shared/03030303.xhp#timer\">Timer function</link>"
-msgstr ""
-
#. dphFv
#: sf_ui.xhp
msgctxt ""
@@ -21941,13 +22175,13 @@ msgctxt ""
msgid "<emph>filename</emph> : Identifies the file to create. It must follow the <literal>SF_FileSystem.FileNaming</literal> notation. If the file already exists, it is overwritten without warning"
msgstr ""
-#. ncJxE
+#. Jub7D
#: sf_ui.xhp
msgctxt ""
"sf_ui.xhp\n"
"par_id381596554849698\n"
"help.text"
-msgid "<emph>embeddeddatabase</emph> : Either \"HSQLDB\" (default) or \"FIREBIRD\"."
+msgid "<emph>embeddeddatabase</emph> : Either \"HSQLDB\" (default), \"FIREBIRD\" or \"CALC\"."
msgstr ""
#. BWgpN
@@ -21959,6 +22193,15 @@ msgctxt ""
msgid "<emph>registrationname</emph> : The name used to store the new database in the databases register. When = \"\" (default), no registration takes place. If the name already exists it is overwritten without warning."
msgstr ""
+#. AFin6
+#: sf_ui.xhp
+msgctxt ""
+"sf_ui.xhp\n"
+"par_id181629364905056\n"
+"help.text"
+msgid "<emph>calcfilename</emph> : Only when <literal>embeddeddatabase</literal> = \"CALC\", <literal>calcfilename</literal> represents the file containing the tables as Calc sheets. The file must exist or an error is raised."
+msgstr ""
+
#. GtB5n
#: sf_ui.xhp
msgctxt ""
@@ -22004,22 +22247,22 @@ msgctxt ""
msgid "In both examples below, the first call to <literal>CreateDocument</literal> method creates a blank Calc document, whereas the second creates a document from a template file."
msgstr ""
-#. W3qxn
+#. TxY93
#: sf_ui.xhp
msgctxt ""
"sf_ui.xhp\n"
"par_id201588520551463\n"
"help.text"
-msgid "Returns a document object referring to either the active window or the given window."
+msgid "Returns a document object referring to either the active window, a given window or the active document."
msgstr ""
-#. hZmVw
+#. xgMAv
#: sf_ui.xhp
msgctxt ""
"sf_ui.xhp\n"
"par_id851588520551368\n"
"help.text"
-msgid "<emph>windowname</emph>: See the definitions <link href=\"text/sbasic/shared/03/sf_ui.xhp#WindowName\" name=\"WindowName section\">above</link>. If this argument is absent, the active window is used."
+msgid "<emph>windowname</emph>: See the definitions <link href=\"text/sbasic/shared/03/sf_ui.xhp#WindowName\" name=\"WindowName section\">above</link>. If this argument is absent, the active window is used. UNO objects of types <literal>com.sun.star.lang.XComponent</literal> or <literal>com.sun.star.comp.dba.ODatabaseDocument</literal> are also accepted. Thus passing <literal>ThisComponent</literal> or <literal>ThisDatabaseDocument</literal> as argument creates a new <link href=\"text/sbasic/shared/03/sf_document.xhp\" name=\"Document service\">SFDocuments.Document</link>, <link href=\"text/sbasic/shared/03/sf_base.xhp\" name=\"Base service\">Base</link> or <link href=\"text/sbasic/shared/03/sf_calc.xhp\" name=\"Calc service\">Calc</link> service."
msgstr ""
#. AAjDB