AllLangHelp_sbasic.mk | 1
source/auxiliary/sbasic.tree | 1
source/text/sbasic/shared/03/sf_methods.xhp | 196 ++++++++++++++++++++++++++++
source/text/sbasic/shared/conventions.xhp | 4
4 files changed, 202 insertions(+)
New commits:
commit ff452e27c1c7f420d8a0cf8a9d82d1d318225d46
Author: Alain Romedenne <alain.romede...@libreoffice.org>
AuthorDate: Fri Jun 11 14:22:57 2021 +0200
Commit: Rafael Lima <rafael.palma.l...@gmail.com>
CommitDate: Mon Jun 21 19:32:01 2021 +0200
ScriptForge method signatures
Change-Id: I5c29d5c08a8c5bd46ca45dc1d17449a0ae4789b8
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/116910
Tested-by: Jenkins
Reviewed-by: Rafael Lima <rafael.palma.l...@gmail.com>
diff --git a/AllLangHelp_sbasic.mk b/AllLangHelp_sbasic.mk
index d50105a59..fc3aca51c 100644
--- a/AllLangHelp_sbasic.mk
+++ b/AllLangHelp_sbasic.mk
@@ -93,6 +93,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,sbasic,\
helpcontent2/source/text/sbasic/shared/03/sf_formcontrol \
helpcontent2/source/text/sbasic/shared/03/sf_intro \
helpcontent2/source/text/sbasic/shared/03/sf_l10n \
+ helpcontent2/source/text/sbasic/shared/03/sf_methods \
helpcontent2/source/text/sbasic/shared/03/sf_platform \
helpcontent2/source/text/sbasic/shared/03/sf_session \
helpcontent2/source/text/sbasic/shared/03/sf_services \
diff --git a/source/auxiliary/sbasic.tree b/source/auxiliary/sbasic.tree
index e8a0dca19..52dcb35a4 100644
--- a/source/auxiliary/sbasic.tree
+++ b/source/auxiliary/sbasic.tree
@@ -334,6 +334,7 @@
<node id="07010305" title="ScriptForge Library">
<topic
id="sbasic/text/sbasic/shared/03/lib_ScriptForge.xhp">Overview of the
ScriptForge Library</topic>
<topic
id="sbasic/text/sbasic/shared/03/sf_intro.xhp">Creating Python Scripts with
ScriptForge</topic>
+ <topic
id="sbasic/text/sbasic/shared/03/sf_methods.xhp">ScriptForge method
signatures</topic>
<topic
id="sbasic/text/sbasic/shared/03/sf_array.xhp">Array service</topic>
<topic
id="sbasic/text/sbasic/shared/03/sf_base.xhp">Base service</topic>
<topic
id="sbasic/text/sbasic/shared/03/sf_basic.xhp">Basic service</topic>
diff --git a/source/text/sbasic/shared/03/sf_methods.xhp
b/source/text/sbasic/shared/03/sf_methods.xhp
new file mode 100644
index 000000000..0d91cedbd
--- /dev/null
+++ b/source/text/sbasic/shared/03/sf_methods.xhp
@@ -0,0 +1,196 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<helpdocument version="1.0">
+ <!--
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ -->
+ <meta>
+ <topic id="scriptforgemethods" indexer="include" status="PUBLISH">
+ <title id="tit" xml-lang="en-US">ScriptForge Method
Signatures</title>
+ <filename>/text/sbasic/shared/03/sf_methods.xhp</filename>
+ </topic>
+ </meta>
+ <body>
+ <h1 id="hd_id31529004750471" xml-lang="en-US"><variable
id="SF_Signatures"><link href="text/sbasic/shared/03/sf_methods.xhp"
name="ScriptForge Method Signatures"><literal>ScriptForge</literal> Method
Signatures</link></variable></h1>
+ <bookmark xml-lang="en-US" branch="index" id="bm_id491529070339774">
+ <bookmark_value>ScriptForge; Method signatures</bookmark_value>
+ </bookmark>
+ <paragraph role="paragraph" id="par_id681619700336879">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.</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id681623415196030" role="listitem">Whenever
service methods are proposed solely for %PRODUCTNAME Basic, their syntax
presentation matches that of Basic subroutines, functions or properties.
</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id401623415235965" role="listitem">Whenever
service methods are proposed for Python and Basic, or solely for Python, their
syntax and arguments use a specific textual layout.</paragraph>
+ </listitem>
+ </list>
+
+ <h2 id="hd_id1001623415980365">Basic only service method</h2>
+ <paragraph role="paragraph" id="par_id791623418737799">Typographical
characters such as brackets, ellipsis or curly braces denote optional,
repetitive or compulsory arguments:</paragraph>
+ <embed href="text/sbasic/shared/conventions.xhp#Typography)"/>
+ <h3 id="hd _id511616863794613" localize="false"><embedvar
href="text/sbasic/shared/00000003.xhp#functexample"/></h3>
+ <bascode>
+ <paragraph role="bascode" localize="false"
id="bas_id241623422100136">FSO.HashFile(FileName As String, _</paragraph>
+ <paragraph role="bascode" localize="false" id="bas_id101623423263928">
Algorithm As String = {MD5|SHA1|SHA224|SHA256|SHA384|SHA512}) As
String</paragraph>
+ <paragraph role="bascode" localize="false"
id="bas_id851623422099952">SF_Array.ImportFromCSVFile(FileName As String,
_</paragraph>
+ <paragraph role="bascode" localize="false" id="bas_id741623423196368">
[Delimiter = ","], [DateFormat As String]) As Variant</paragraph>
+ <paragraph role="bascode" localize="false"
id="bas_id691623422100368">SF_String.SplitNotQuoted(InputStr As String,
_</paragraph>
+ <paragraph role="bascode" localize="false" id="bas_id881623423667888">
[Delimiter As String], [Occurrences As Long], [QuoteChar As String]) As
Variant</paragraph>
+ </bascode>
+
+ <h2 id="hd_id711623416000470">Python or Basic service methods</h2>
+ <paragraph role="paragraph" id="par_id221623415475781">The following
typographical rules are mixing the UML notation, the API documentation layout
and the UNO object inspector user interface:</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph id="par_id661623417427142" role="listitem">Optional
parameters are indicated with either opt, '=' accompanying a default value, or
'[ ]' brackets.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id351623417430814" role="listitem">arguments are
lowercased, in order to comply with Python PEP 8 while Basic is
case-agnostic.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id781623417432494" role="listitem">Collections
arguments or API sequences are denoted using UML multiplicity. That applies
also to return values.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id741623417433319" role="listitem">Basic data types
and Python annotations are syntactically transposed as:</paragraph>
+ </listitem>
+ </list>
+ <table id="tab_Datatypes">
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id131613838858931" localize="false"
role="tablehead">%PRODUCTNAME<br/>Basic</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id441613838858931"
role="tablehead">Syntax</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id441613839128931" localize="false"
role="tablehead">Python</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id851613847558931"
role="tablecontent">Boolean</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph role="tablecontent" localize="false"
id="par_id581613836728425">bool</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph role="tablecontent" localize="false"
id="par_id731613840022120">bool</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id241623419591966" localize="false"
role="tablecontent">Date</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id541623420256687"
role="tablecontent">datetime</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id421623420257224"
role="tablecontent">datetime</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id651623419593960" localize="false"
role="tablecontent">Double</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id321623420281678"
role="tablecontent">float</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id471623420282320"
role="tablecontent">float</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id421623419594151" localize="false"
role="tablecontent">Integer</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id971623420314751"
role="tablecontent">int</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id561623420315278"
role="tablecontent">int</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id511623419594366" localize="false"
role="tablecontent">Long</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id451623420342159"
role="tablecontent">int</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id591623420343208"
role="tablecontent">int</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id541623419594576" localize="false"
role="tablecontent">Object</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id601623420375543"
role="tablecontent">obj</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id931623419594783" localize="false"
role="tablecontent">Single</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id821623420532337"
role="tablecontent">float</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id351623420532936"
role="tablecontent">float</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id391623419595010" localize="false"
role="tablecontent">String</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id211623420546503"
role="tablecontent">str</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id681623420559167"
role="tablecontent">str</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id61623419595200" localize="false"
role="tablecontent">Variant</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id81623420571390"
role="tablecontent">any</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id931623419595424" role="tablecontent">UNO
Object</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id821623420607671"
role="tablecontent">uno</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id951623419595631" role="tablecontent">User
Defined<br/>Type (UDT)</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id491623420626262"
role="tablecontent">obj</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id451623419793734"
role="tablecontent"><literal>ScriptForge</literal><br/>service</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id761623420648335"
role="tablecontent">svc</paragraph>
+ </tablecell>
+ </tablerow>
+ </table>
+ <h3 id="hd _id622616863794724" localize="false"><embedvar
href="text/sbasic/shared/00000003.xhp#functexample"/></h3>
+ <paragraph role="paragraph" localize="false"
id="par_id261623421276448"><input>svc.Forms( opt form: any ):
svc[0..*]</input></paragraph>
+ <paragraph role="paragraph" localize="false"
id="par_id921623420866535"><input>svc.MsgBox( prompt: str, buttons = svc.MB_OK
, opt title: str ): opt str</input></paragraph>
+ <paragraph role="paragraph" localize="false"
id="par_id641623420867288"><input>svc.InputBox( prompt: str, default = "", [
title: str ], [ xpostwips: int, ypostwips: int ] ): str</input></paragraph>
+</body>
+</helpdocument>
\ No newline at end of file
diff --git a/source/text/sbasic/shared/conventions.xhp
b/source/text/sbasic/shared/conventions.xhp
index 8590f1c38..974db923a 100644
--- a/source/text/sbasic/shared/conventions.xhp
+++ b/source/text/sbasic/shared/conventions.xhp
@@ -40,12 +40,16 @@
<paragraph role="image" id="par_id931593707147102"><image
src="media/helpimg/sbasic/comment_fragment.svg" id="img_id191593707147102"><alt
id="alt_id111593707147102">diagram fragment</alt></image></paragraph>
<h2 id="hd_id71593700691968">Textual example</h2>
+ <section id="Typography">
<list type="unordered">
<listitem><paragraph id="par_id181593700546735"
role="listitem"><emph>[opt1|opt2|opt3]</emph> Items inside brackets are
optional, alternatives are indicated with a vertical bar,</paragraph></listitem>
<listitem><paragraph id="par_id181593699546735"
role="listitem"><emph>case[[sep]…]</emph> An ellipsis indicates a possible
repetition, an optional separator may be specified,</paragraph></listitem>
<listitem><paragraph id="par_id712593699548486"
role="listitem"><emph>{choice1|choice2}</emph> Items inside curly braces are
compulsory, alternatives are indicated with a vertical
bar.</paragraph></listitem>
</list>
+ </section>
+
<paragraph role="paragraph" id="par_id881593759547050"
localize="false"><literal>[ [label:] statement [: …] ] [{REM|'}
text]</literal></paragraph>
+
<paragraph role="paragraph" id="par_id411593701639711">A set of
%PRODUCTNAME Basic statements - with optional labels - is using a colon
<literal>:</literal> sign to separate them, it can be terminated with an
optional comment. <literal>REM</literal> or an apostrophe sign introduce a
comment.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#functexample"/>
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
