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

[Stephan Bergmann]

 odk/README |   22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

New commits:
commit 8c30d8bbb8a0b3682160252ee065befabf613a7b
Author: Stephan Bergmann <sbergman at redhat.com>
Date:   Mon Jun 29 16:09:27 2015 +0200

    Explain how to test SDK examples
    
    Change-Id: Ifcf0a7276e1b0da6b9176eb70c4a8dae00491935

diff --git a/odk/README b/odk/README
index 8af3eed..dad77b2 100644
--- a/odk/README
+++ b/odk/README
@@ -1,3 +1,25 @@
 Office development kit - implements the first step on the way to the LibreOffice SDK tarball.
 
 Part of the SDK; to build you need to add --enable-odk.
+
+
+Testing the examples:
+=====================
+
+* See <http://api.libreoffice.org/docs/install.html> how to set up the SDK.
+
+** When asked about it during configuration, tell the SDK to do automatic
+   deployment of the example extensions that get built.
+
+* In a shell set up for SDK development, build (calling "make") and test
+  (following the instructions given at the end of each "make" invocation) each
+  of the SDK's examples/ sub-directories.
+
+** An example script to build (though not test) the various examples in batch
+   mode is
+
+     find examples \( -type d -name nativelib -prune \) -o \
+      \( -name Makefile -a -print -a \( -execdir make \; -o -quit \) \)
+
+   (Note that one of the example extensions asks you to accept an example
+   license on stdin during deployment.)