tdf#141474 Asc, AscW function signatures

Change-Id: Ia85bf08bb1e5cb0e7db5717caec01e7e50c3b106
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/124853
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>

4 files changed, 37 insertions, 35 deletions

diff --git a/source/text/sbasic/shared/03120101.xhp b/source/text/sbasic/shared/03120101.xhp
index d5e7a7eaf0..f2f403e088 100644
--- a/source/text/sbasic/shared/03120101.xhp
+++ b/source/text/sbasic/shared/03120101.xhp
@@ -33,36 +33,37 @@
   <bookmark_value>Asc function</bookmark_value>
 </bookmark>
 
-
-<paragraph id="hd_id3150499" role="heading" level="1" xml-lang="en-US"><link href="text/sbasic/shared/03120101.xhp" name="Asc Function">Asc Function</link></paragraph>
-<paragraph id="par_id3151384" role="paragraph" xml-lang="en-US">Returns the ASCII (American Standard Code for Information Interchange) value of the first character in a string expression.</paragraph>
+<h1 id="hd_id3150499"><variable id="Asc_h1"><link href="text/sbasic/shared/03120101.xhp" name="Asc Function">Asc Function</link></variable></h1>
+<paragraph id="par_id3151384" role="paragraph">Returns the ASCII (American Standard Code for Information Interchange) value of the first character in a string expression.</paragraph>
 </section>
 
-<paragraph id="hd_id3155555" role="heading" level="2" xml-lang="en-US">Syntax:</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
 <bascode>
-<paragraph id="par_id3143267" role="bascode" xml-lang="en-US">Asc (Text As String)</paragraph>
+<paragraph id="par_id3143267" role="bascode" xml-lang="en-US">Asc(string) As Long</paragraph>
 </bascode>
 
-<paragraph id="hd_id3147242" role="heading" level="2" xml-lang="en-US">Return value:</paragraph>
-<paragraph id="par_id3150669" role="paragraph" xml-lang="en-US">Integer</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
+<paragraph id="par_id3150669" role="paragraph" xml-lang="en-US">Long</paragraph>
 
-<paragraph id="hd_id3148473" role="heading" level="2" xml-lang="en-US">Parameters:</paragraph>
-<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US"> <emph>Text:</emph> Any valid string expression. Only the first character in the string is relevant.</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
+<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US"><emph>string</emph>: Any valid string expression. Only the first character in the string is relevant.</paragraph>
 <paragraph id="par_id3145609" role="paragraph" xml-lang="en-US">Use the Asc function to replace keys with values. If the Asc function encounters a blank string, $[officename] Basic reports a run-time error. In addition to 7 bit ASCII characters (Codes 0-127), the ASCII function can also detect non-printable key codes in ASCII code. This function can also handle 16 bit unicode characters.</paragraph>
 <embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
 <embed href="text/sbasic/shared/00000003.xhp#err5"/>
 
-<paragraph id="hd_id3159413" role="heading" level="2" xml-lang="en-US">Example:</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functexample"/>
 <bascode>
 <paragraph id="par_idm1341586960" role="bascode" localize="false" xml-lang="en-US">Sub ExampleASC</paragraph>
 <paragraph id="par_id3150792" role="bascode" xml-lang="en-US">    Print ASC("A") ' returns 65</paragraph>
-<paragraph id="par_id3148797" role="bascode" xml-lang="en-US">    Print ASC("Z") ' returns 90</paragraph>
+<paragraph id="par_id3148797" role="bascode" xml-lang="en-US">    Print ASC(string:="Z") ' returns 90</paragraph>
 <paragraph id="par_id3163800" role="bascode" xml-lang="en-US">    Print ASC("Las Vegas") ' returns 76, since only the first character is taken into account</paragraph>
 <paragraph id="par_idm1341580480" role="bascode" localize="false" xml-lang="en-US">End Sub</paragraph>
 </bascode>
 
 <section id="relatedtopics">
-<paragraph id="par_idN1067B" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120102.xhp">CHR</link></paragraph>
+  <embed href="text/sbasic/shared/03120111.xhp#AscW_h1"/>
+  <embed href="text/sbasic/shared/03120102.xhp#Chr_h1"/>
+  <embed href="text/sbasic/shared/03120112.xhp#ChrW_h1"/>
 </section>
 </body>
 
diff --git a/source/text/sbasic/shared/03120102.xhp b/source/text/sbasic/shared/03120102.xhp
index a9d73261ef..5f3a8f3592 100644
--- a/source/text/sbasic/shared/03120102.xhp
+++ b/source/text/sbasic/shared/03120102.xhp
@@ -30,19 +30,18 @@
     <bookmark xml-lang="en-US" branch="index" id="bm_id3149205">
       <bookmark_value>Chr function</bookmark_value>
     </bookmark>
