Update the webpage (#1682)

JerryScript-DCO-1.0-Signed-off-by: Zsolt Borbély [email protected]

Author: Zsolt Borbély

02.API-REFERENCE.md

@@ -2071,7 +2071,8 @@ handler (const jerry_value_t function_obj,
 
   // after this, script can invoke the native handler through "handler_field (1, 2, 3);"
   jerry_value_t prop_name = jerry_create_string ((const jerry_char_t *) "handler_field");
-  jerry_set_property (glob_obj, prop_name, func_val);
+  // set property and release the return value without any check
+  jerry_release_value (jerry_set_property (glob_obj, prop_name, func_val));
   jerry_release_value (prop_name);
 
   jerry_release_value (func_val);
@@ -2694,8 +2695,11 @@ jerry_set_property (const jerry_value_t obj_val,
   jerry_value_t glob_obj = jerry_get_global_object ();
   jerry_value_t prop_name = jerry_create_string ((const jerry_char_t *) "my_prop");
 
-  jerry_set_property (glob_obj, prop_name, value_to_set);
+  jerry_value_t set_result = jerry_set_property (glob_obj, prop_name, value_to_set);
 
+  ... // check result of property set call
+
+  jerry_release_value (set_result);
   jerry_release_value (prop_name);
 
   ...
@@ -2846,7 +2850,8 @@ jerry_define_own_property (const jerry_value_t obj_val,
   prop_desc.value = value_to_set;
 
   jerry_value_t prop_name = jerry_create_string ((const jerry_char_t *) "my_prop");
-  jerry_define_own_property (global_obj_val, prop_name, &prop_desc);
+  jerry_value_t return_value = jerry_define_own_property (global_obj_val, prop_name, &prop_desc);
+  jerry_release_value (return_value);
   jerry_release_value (prop_name);
 
   jerry_free_property_descriptor_fields (&prop_desc);
@@ -3141,7 +3146,7 @@ Set the prototype of the specified object.
 
 ```c
 jerry_value_t
-jerry_get_prototype (const jerry_value_t obj_val,
+jerry_set_prototype (const jerry_value_t obj_val,
                      const jerry_value_t proto_obj_val);
 ```
 
@@ -3427,7 +3432,7 @@ jerry_parse_and_save_snapshot (const jerry_char_t *source_p,
                                size_t source_size,
                                bool is_for_global,
                                bool is_strict,
-                               uint8_t *buffer_p,
+                               uint32_t *buffer_p,
                                size_t buffer_size);
 ```
 
@@ -3449,15 +3454,15 @@ jerry_parse_and_save_snapshot (const jerry_char_t *source_p,
 {
   jerry_init (JERRY_INIT_EMPTY);
 
-  static uint8_t global_mode_snapshot_buffer[1024];
+  static uint32_t global_mode_snapshot_buffer[256];
   const jerry_char_t *code_to_snapshot_p = "(function () { return 'string from snapshot'; }) ();";
 
   size_t global_mode_snapshot_size = jerry_parse_and_save_snapshot (code_to_snapshot_p,
                                                                     strlen ((const char *) code_to_snapshot_p),
                                                                     true,
                                                                     false,
                                                                     global_mode_snapshot_buffer,
-                                                                    sizeof (global_mode_snapshot_buffer));
+                                                                    sizeof (global_mode_snapshot_buffer) / sizeof (uint32_t));
 
   jerry_cleanup ();
 }
@@ -3483,7 +3488,7 @@ is no longer needed.
 
 ```c
 jerry_value_t
-jerry_exec_snapshot (const void *snapshot_p,
+jerry_exec_snapshot (const uint32_t *snapshot_p,
                      size_t snapshot_size,
                      bool copy_bytecode);
 ```
@@ -3503,7 +3508,7 @@ jerry_exec_snapshot (const void *snapshot_p,
 ```c
 {
   jerry_value_t res;
-  static uint8_t global_mode_snapshot_buffer[1024];
+  static uint32_t global_mode_snapshot_buffer[256];
   const jerry_char_t *code_to_snapshot_p = "(function () { return 'string from snapshot'; }) ();";
 
   jerry_init (JERRY_INIT_EMPTY);
@@ -3512,7 +3517,7 @@ jerry_exec_snapshot (const void *snapshot_p,
                                                                     true,
                                                                     false,
                                                                     global_mode_snapshot_buffer,
-                                                                    sizeof (global_mode_snapshot_buffer));
+                                                                    sizeof (global_mode_snapshot_buffer) / sizeof (uint32_t));
   jerry_cleanup ();
 
   jerry_init (JERRY_INIT_EMPTY);
@@ -3546,7 +3551,7 @@ size_t
 jerry_parse_and_save_literals (const jerry_char_t *source_p,
                                size_t source_size,
                                bool is_strict,
-                               uint8_t *buffer_p,
+                               uint32_t *buffer_p,
                                size_t buffer_size,
                                bool is_c_format);
 ```
@@ -3568,14 +3573,14 @@ jerry_parse_and_save_literals (const jerry_char_t *source_p,
 {
   jerry_init (JERRY_INIT_EMPTY);
 
-  static uint8_t save_literal_buffer[1024];
+  static uint32_t save_literal_buffer[256];
   const jerry_char_t *code_for_literal_save_p = "var obj = { a:'aa', bb:'Bb' }";
 
   size_t literal_sizes = jerry_parse_and_save_literals (code_for_literal_save_p,
                                                         strlen ((const char *) code_for_literal_save_p),
                                                         false,
                                                         save_literal_buffer,
-                                                        sizeof (save_literal_buffer),
+                                                        sizeof (save_literal_buffer) / sizeof (uint32_t),
                                                         true);
 
   if (literal_sizes != 0)

05.PORT-API.md

@@ -205,7 +205,7 @@ bool jerry_port_get_time_zone (jerry_time_zone_t *tz_p)
 /**
  * Default implementation of jerry_port_get_current_time.
  */
-double jerry_port_get_current_time ()
+double jerry_port_get_current_time (void)
 {
   struct timeval tv;