examples: Add notice about using experimental API 83/23483/6
authorPhilippe Coval <philippe.coval@osg.samsung.com>
Tue, 28 Nov 2017 08:44:42 +0000 (09:44 +0100)
committerDave Thaler <dthaler@microsoft.com>
Fri, 23 Mar 2018 05:37:36 +0000 (05:37 +0000)
Bug: https://jira.iotivity.org/browse/IOT-1745
Change-Id: I14190ffe2f857d48e062f3f78e9b7b52123efe1b
Signed-off-by: Philippe Coval <philippe.coval@osg.samsung.com>
54 files changed:
plugins/samples/linux/IotivityandZigbeeClient.c
plugins/samples/linux/IotivityandZigbeeServer.c
resource/IPCA/samples/ElevatorServer/elevatorserver.cpp
resource/csdk/resource-directory/samples/rd_publishingClient.cpp
resource/csdk/resource-directory/samples/rd_queryClient.cpp
resource/csdk/security/provisioning/sample/autoprovisioningclient.c
resource/csdk/security/provisioning/sample/certgenerator.cpp
resource/csdk/security/provisioning/sample/cloud/cloudAuth.c
resource/csdk/security/provisioning/sample/cloud/cloudCommon.c
resource/csdk/security/provisioning/sample/cloud/cloudDiscovery.c
resource/csdk/security/provisioning/sample/cloud/cloudResource.c
resource/csdk/security/provisioning/sample/cloud/cloudWrapper.c
resource/csdk/security/provisioning/sample/cloudClient.c
resource/csdk/security/provisioning/sample/cloudServer.c
resource/csdk/security/provisioning/sample/provisioningclient.c
resource/csdk/security/provisioning/sample/sampleserver_justworks.cpp
resource/csdk/security/provisioning/sample/sampleserver_mfg.cpp
resource/csdk/security/provisioning/sample/sampleserver_mvjustworks.cpp
resource/csdk/security/provisioning/sample/sampleserver_preconfpin.cpp
resource/csdk/security/provisioning/sample/sampleserver_randompin.cpp
resource/csdk/security/provisioning/sample/subownerclient.c
resource/csdk/security/provisioning/unittest/sampleserver.cpp
resource/csdk/stack/samples/arduino/SimpleClientServer/ocserver/ocserver.cpp
resource/csdk/stack/samples/linux/OCSample/occlient.c
resource/csdk/stack/samples/linux/OCSample/ocserver.c
resource/csdk/stack/samples/linux/SimpleClientServer/occlient.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/occlientbasicops.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/occlientcoll.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/occlientslow.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/ocremoteaccessclient.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/ocrouting.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/ocserver.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/ocserverbasicops.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/ocservercoll.cpp
resource/csdk/stack/samples/linux/SimpleClientServer/ocserverslow.cpp
resource/csdk/stack/samples/linux/secure/common.cpp
resource/csdk/stack/samples/linux/secure/ocamsservice.cpp
resource/csdk/stack/samples/linux/secure/occlientbasicops.cpp
resource/csdk/stack/samples/linux/secure/ocserverbasicops.cpp
resource/csdk/stack/samples/tizen/SimpleClientServer/occlient.cpp
resource/csdk/stack/samples/tizen/SimpleClientServer/ocrouting.cpp
resource/csdk/stack/samples/tizen/SimpleClientServer/ocserver.cpp
resource/examples/groupclient.cpp
resource/provisioning/examples/cloudAuth.cpp
resource/provisioning/examples/cloudClient.cpp
resource/provisioning/examples/cloudWrapper.cpp
resource/provisioning/examples/provisioningclient.cpp
resource/provisioning/examples/subownerclient.cpp
service/coap-http-proxy/samples/proxy_client.c
service/easy-setup/sampleapp/enrollee/arduino/enrolleewifi.cpp
service/easy-setup/sampleapp/enrollee/linux/easysetup_x.c
service/easy-setup/sampleapp/enrollee/tizen-sdb/EnrolleeSample/easysetup_wifi_conn.c
service/easy-setup/sampleapp/mediator/linux/richsdk_sample/mediator.cpp
service/easy-setup/sampleapp/mediator/linux/richsdk_sample/submediator.cpp

index 52fe5ba..c8be5c1 100644 (file)
 #include <unistd.h>
 #include <errno.h>
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "oic_string.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 #define DEFAULT_CONTEXT_VALUE       (0x99)
 #define MAX_QUERY_SIZE              (1024)
 #define MAX_URI_SIZE                (256)
index 4d4dc6c..2450a39 100644 (file)
 #include "IotivityandZigbeeServer.h"
 #include <signal.h>
 #include <ocstack.h>
