[Libreoffice-commits] core.git: odk/docs

[Stephan Bergmann (via logerrit)]

 odk/docs/install.html |   21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

New commits:
commit c85588548bb016eb88247de75e303be2585023a6
Author:     Stephan Bergmann <sbergman at redhat.com>
AuthorDate: Wed Dec 18 11:48:19 2019 +0100
Commit:     Stephan Bergmann <sbergman at redhat.com>
CommitDate: Wed Dec 18 13:03:59 2019 +0100

    Fix instructions for setting up the SDK
    
    (see the mail thread starting at
    <https://lists.freedesktop.org/archives/libreoffice/2019-December/084013.html>
    "Beginner's question about installing Libreoffice SDK")
    
    Change-Id: Iea0c394ec052587cdf4ba2a6a7ab38f4214ccbf0
    Reviewed-on: https://gerrit.libreoffice.org/85374
    Tested-by: Jenkins
    Reviewed-by: Stephan Bergmann <sbergman at redhat.com>

diff --git a/odk/docs/install.html b/odk/docs/install.html
index 1f9b502daf02..1ed78676f68d 100644
--- a/odk/docs/install.html
+++ b/odk/docs/install.html
@@ -207,8 +207,8 @@
                         </tr>
                         <tr valign="middle">
                           <td colspan="2">
-                            <p>The SDK provides an implicit configuration
-                              mechanism, which configures the SDK build
+                            <p>The SDK provides a
+                              mechanism which configures the SDK build
                               environment to your personal needs the first time
                               you use the SDK environment. This configuration
                               step creates a new setsdkenv_XXX script in the
@@ -219,11 +219,22 @@
                               <li><b>C:\Documents and Settings\<username>\Application Data\%OO_SDK_NAME%\setsdkenv_windows.bat</b>  ->
                                 for Windows</li>
                             </ul>
-                            <p>The automatically started configure script (Unix-like systems
-                              and Windows) requests relevant information
+                            <p>To start the configure script, change into the SDK root directory and
+                              run:</p>
+                            <ul>
+                              <li><b>./setsdkenv_unix</b>  ->
+                                for Unix-like systems</li>
+                              <li><b>setsdkenv_windows.bat</b>  ->
+                                for Windows</li>
+                            </ul>
+                            <p>The configure script
+                              requests relevant information
                               and directories (SDK, LibreOffice, GNU make, Java,
                               C++), in order to prepare a working SDK
-                              environment. After completing the configure script
+                              environment. (On Unix-like systems, the configure script recursively
+                              starts a new interactive shell with the relevent environment variables
+                              set; this is not needed on Windows.)
+                              After completing the configure script
                               once, the newly created script is always used to
                               set the necessary environment variables for using
                               the SDK and the required tools.</p>