offapi/com/sun/star/system/XSystemShellExecute.idl |   10 ++++++++++
 1 file changed, 10 insertions(+)

New commits:
commit 589f3c68baa2db69e0795020fdd60926526b2f4a
Author:     Noel Grandin <[email protected]>
AuthorDate: Mon Jan 29 13:09:09 2024 +0200
Commit:     Noel Grandin <[email protected]>
CommitDate: Tue Jan 30 09:03:18 2024 +0100

    improve docs of XSystemShellExecute
    
    copied from a comment by sberg
    
    Change-Id: Ia363bac0a115564265ca9169174fdfc0d8610a69
    Reviewed-on: https://gerrit.libreoffice.org/c/core/+/162685
    Tested-by: Jenkins
    Reviewed-by: Noel Grandin <[email protected]>

diff --git a/offapi/com/sun/star/system/XSystemShellExecute.idl 
b/offapi/com/sun/star/system/XSystemShellExecute.idl
index fc24da93c6c1..65b17c0b619f 100644
--- a/offapi/com/sun/star/system/XSystemShellExecute.idl
+++ b/offapi/com/sun/star/system/XSystemShellExecute.idl
@@ -28,6 +28,16 @@ published interface XSystemShellExecute: 
com::sun::star::uno::XInterface
 {
     /** Executes an arbitrary system command.
 
+        There are generally two modes of operation for this function:
+
+        With `URIS_ONLY` among the passed-in `nFlags`, the passed-in `aCommand`
+        must be a URI that is opened in an
+        "only do secure things, make sure not to execute potentially dangerous 
code" way
+        (e.g., instead of running an arbitrary app, open a window showing the 
location of the app).
+
+        Without `URIS_ONLY` among the passed-in `nFlags`, the passed-in 
`aCommand` must be a
+        system pathname of an executable to run.
+
         @param aCommand
         Specifies the command to execute. This may be an executable file or a
         document which is registered with an application on a specific 
platform,

Reply via email to