-#include "experimental/logger.h"
+
 #include "oic_string.h"
 #include "oic_malloc.h"
 
 #define TAG "IoTivityZigbeeServer"
 #define defaultComPort "/dev/ttyUSB0"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
+
 #define VERIFY_SUCCESS(op)                          \
 {                                                   \
     if (op !=  OC_STACK_OK)                         \
index b003c32..047f833 100644 (file)
  *
  ******************************************************************/
 
-#include "experimental/logger.h"
 #include "elevatorserver.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 using namespace OC;
 using namespace std::placeholders;
 
index 85beafa..6048370 100644 (file)
 #include <limits>
 
 #include "oic_string.h"
-
 #include "rd_client.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// logging part is not critical but convenient for developer
 #include "experimental/payload_logging.h"
 
 #define TAG ("RD_PublishClient")
index 9b45b0f..b308d58 100644 (file)
 #include <iostream>
 #include "octypes.h"
 #include "ocstack.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// logging part is not critical
 #include "experimental/payload_logging.h"
 
 bool g_foundResource = true;
index 3484f59..4c658ce 100644 (file)
@@ -35,9 +35,7 @@
 #ifdef HAVE_UNISTD_H
 #include <unistd.h>
 #endif
-#include "experimental/payload_logging.h"
 #include "utlist.h"
-#include "experimental/logger.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "ocprovisioningmanager.h"
@@ -50,7 +48,6 @@
 #include "ocsecurity.h"
 #include "ocstackinternal.h"
 #include "pmutility.h"
-#include "experimental/ocrandom.h"
 
 #ifdef _MSC_VER
 #include <io.h>
 #define access _access_s
 #endif
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+#include "experimental/ocrandom.h"
+
 #ifdef __cplusplus
 extern "C"
 {
index c2a9c08..be78098 100644 (file)
@@ -26,7 +26,6 @@
 
 #include "ocstack.h"
 #include "oic_malloc.h"
-#include "experimental/ocrandom.h"
 #include "occertutility.h"
 
 #ifdef HAVE_WINDOWS_H
 #endif //ERROR
 #endif //HAVE_WINDOWS_H
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/ocrandom.h"
+
 static long GetFileSize(FILE *f)
 {
     long offset, size;
index 2d45f3d..b375fa6 100644 (file)
  * *****************************************************************/
 
 #include "octypes.h"
-#include "experimental/logger.h"
-#include "experimental/payload_logging.h"
 #include "ocstack.h"
 #include "ocpayload.h"
 #include "psinterface.h"
-#include "experimental/securevirtualresourcetypes.h"
 #include "doxmresource.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "pmutility.h"
 #include "credresource.h"
-#include "experimental/payload_logging.h"
 #include "cacommonutil.h"
-
 #include "utils.h"
 #include "cloudAuth.h"
 #include "cloudCommon.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+#include "experimental/securevirtualresourcetypes.h"
+
 #define TAG "cloudAuth"
 
 #define LOGIN_OK 4
index 07a7aa3..a09607d 100644 (file)
 #include <string.h>
 
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "octhread.h"
 #include "cathreadpool.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "aclresource.h"
 #include "acl_logging.h"
 #include "crl_logging.h"
 #include <unistd.h> //for unlink
 #endif
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 #define TAG "cloudCommon"
 
 //[IOT-2147] Requests 50-83 are not confirmed to new OCF spec
index ef24622..471c384 100644 (file)
@@ -18,9 +18,7 @@
 //
 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "oic_string.h"
 #include "srmresourcestrings.h"
 #include "pmutility.h"
 #include "cloudCommon.h"
 #include "cloudWrapper.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 #define TAG "cloudDiscovery"
 
 #define DISCOVERY_URI "/oic/res"
index 0e5f597..82d7856 100644 (file)
 #include <string.h>
 #include "cloudCommon.h"
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
-
 #include "cloudResource.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG "cloudResource"
 
 LEDResource LED;
index 4b6b5bb..7b51e72 100644 (file)
  * limitations under the License.
  *
  * *****************************************************************/
-#include "experimental/logger.h"
 #include "occloudprovisioning.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "srmutility.h"
 #include "aclresource.h"
 #include "utlist.h"
-
 #include "utils.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG "CLOUD-WRAPPER"
 
 #define MAX_ID_LENGTH       (64)
index a819d5b..07efa07 100644 (file)
@@ -18,6 +18,9 @@
  *
  * *****************************************************************/
 #include "cloudCommon.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 #define TAG "cloudClient"
index 8030777..42960f7 100644 (file)
  *
  * *****************************************************************/
 #include "cloudCommon.h"
-#include "experimental/logger.h"
 #include "cloudResource.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG "cloudServer"
 
 extern LEDResource LED;
index bd801ce..05c772d 100644 (file)
@@ -25,9 +25,8 @@
 #ifdef HAVE_UNISTD_H
 #include <unistd.h>
 #endif
-#include "experimental/payload_logging.h"
+
 #include "utlist.h"
-#include "experimental/logger.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "ocprovisioningmanager.h"
 
 #ifdef _MSC_VER
 #include <io.h>
-
 #define F_OK 0
 #define access _access_s
 #endif
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/payload_logging.h"
+#include "experimental/logger.h"
+
 #ifdef __cplusplus
 extern "C"
 {
index a7bdf84..e2c0faf 100644 (file)
 #endif //ERROR
 #endif //HAVE_WINDOWS_H
 #include "platform_features.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 
+
 #define TAG "SAMPLE_JUSTWORKS"
 
 const char * specVersion = "ocf.1.1.0";
index 3af2163..8db4c6e 100644 (file)
@@ -43,6 +43,9 @@
 #endif //ERROR
 #endif //HAVE_WINDOWS_H
 #include "platform_features.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 
index 23391d4..b6dd7a2 100644 (file)
@@ -44,6 +44,9 @@
 #endif //ERROR
 #endif //HAVE_WINDOWS_H
 #include "platform_features.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 
index 52860f1..853d29d 100644 (file)
@@ -43,6 +43,9 @@
 #endif //ERROR
 #endif //HAVE_WINDOWS_H
 #include "platform_features.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 
index 42f1f0a..505673a 100644 (file)
@@ -43,6 +43,9 @@
 #endif //ERROR
 #endif //HAVE_WINDOWS_H
 #include "platform_features.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 #define TAG "SAMPLE_RANDOMPIN"
index 261defd..0d72f5f 100644 (file)
@@ -28,7 +28,6 @@
 
 #include "platform_features.h"
 #include "utlist.h"
-#include "experimental/logger.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "ocprovisioningmanager.h"
 #define access _access_s
 #endif
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #ifdef __cplusplus
 extern "C"
 {
index acc6ef5..c0dc34a 100644 (file)
 #include <time.h>
 
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
 #include "oic_string.h"
 #include "srmutility.h"
 #include "doxmresource.h"
-#include "experimental/ocrandom.h"
 
 #ifdef HAVE_UNISTD_H
 #include <unistd.h>
 #endif
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/ocrandom.h"
+
 #define TAG "JW_UNITTEST"
 
 int gQuitFlag = 0;
index 8e756a0..a9ff8a5 100644 (file)
@@ -21,7 +21,6 @@
 // Do not remove the include below
 #include "Arduino.h"
 
-#include "experimental/logger.h"
 #include "ocstack.h"
 #include "ocpayload.h"
 #include <string.h>
@@ -41,6 +40,9 @@
 #include <EthernetUdp.h>
 #include <Dhcp.h>
 #endif
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
 
 const char *getResult(OCStackResult result);
 
index c4b21b7..dbe0e00 100644 (file)
@@ -31,6 +31,9 @@
 #ifdef HAVE_WINDOWS_H
 #include <windows.h>
 #endif
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 #define TAG ("occlient")
index 2bf66a2..307cd09 100644 (file)
@@ -33,6 +33,9 @@
 #endif
 #include <signal.h>
 #include <stdbool.h>
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 #define TAG ("ocserver")
index b40c593..3268541 100644 (file)
@@ -44,6 +44,9 @@
 #include <coap/pdu.h>
 #include "occlient.h"
 #include "common.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 #include "experimental/payload_logging.h"
 
index 6a95c88..46fa21e 100644 (file)
 #include <getopt.h>
 
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "occlientbasicops.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 #define MAX_IP_ADDR_ST_SZ  16 //string size of "155.255.255.255" (15 + 1)
 #define MAX_PORT_ST_SZ  6     //string size of "65535" (5 + 1)
 
index 10f3c14..98cab1b 100644 (file)
 #include <sstream>
 #include <getopt.h>
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
-#include "experimental/logger.h"
 #include "common.h"
 #include "oic_string.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/payload_logging.h"
+#include "experimental/logger.h"
+
 std::string getQueryStrForGetPut();
 
 #define TAG ("occlient")
index 27df395..d2463cc 100644 (file)
 #include <iostream>
 #include <sstream>
 #include <getopt.h>
+
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "occlientslow.h"
 #include "oic_string.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 // Tracking user input
 static int UnicastDiscovery = 0;
 static int TestCase = 0;
index bc42936..82599ca 100644 (file)
 #include <unistd.h>
 #include <iostream>
 #include <sstream>
+
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "ocremoteaccessclient.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/payload_logging.h"
+#include "experimental/logger.h"
+
+
 #define SET_BUT_NOT_USED(x) (void) x
 // Tracking user input
 static int TEST_CASE = 0;
index 6f1444f..ac2e8db 100644 (file)
 #include <signal.h>
 #include <pthread.h>
 #include <array>
+
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG "ocrouting"
 
 int gQuitFlag = 0;
index 480f7fb..d5d0ffe 100644 (file)
@@ -43,6 +43,9 @@
 #include "ocserver.h"
 #include "common.h"
 #include "oic_string.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
 #include "experimental/logger.h"
 
 #define VERIFY_SUCCESS(op)                          \
index 9fe8616..d9206cf 100644 (file)
 #ifdef HAVE_PTHREAD_H
 #include <pthread.h>
 #endif
+
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocserverbasicops.h"
 #include "ocpayload.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 //string length of "/a/led/" + std::numeric_limits<int>::digits10 + '\0'"
 // 7 + 9 + 1 = 17
 const int URI_MAXSIZE = 17;
index 26752d7..9420600 100644 (file)
 #ifdef HAVE_PTHREAD_H
 #include <pthread.h>
 #endif
+
 #include <ocstack.h>
-#include "experimental/logger.h"
 #include <getopt.h>
 #include "ocpayload.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG PCF("ocservercontainer")
 
 volatile sig_atomic_t gQuitFlag = 0;
index f572df0..bd80950 100644 (file)
 #include "ocstack.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
-#include "experimental/logger.h"
 #include "ocserverslow.h"
 #include "ocpayload.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
 #include "experimental/payload_logging.h"
 
 volatile sig_atomic_t gQuitFlag = 0;
index 8e26c55..f1602d1 100644 (file)
 #include "common.h"
 
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include <stdio.h>
 #include <stdlib.h>
 #include <sys/types.h>
 #include <sys/stat.h>
 
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG "sample-common"
 
 const char *getResult(OCStackResult result) {
index 2f6d6ca..fdf4676 100644 (file)
 #include <pthread.h>
 #endif
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG  PCF("SRM-AMSS")
 
 int gQuitFlag = 0;
index 3f59797..353d775 100644 (file)
 #include <sstream>
 #include <getopt.h>
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "occlientbasicops.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "oic_string.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 #define TAG "occlientbasicops"
 static int UnicastDiscovery = 0;
 static int TestCase = 0;
index 5280c33..e28396f 100644 (file)
 #include <pthread.h>
 #endif
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
 #include "ocserverbasicops.h"
 #include "common.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 
 int gQuitFlag = 0;
 
index 8642b66..d7d5fca 100644 (file)
 #include <iostream>
 #include <sstream>
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "occlient.h"
 #include "ocpayload.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
 #include "experimental/payload_logging.h"
 
 using namespace std;
index a5ac05d..129595b 100644 (file)
 #include <array>
 #include <iostream>
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 using namespace std;
 
 #define TAG "ocrouting"
index 66be2ed..1a67b10 100644 (file)
 #include <array>
 #include "oic_malloc.h"
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
 #include "ocserver.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 using namespace std;
 
 #define VERIFY_SUCCESS(op)                          \
index de50526..9276476 100644 (file)
@@ -20,8 +20,6 @@
 
 #include "OCPlatform.h"
 #include "OCApi.h"
-#include "experimental/logger.h"
-
 #include <functional>
 #include <pthread.h>
 #include <mutex>
 #include <iostream>
 #include <mutex>
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// Here logging part is not critical.
+#include "experimental/logger.h"
+
 #define DO_ACTION               "DoAction"
 #define GET_ACTIONSET           "GetActionSet"
 #define ACTIONSET               "ActionSet"
index 3e09481..e136411 100644 (file)
  * *****************************************************************/
 
 #include "octypes.h"
-#include "experimental/logger.h"
-#include "experimental/payload_logging.h"
 #include "ocstack.h"
 #include "ocpayload.h"
 //#include "psinterface.h"
-#include "experimental/securevirtualresourcetypes.h"
 #include "doxmresource.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "srmutility.h"
 #include "pmutility.h"
 #include "credresource.h"
-#include "experimental/payload_logging.h"
-
 #include "utils.h"
 #include "cloudAuth.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// Here logging part is not critical.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+#include "experimental/securevirtualresourcetypes.h"
+
+
 #define TAG "cloudAuth"
 
 #define LOGIN_OK 4
index aa98f60..328c9b4 100644 (file)
 #include <string.h>
 
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "octhread.h"
 #include "cathreadpool.h"
 #include "ocpayload.h"
-#include "experimental/payload_logging.h"
 #include "ocprovisioningmanager.h"
 
 #include "utils.h"
 #include <unistd.h> //for unlink
 #endif
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// Here logging part is not critical.
+#include "experimental/logger.h"
+#include "experimental/payload_logging.h"
+
 #define TAG "cloudClient"
 using namespace OC;
 
index 19433c0..7a635e1 100644 (file)
 // limitations under the License.
 //
 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
-#include "experimental/logger.h"
+
 #include "occloudprovisioning.h"
 #include "OCCloudProvisioning.hpp"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "utils.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// Here logging part is not critical.
+#include "experimental/logger.h"
+
 #define TAG "CLOUD-WRAPPER"
 
 #define MAX_ID_LENGTH       (64)
index db73bde..9564a8d 100644 (file)
@@ -27,8 +27,6 @@
 #include <pthread.h>
 #include <mutex>
 #include <condition_variable>
-
-#include "experimental/logger.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "OCPlatform.h"
 #include "aclresource.h"
 #include "coap/utlist.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// Here logging part is not critical.
+#include "experimental/logger.h"
+
 #define MAX_PERMISSION_LENGTH (5)
 #define ACL_RESRC_ARRAY_SIZE (3)
 #define CREATE (1)
index ae05e0d..88f7fea 100644 (file)
@@ -28,7 +28,6 @@
 #include <mutex>
 #include <condition_variable>
 
-#include "experimental/logger.h"
 #include "oic_malloc.h"
 #include "oic_string.h"
 #include "OCPlatform.h"
 #include "aclresource.h"
 #include "utlist.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+/// Here logging part is not critical.
+#include "experimental/logger.h"
+
 #define MAX_PERMISSION_LENGTH (5)
 #define ACL_RESRC_ARRAY_SIZE (3)
 #define CREATE (1)
index 352bb04..2cf8885 100644 (file)
 #endif
 
 #include <getopt.h>
+
 #include "ocstack.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
+
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
 #include "experimental/payload_logging.h"
 
 /**
index 85433ea..876b4af 100644 (file)
@@ -20,7 +20,6 @@
 
 #include "Arduino.h"
 
-#include "experimental/logger.h"
 #include <string.h>
 
 #ifdef ARDUINOWIFI
 
 #include "easysetup.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
 #define TAG "TS"
 
 const char *getResult(OCStackResult result);
index 06b778b..29585b2 100644 (file)
 #include "easysetup_x.h"
 #include "string.h"
 #include "oic_malloc.h"
-#include "experimental/logger.h"
 #include "ocpayload.h"
+
 #include <inttypes.h>
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
 /**
  * @var ESX_ENROLLEE_TAG
  * @brief Logging tag for module name.
index 19a83a4..bf949bb 100644 (file)
@@ -21,7 +21,6 @@
 
 #include "easysetup_wifi_conn.h"
 #include "string.h"
-#include "experimental/logger.h"
 #include "escommon.h"
 
 #include <wifi.h>
 #include <glib.h>
 #include <unistd.h>
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/logger.h"
+
+
 /**
  * @var ES_WIFICONN_TAG
  * @brief Logging tag for module name.
index a187555..e868efb 100755 (executable)
 #include "OCPlatform.h"
 #include "OCApi.h"
 #include "OCProvisioningManager.hpp"
-#include "experimental/securevirtualresourcetypes.h"
-
 #include "EasySetup.hpp"
 #include "ESRichCommon.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/securevirtualresourcetypes.h"
+
 #define ES_SAMPLE_APP_TAG "ES_SAMPLE_APP_TAG"
 #define DECLARE_MENU(FUNC, ...) { #FUNC, FUNC }
 
index 7c0edf5..25c8d7f 100644 (file)
 #include "OCPlatform.h"
 #include "OCApi.h"
 #include "OCProvisioningManager.hpp"
-#include "experimental/securevirtualresourcetypes.h"
-
 #include "EasySetup.hpp"
 #include "ESRichCommon.h"
 
+/// This example is using experimental API, so there is no guarantee of support for future release,
+/// nor any there any guarantee that breaking changes will not occur across releases.
+#include "experimental/securevirtualresourcetypes.h"
+
 #define ES_SAMPLE_APP_TAG "ES_SAMPLE_APP_TAG"
 #define DECLARE_MENU(FUNC, ...) { #FUNC, FUNC }