source/text/sbasic/shared/03130500.xhp | 64 ++++++++++++++++++---------------
1 file changed, 36 insertions(+), 28 deletions(-)
New commits:
commit 47a2e63384c754cf2c8766bc1d03b9a1d009c498
Author: Olivier Hallot <olivier.hal...@libreoffice.org>
AuthorDate: Thu Jun 22 06:43:13 2023 -0300
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Thu Jun 22 21:27:47 2023 +0200
tdf#156015 Mark unimplemented args of BASIC Shell
+ refactor
Change-Id: Ide7bc5a4abd4685b2bbe2727740358ac4c811030
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/153455
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/sbasic/shared/03130500.xhp
b/source/text/sbasic/shared/03130500.xhp
index 2ae8648136..2282d64834 100644
--- a/source/text/sbasic/shared/03130500.xhp
+++ b/source/text/sbasic/shared/03130500.xhp
@@ -20,7 +20,7 @@
<meta>
<topic id="textsbasicshared03130500xml" indexer="include" status="PUBLISH">
- <title id="tit" xml-lang="en-US">Shell Function</title>
+ <title id="tit">Shell Function</title>
<filename>/text/sbasic/shared/03130500.xhp</filename>
</topic>
</meta>
@@ -28,99 +28,107 @@
<body>
<section id="shell">
-<bookmark xml-lang="en-US" branch="index" id="bm_id3150040">
+<bookmark branch="index" id="bm_id3150040">
<bookmark_value>Shell function</bookmark_value>
</bookmark>
<h1 id="hd_id3150040"><link href="text/sbasic/shared/03130500.xhp">Shell
Function</link></h1>
-<paragraph id="par_id3153394" role="paragraph" xml-lang="en-US">Starts another
application and defines the respective window style, if necessary.</paragraph>
+<paragraph id="par_id3153394" role="paragraph">Starts another application and
defines the respective window style, if necessary.</paragraph>
</section>
<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
-<paragraph id="par_id3147576" role="code" xml-lang="en-US">Shell (Pathname As
String[, Windowstyle As Integer[, Param As String[, bSync]]]) </paragraph>
+<paragraph id="par_id3147576" role="code">Shell (Pathname As String[,
Windowstyle As Integer[, Param As String[, bSync]]]) </paragraph>
<embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
<h3 id="hd_id3154306">Pathname</h3>
-<paragraph id="par_id3155419" role="paragraph" xml-lang="en-US">Name of the
program that you want to start, optionally with complete path and/or
arguments.</paragraph>
+<paragraph id="par_id3155419" role="paragraph">Name of the program that you
want to start, optionally with complete path and/or arguments.</paragraph>
<h3 id="hd_id3150771">Windowstyle</h3>
-<paragraph id="par_id3145609" role="paragraph" xml-lang="en-US">Optional
integer expression that specifies the style of the window that the program is
executed in. The following values are possible:</paragraph>
+<paragraph id="par_id3145609" role="paragraph">Optional integer expression
that specifies the style of the window that the program is executed
in.</paragraph>
+
+<note id="par_id451687425656673">Parameter <emph>Windowstyle</emph> is only
effective on Windows systems. On other systems the parameter is ignored.</note>
+
+<paragraph role="paragraph" id="par_id531687425555734">The following values
are possible:</paragraph>
<table id="tbl_id3156343">
<tablehead>
<tablerow>
<tablecell>
- <paragraph id="par_id931651081957773" role="tablehead"
localize="false" xml-lang="en-US" >Windowstyle</paragraph>
+ <paragraph id="par_id931651081957773" role="tablehead"
localize="false">Windowstyle</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id221651081957774" role="tablehead"
xml-lang="en-US" >Meaning</paragraph>
+ <paragraph id="par_id221651081957774"
role="tablehead">Meaning</paragraph>
</tablecell>
</tablerow>
</tablehead>
<tablerow>
<tablecell>
- <paragraph id="par_id3148663" role="paragraph" localize="false"
xml-lang="en-US">0</paragraph>
+ <paragraph id="par_id3148663" role="paragraph"
localize="false">0</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3153360" role="paragraph" xml-lang="en-US">The
focus is on the hidden program window.</paragraph>
+ <paragraph id="par_id3153360" role="paragraph">The focus is on the
hidden program window.</paragraph>
+ <paragraph role="paragraph" id="par_id831687425819018"><variable
id="notimplem"><emph>Not implemented in
%PRODUCTNAME</emph>.</variable></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3154123" role="paragraph" localize="false"
xml-lang="en-US">1</paragraph>
+ <paragraph id="par_id3154123" role="paragraph"
localize="false">1</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3144760" role="paragraph" xml-lang="en-US">The
focus is on the program window in standard size.</paragraph>
+ <paragraph id="par_id3144760" role="paragraph">The focus is on the
program window in standard size.</paragraph>
+ <paragraph role="paragraph" id="par_id651687425907908"
localize="false"><embedvar href="text/sbasic/shared/03130500.xhp#notimplem"
markup="ignore"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3156422" role="paragraph" localize="false"
xml-lang="en-US">2</paragraph>
+ <paragraph id="par_id3156422" role="paragraph"
localize="false">2</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3148451" role="paragraph" xml-lang="en-US">The
focus is on the minimized program window.</paragraph>
+ <paragraph id="par_id3148451" role="paragraph">The focus is on the
minimized program window.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3149561" role="paragraph" localize="false"
xml-lang="en-US">3</paragraph>
+ <paragraph id="par_id3149561" role="paragraph"
localize="false">3</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3146921" role="paragraph" xml-lang="en-US">focus is
on the maximized program window.</paragraph>
+ <paragraph id="par_id3146921" role="paragraph">focus is on the maximized
program window.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3149481" role="paragraph" localize="false"
xml-lang="en-US">4</paragraph>
+ <paragraph id="par_id3149481" role="paragraph"
localize="false">4</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3155854" role="paragraph" xml-lang="en-US">Standard
size program window, without focus.</paragraph>
+ <paragraph id="par_id3155854" role="paragraph">Standard size program
window, without focus.</paragraph>
+ <paragraph role="paragraph" id="par_id141687425941013"
localize="false"><embedvar href="text/sbasic/shared/03130500.xhp#notimplem"
markup="ignore"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3145271" role="paragraph" localize="false"
xml-lang="en-US">6</paragraph>
+ <paragraph id="par_id3145271" role="paragraph"
localize="false">6</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3152938" role="paragraph"
xml-lang="en-US">Minimized program window, focus remains on the active
window.</paragraph>
+ <paragraph id="par_id3152938" role="paragraph">Minimized program window,
focus remains on the active window.</paragraph>
+ <paragraph role="paragraph" id="par_id701687425953597"
localize="false"><embedvar href="text/sbasic/shared/03130500.xhp#notimplem"
markup="ignore"/></paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
- <paragraph id="par_id3146119" role="paragraph" localize="false"
xml-lang="en-US">10</paragraph>
+ <paragraph id="par_id3146119" role="paragraph"
localize="false">10</paragraph>
</tablecell>
<tablecell>
- <paragraph id="par_id3151112" role="paragraph"
xml-lang="en-US">Full-screen display.</paragraph>
+ <paragraph id="par_id3151112" role="paragraph">Full-screen
display.</paragraph>
</tablecell>
</tablerow>
</table>
-
+<note id="par_id761687426550721"><emph>Windowstyle 3</emph> and
<emph>10</emph> are equivalent in Windows systems.</note>
<h3 id="hd_id3150419">Param</h3>
-<paragraph id="par_id3149412" role="paragraph" xml-lang="en-US">String that
specifies additional arguments passed to the program.</paragraph>
+<paragraph id="par_id3149412" role="paragraph">String that specifies
additional arguments passed to the program.</paragraph>
<h3 id="hd_id3148456">bSync</h3>
-<paragraph id="par_id3154096" role="paragraph" xml-lang="en-US">If this value
is set to <emph>true</emph>, the <emph>Shell</emph> command and all
$[officename] tasks wait until the shell process completes. If the value is set
to <emph>false</emph>, the shell returns directly. The default value is
<emph>false</emph>.</paragraph>
+<paragraph id="par_id3154096" role="paragraph">If this value is set to
<emph>true</emph>, the <emph>Shell</emph> command and all $[officename] tasks
wait until the shell process completes. If the value is set to
<emph>false</emph>, the shell returns directly. The default value is
<emph>false</emph>.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
<embed href="text/sbasic/shared/00000003.xhp#err5"/>
<embed href="text/sbasic/shared/00000003.xhp#err53"/>
@@ -128,9 +136,9 @@
<embed href="text/sbasic/shared/00000003.xhp#functexample"/>
<bascode>
-<paragraph id="par_idm1341273680" role="bascode" localize="false"
xml-lang="en-US">Sub ExampleShellForWin</paragraph>
-<paragraph id="par_idm1341272448" role="bascode" localize="false"
xml-lang="en-US"> Shell("c:\windows\calc.exe",2)</paragraph>
-<paragraph id="par_idm1341271200" role="bascode" localize="false"
xml-lang="en-US">End Sub</paragraph>
+<paragraph id="par_idm1341273680" role="bascode" localize="false">Sub
ExampleShellForWin</paragraph>
+<paragraph id="par_idm1341272448" role="bascode" localize="false">
Shell("c:\windows\calc.exe",2)</paragraph>
+<paragraph id="par_idm1341271200" role="bascode" localize="false">End
Sub</paragraph>
</bascode>
</body>
