From 7ba0e03b4f3f3770ca7eaf78bc896e874d66d3ff Mon Sep 17 00:00:00 2001
From: Patrick Pelissier <patrick.pelissier@gmail.com>
Date: Thu, 20 Jun 2019 21:36:12 +0200
Subject: [PATCH] Add comments

---
 example/ex-json01.c | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/example/ex-json01.c b/example/ex-json01.c
index d5977098..32e4a5f0 100644
--- a/example/ex-json01.c
+++ b/example/ex-json01.c
@@ -5,6 +5,7 @@
 // Serial json is not supported for standard types if not C11
 #if defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L  
 
+// Let's define a 'person' composed of several fields.
 TUPLE_DEF2(person,
            (surname, string_t),
            (age, int),
@@ -12,25 +13,31 @@ TUPLE_DEF2(person,
            )
 #define M_OPL_person_t() TUPLE_OPLIST(person, M_DEFAULT_OPLIST, STRING_OPLIST, M_DEFAULT_OPLIST )
 
+// Let's define an array of person
 ARRAY_DEF(base, person_t)
 #define M_OPL_base_t() ARRAY_OPLIST(base, M_OPL_person_t())
 
+// Let's read an array of person from the given JSON file
 static void read(base_t base, const char filename[])
 {
   m_serial_read_t  in;
   m_serial_return_code_t ret;
 
+  // Open the file
   FILE *f = fopen(filename, "rt");
   if (!f) {
     fprintf(stderr, "ERROR: Cannot open file '%s'.\n", filename);
     exit(2);
   }
+  // Initialize the serializer with the file
   m_serial_json_read_init(in, f);
+  // Read the array
   ret = base_in_serial(base, in);
   if (ret != M_SERIAL_OK_DONE) {
     fprintf(stderr, "ERROR: Cannot read JSON data from file '%s'.\n", filename);
     exit(2);
   }
+  // Let's close & clear all
   m_serial_json_read_clear(in);
   fclose(f);
 }