-    <paragraph id="hd_id3149205" role="heading" level="1" xml-lang="en-US"><link href="text/sbasic/shared/03120102.xhp" name="Chr Function">Chr Function</link></paragraph>
-    <paragraph id="par_id3153311" role="paragraph" xml-lang="en-US">Returns the character that corresponds to the specified character code.</paragraph>
+    <h1 id="hd_id3149205"><variable id="Chr_h1"><link href="text/sbasic/shared/03120102.xhp" name="Chr Function">Chr Function</link></variable></h1>
+    <paragraph id="par_id3153311" role="paragraph">Returns the character that corresponds to the specified character code.</paragraph>
   </section>
 
     <embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
-
-    <paragraph id="par_id3150669" role="code" xml-lang="en-US">Chr(Expression As Integer)</paragraph>
+    <paragraph id="par_id3150669" role="code" xml-lang="en-US">Chr[$](expression As Integer) As String</paragraph>
 
     <embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
     <paragraph id="par_id3153824" role="paragraph" xml-lang="en-US">String</paragraph>
 
     <embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
-    <paragraph id="par_id3149295" role="paragraph" xml-lang="en-US"> <emph>Expression:</emph> a numeric expression that represents a valid 8-bit ASCII value (0-255) or a 16-bit Unicode value. (To support expressions with a nominally negative argument like <emph>Chr(&amp;H8000)</emph> in a backwards-compatible way, values in the range −32768 to −1 are internally mapped to the range 32768 to 65535.)</paragraph>
+    <paragraph id="par_id3149295" role="paragraph" xml-lang="en-US"><emph>Expression:</emph> a numeric expression that represents a valid 8-bit ASCII value (0-255) or a 16-bit Unicode value. (To support expressions with a nominally negative argument like <emph>Chr(&amp;H8000)</emph> in a backwards-compatible way, values in the range −32768 to −1 are internally mapped to the range 32768 to 65535.)</paragraph>
 
     <warning id="par_id991552913928635">When VBA compatibility mode is enabled (<link href="text/sbasic/shared/03103350.xhp" name="vbasupport"><literal>OPTION VBASUPPORT 1</literal></link>), <emph>Expression</emph> is a numeric expression that represents a valid 8-bit ASCII value (0-255) only.</warning>
 
@@ -56,13 +55,15 @@
     <bascode>
         <paragraph id="par_idm1341138080" role="bascode" localize="false" xml-lang="en-US">Sub ExampleChr</paragraph>
         <paragraph id="par_id3154909" role="bascode" xml-lang="en-US">    ' This example inserts quotation marks (ASCII value 34) in a string.</paragraph>
-        <paragraph id="par_id3151380" role="bascode" xml-lang="en-US">    MsgBox "A "+ Chr$(34)+"short" + Chr$(34)+" trip."</paragraph>
+        <paragraph id="par_id3151380" role="bascode" xml-lang="en-US">    MsgBox "A "+ Chr$(34)+"short" + Chr(34)+" trip."</paragraph>
         <paragraph id="par_id3145174" role="bascode" xml-lang="en-US">    ' The printout appears in the dialog as: A "short" trip.</paragraph>
         <paragraph id="par_idm1341131568" role="bascode" localize="false" xml-lang="en-US">End Sub</paragraph>
     </bascode>
 
     <section id="relatedtopics">
-        <paragraph id="par_idN10668" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120101.xhp">ASC</link></paragraph>
+          <embed href="text/sbasic/shared/03120101.xhp#Asc_h1"/>
+          <embed href="text/sbasic/shared/03120111.xhp#AscW_h1"/>
+          <embed href="text/sbasic/shared/03120112.xhp#ChrW_h1"/>
     </section>
 </body>
 
diff --git a/source/text/sbasic/shared/03120111.xhp b/source/text/sbasic/shared/03120111.xhp
index 4ee05ef530..96d211f72f 100644
--- a/source/text/sbasic/shared/03120111.xhp
+++ b/source/text/sbasic/shared/03120111.xhp
@@ -34,18 +34,18 @@
 </bookmark>
 
 
-<paragraph id="hd_id3150499" role="heading" level="1" xml-lang="en-US"><link href="text/sbasic/shared/03120111.xhp" name="AscW Function [VBA]">AscW Function [VBA]</link></paragraph>
-<paragraph id="par_id3151384" role="paragraph" xml-lang="en-US">Returns the Unicode value of the first character in a string expression.</paragraph>
+<h1 id="hd_id3150499"><variable id="AscW_h1"><link href="text/sbasic/shared/03120111.xhp" name="AscW Function [VBA]">AscW Function [VBA]</link></variable></h1>
+<paragraph id="par_id3151384" role="paragraph">Returns the Unicode value of the first character in a string expression.</paragraph>
 </section>
 <embed href="text/sbasic/shared/00000003.xhp#vbasupport"/>
 <embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
 <bascode>
-<paragraph id="par_id3143267" role="bascode" localize="false" xml-lang="en-US">AscW (Text As String)</paragraph>
+<paragraph id="par_id3143267" role="bascode" localize="false" xml-lang="en-US">AscW (string) As Long</paragraph>
 </bascode>
 <embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
-<paragraph id="par_id3150669" role="paragraph" xml-lang="en-US">Integer</paragraph>
+<paragraph id="par_id3150669" role="paragraph" xml-lang="en-US">Long</paragraph>
 <embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
-<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US"> <emph>Text:</emph> Any valid string expression. Only the first character in the string is relevant.</paragraph>
+<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US"> <emph>string</emph>: Any valid string expression. Only the first character in the string is relevant.</paragraph>
 <paragraph id="par_id3145609" role="paragraph" xml-lang="en-US">Use the AscW function to replace keys with Unicode values. If the AscW function encounters a blank string, %PRODUCTNAME Basic reports a run-time error. Returned values are between 0 and 65535.</paragraph>
 <embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
 <embed href="text/sbasic/shared/00000003.xhp#err5"/>
@@ -53,15 +53,15 @@
 <bascode>
 <paragraph id="par_idm1341586960" role="bascode" localize="false" xml-lang="en-US">Sub ExampleAscW</paragraph>
 <paragraph id="par_id3150792" role="bascode" xml-lang="en-US"> Print AscW("A") ' returns 65</paragraph>
-<paragraph id="par_id3148797" role="bascode" xml-lang="en-US"> Print AscW("Ω") ' returns 937</paragraph>
+<paragraph id="par_id3148797" role="bascode" xml-lang="en-US"> Print AscW(string:="Ω") ' returns 937</paragraph>
 <paragraph id="par_id3163800" role="bascode" xml-lang="en-US"> Print AscW("Αθήνα") ' returns 913, since only the first character (Alpha) is taken into account</paragraph>
 <paragraph id="par_idm1341580480" role="bascode" localize="false" xml-lang="en-US">End Sub</paragraph>
 </bascode>
 
 <section id="relatedtopics">
-<paragraph id="par_idN1067B" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120102.xhp">Chr</link></paragraph>
-<paragraph id="par_id051920171027053197" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120112.xhp">ChrW</link></paragraph>
-<paragraph id="par_id051920171027051338" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120101.xhp">Asc</link></paragraph>
+   <embed href="text/sbasic/shared/03120101.xhp#Asc_h1"/>
+   <embed href="text/sbasic/shared/03120102.xhp#Chr_h1"/>
+   <embed href="text/sbasic/shared/03120112.xhp#ChrW_h1"/>
 </section>
 </body>
 
diff --git a/source/text/sbasic/shared/03120112.xhp b/source/text/sbasic/shared/03120112.xhp
index 39f9cebee0..05d2b8297e 100644
--- a/source/text/sbasic/shared/03120112.xhp
+++ b/source/text/sbasic/shared/03120112.xhp
@@ -34,13 +34,13 @@
 </bookmark>
 
 
-<paragraph id="hd_id3149205" role="heading" level="1" xml-lang="en-US"><link href="text/sbasic/shared/03120112.xhp" name="ChrW Function">ChrW Function [VBA]</link></paragraph>
-<paragraph id="par_id3153311" role="paragraph" xml-lang="en-US">Returns the Unicode character that corresponds to the specified character code.</paragraph>
+<h1 id="hd_id3149205"><variable id="ChrW_h1"><link href="text/sbasic/shared/03120112.xhp" name="ChrW Function">ChrW Function [VBA]</link></variable></h1>
+<paragraph id="par_id3153311" role="paragraph">Returns the Unicode character that corresponds to the specified character code.</paragraph>
 </section>
 <embed href="text/sbasic/shared/00000003.xhp#vbasupport"/>
 <embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
 <bascode>
-<paragraph id="par_id3150669" role="bascode" xml-lang="en-US">ChrW(Expression As Integer)</paragraph>
+<paragraph id="par_id3150669" role="bascode" xml-lang="en-US">ChrW(Expression As Integer) As String</paragraph>
 </bascode>
 <embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
 <paragraph id="par_id3153824" role="paragraph" xml-lang="en-US">String</paragraph>
@@ -59,10 +59,10 @@
 </bascode>
 
 <section id="relatedtopics">
-<paragraph id="par_id051920171010491586" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120102.xhp">Chr</link></paragraph>
-<paragraph id="par_idN10668" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120101.xhp">Asc</link></paragraph>
-<paragraph id="par_id051920171009414669" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120111.xhp">AscW</link></paragraph>
+   <embed href="text/sbasic/shared/03120101.xhp#Asc_h1"/>
+   <embed href="text/sbasic/shared/03120111.xhp#AscW_h1"/>
+   <embed href="text/sbasic/shared/03120102.xhp#Chr_h1"/>
 </section>
 </body>
 
-</helpdocument>
+</helpdocument>
\ No newline at end of file