From 6fe006a1f661288ae7f5c875abda96d0bc7e25a0 Mon Sep 17 00:00:00 2001
From: Yonggang Luo <luoyonggang@gmail.com>
Date: Thu, 10 Feb 2022 03:59:02 +0800
Subject: [PATCH] Improve the jerry port api documents.

Notable changes:
  - Remove the comments in port impl, that's easily getting to in-consistence
  - Sync the jerryscript-port.h and 05.PORT-API.md
  - Fixes the invalid comment in port codes

JerryScript-DCO-1.0-Signed-off-by: Yonggang Luo luoyonggang@gmail.com
---
 docs/05.PORT-API.md                           |  2 +
 jerry-core/include/jerryscript-port.h         |  4 +-
 jerry-port/common/jerry-port-context.c        | 15 -------
 jerry-port/common/jerry-port-fs.c             | 39 ++++--------------
 jerry-port/common/jerry-port-io.c             | 33 ++-------------
 jerry-port/common/jerry-port-process.c        |  6 +--
 jerry-port/unix/jerry-port-unix-date.c        | 11 -----
 jerry-port/unix/jerry-port-unix-fs.c          | 24 ++---------
 jerry-port/unix/jerry-port-unix-process.c     |  5 +--
 jerry-port/win/jerry-port-win-date.c          | 15 +------
 jerry-port/win/jerry-port-win-fs.c            | 19 +--------
 jerry-port/win/jerry-port-win-process.c       |  5 +--
 targets/baremetal-sdk/esp-idf/jerry_port.c    | 40 ++-----------------
 .../esp8266-rtos-sdk/user/jerry_port.c        | 18 +--------
 targets/os/mbedos5/jerry-port.cpp             | 18 +--------
 targets/os/nuttx/jerry-port.c                 | 26 +-----------
 targets/os/riot/source/jerry-port.c           | 10 -----
 targets/os/zephyr/src/jerry-port.c            | 24 +----------
 18 files changed, 33 insertions(+), 281 deletions(-)

diff --git a/docs/05.PORT-API.md b/docs/05.PORT-API.md
index 4577f598e2..955012e0ea 100644
--- a/docs/05.PORT-API.md
+++ b/docs/05.PORT-API.md
@@ -112,6 +112,8 @@ void jerry_port_context_free (void);
  *
  * The implementation can decide whether error and debug messages are logged to
  * the console, or saved to a database or to a file.
+ *
+ * @param message_p: the message to log.
  */
 void jerry_port_log (const char *message_p);
 ```
diff --git a/jerry-core/include/jerryscript-port.h b/jerry-core/include/jerryscript-port.h
index 7317a12b2a..3797cffccc 100644
--- a/jerry-core/include/jerryscript-port.h
+++ b/jerry-core/include/jerryscript-port.h
@@ -142,6 +142,8 @@ void jerry_port_context_free (void);
  *
  * The implementation can decide whether error and debug messages are logged to
  * the console, or saved to a database or to a file.
+ *
+ * @param message_p: the message to log.
  */
 void jerry_port_log (const char *message_p);
 
@@ -246,7 +248,7 @@ void jerry_port_path_free (jerry_char_t *path_p);
 jerry_size_t jerry_port_path_base (const jerry_char_t *path_p);
 
 /**
- * Open a source file and read the content into a buffer.
+ * Open a source file and read its contents into a buffer.
  *
  * When the source file is no longer needed by the caller, the returned pointer will be passed to
  * `jerry_port_source_free`, which can be used to finalize the buffer.
diff --git a/jerry-port/common/jerry-port-context.c b/jerry-port/common/jerry-port-context.c
index 2aa65b82b3..cf76584919 100644
--- a/jerry-port/common/jerry-port-context.c
+++ b/jerry-port/common/jerry-port-context.c
@@ -27,13 +27,6 @@
  */
 static jerry_context_t *current_context_p = NULL;
 
-/**
- * Allocate a new external context.
- *
- * @param context_size: requested context size
- *
- * @return total allcoated size
- */
 size_t JERRY_ATTR_WEAK
 jerry_port_context_alloc (size_t context_size)
 {
@@ -43,20 +36,12 @@ jerry_port_context_alloc (size_t context_size)
   return total_size;
 } /* jerry_port_context_alloc */
 
-/**
- * Get the current context.
- *
- * @return the pointer to the current context
- */
 jerry_context_t *JERRY_ATTR_WEAK
 jerry_port_context_get (void)
 {
   return current_context_p;
 } /* jerry_port_context_get */
 
-/**
- * Free the currently allocated external context.
- */
 void JERRY_ATTR_WEAK
 jerry_port_context_free (void)
 {
diff --git a/jerry-port/common/jerry-port-fs.c b/jerry-port/common/jerry-port-fs.c
index d3eecce7d3..b249213822 100644
--- a/jerry-port/common/jerry-port-fs.c
+++ b/jerry-port/common/jerry-port-fs.c
@@ -41,13 +41,8 @@ jerry_port_get_file_size (FILE *file_p) /**< opened file */
   return (jerry_size_t) size;
 } /* jerry_port_get_file_size */
 
-/**
- * Opens file with the given path and reads its source.
- * @return the source of the file
- */
 jerry_char_t *JERRY_ATTR_WEAK
-jerry_port_source_read (const char *file_name_p, /**< file name */
-                        jerry_size_t *out_size_p) /**< [out] read bytes */
+jerry_port_source_read (const char *file_name_p, jerry_size_t *out_size_p)
 {
   /* TODO(dbatyai): Temporary workaround for nuttx target
    * The nuttx target builds and copies the jerryscript libraries as a separate build step, which causes linking issues
@@ -92,11 +87,8 @@ jerry_port_source_read (const char *file_name_p, /**< file name */
   return buffer_p;
 } /* jerry_port_source_read */
 
-/**
- * Release the previously opened file's content.
- */
 void JERRY_ATTR_WEAK
-jerry_port_source_free (uint8_t *buffer_p) /**< buffer to free */
+jerry_port_source_free (uint8_t *buffer_p)
 {
   free (buffer_p);
 } /* jerry_port_source_free */
@@ -107,15 +99,8 @@ jerry_port_source_free (uint8_t *buffer_p) /**< buffer to free */
  */
 #if defined(JERRY_WEAK_SYMBOL_SUPPORT) && !(defined(__unix__) || defined(__APPLE__) || defined(_WIN32))
 
-/**
- * Normalize a file path.
- *
- * @return a newly allocated buffer with the normalized path if the operation is successful,
- *         NULL otherwise
- */
 jerry_char_t *JERRY_ATTR_WEAK
-jerry_port_path_normalize (const jerry_char_t *path_p, /**< input path */
-                           jerry_size_t path_size) /**< size of the path */
+jerry_port_path_normalize (const jerry_char_t *path_p, jerry_size_t path_size)
 {
   jerry_char_t *buffer_p = (jerry_char_t *) malloc (path_size + 1);
 
@@ -128,26 +113,16 @@ jerry_port_path_normalize (const jerry_char_t *path_p, /**< input path */
   memcpy (buffer_p, path_p, path_size + 1);
 
   return buffer_p;
-} /* jerry_port_normalize_path */
+} /* jerry_port_path_normalize */
 
-/**
- * Free a path buffer returned by jerry_port_path_normalize.
- *
- * @param path_p: the path to free
- */
 void JERRY_ATTR_WEAK
 jerry_port_path_free (jerry_char_t *path_p)
 {
   free (path_p);
-} /* jerry_port_normalize_path */
+} /* jerry_port_path_free */
 
-/**
- * Computes the end of the directory part of a path.
- *
- * @return end of the directory part of a path.
- */
 jerry_size_t JERRY_ATTR_WEAK
-jerry_port_path_base (const jerry_char_t *path_p) /**< path */
+jerry_port_path_base (const jerry_char_t *path_p)
 {
   const jerry_char_t *basename_p = (jerry_char_t *) strrchr ((char *) path_p, '/') + 1;
 
@@ -157,6 +132,6 @@ jerry_port_path_base (const jerry_char_t *path_p) /**< path */
   }
 
   return (jerry_size_t) (basename_p - path_p);
-} /* jerry_port_get_directory_end */
+} /* jerry_port_path_base */
 
 #endif /* defined(JERRY_WEAK_SYMBOL_SUPPORT) && !(defined(__unix__) || defined(__APPLE__) || defined(_WIN32)) */
diff --git a/jerry-port/common/jerry-port-io.c b/jerry-port/common/jerry-port-io.c
index 593d744742..2bce5cedb1 100644
--- a/jerry-port/common/jerry-port-io.c
+++ b/jerry-port/common/jerry-port-io.c
@@ -19,47 +19,27 @@
 
 #include "jerryscript-port.h"
 
-/**
- * Default implementation of jerry_port_log. Prints log messages to stderr.
- */
 void JERRY_ATTR_WEAK
-jerry_port_log (const char *message_p) /**< message */
+jerry_port_log (const char *message_p)
 {
   fputs (message_p, stderr);
 } /* jerry_port_log */
 
-/**
- * Default implementation of jerry_port_print_byte. Uses 'putchar' to
- * print a single character to standard output.
- */
 void JERRY_ATTR_WEAK
-jerry_port_print_byte (jerry_char_t byte) /**< the character to print */
+jerry_port_print_byte (jerry_char_t byte)
 {
   putchar (byte);
 } /* jerry_port_print_byte */
 
-/**
- * Default implementation of jerry_port_print_buffer. Uses 'jerry_port_print_byte' to
- * print characters of the input buffer.
- */
 void JERRY_ATTR_WEAK
-jerry_port_print_buffer (const jerry_char_t *buffer_p, /**< string buffer */
-                         jerry_size_t buffer_size) /**< string size*/
+jerry_port_print_buffer (const jerry_char_t *buffer_p, jerry_size_t buffer_size)
 {
   for (jerry_size_t i = 0; i < buffer_size; i++)
   {
     jerry_port_print_byte (buffer_p[i]);
   }
-} /* jerry_port_print_byte */
+} /* jerry_port_print_buffer */
 
-/**
- * Read a line from standard input as a zero-terminated string.
- *
- * @param out_size_p: length of the string
- *
- * @return pointer to the buffer storing the string,
- *         or NULL if end of input
- */
 jerry_char_t *JERRY_ATTR_WEAK
 jerry_port_line_read (jerry_size_t *out_size_p)
 {
@@ -94,11 +74,6 @@ jerry_port_line_read (jerry_size_t *out_size_p)
   }
 } /* jerry_port_line_read */
 
-/**
- * Free a line buffer allocated by jerry_port_line_read
- *
- * @param buffer_p: buffer that has been allocated by jerry_port_line_read
- */
 void JERRY_ATTR_WEAK
 jerry_port_line_free (jerry_char_t *buffer_p)
 {
diff --git a/jerry-port/common/jerry-port-process.c b/jerry-port/common/jerry-port-process.c
index 25c6f9027d..cb6f699acf 100644
--- a/jerry-port/common/jerry-port-process.c
+++ b/jerry-port/common/jerry-port-process.c
@@ -17,12 +17,8 @@
 
 #include "jerryscript-port.h"
 
-/**
- * Default implementation of jerry_port_fatal. Calls 'abort' if exit code is
- * non-zero, 'exit' otherwise.
- */
 void JERRY_ATTR_WEAK
-jerry_port_fatal (jerry_fatal_code_t code) /**< cause of error */
+jerry_port_fatal (jerry_fatal_code_t code)
 {
   if (code != 0 && code != JERRY_FATAL_OUT_OF_MEMORY)
   {
diff --git a/jerry-port/unix/jerry-port-unix-date.c b/jerry-port/unix/jerry-port-unix-date.c
index 2e895ab67f..9a94fbddf7 100644
--- a/jerry-port/unix/jerry-port-unix-date.c
+++ b/jerry-port/unix/jerry-port-unix-date.c
@@ -20,12 +20,6 @@
 #include <sys/time.h>
 #include <time.h>
 
-/**
- * Default implementation of jerry_port_local_tza.
- *
- * @return offset between UTC and local time at the given unix timestamp, if
- *         available. Otherwise, returns 0, assuming UTC time.
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -53,11 +47,6 @@ jerry_port_local_tza (double unix_ms)
 #endif /* HAVE_TM_GMTOFF */
 } /* jerry_port_local_tza */
 
-/**
- * Default implementation of jerry_port_current_time.
- *
- * @return milliseconds since Unix epoch
- */
 double
 jerry_port_current_time (void)
 {
diff --git a/jerry-port/unix/jerry-port-unix-fs.c b/jerry-port/unix/jerry-port-unix-fs.c
index d610a7e290..278b34794f 100644
--- a/jerry-port/unix/jerry-port-unix-fs.c
+++ b/jerry-port/unix/jerry-port-unix-fs.c
@@ -20,44 +20,26 @@
 #include <stdlib.h>
 #include <string.h>
 
-/**
- * Normalize a file path using realpath.
- *
- * @param path_p: input path
- * @param path_size: input path size
- *
- * @return a newly allocated buffer with the normalized path if the operation is successful,
- *         NULL otherwise
- */
 jerry_char_t *
-jerry_port_path_normalize (const jerry_char_t *path_p, /**< input path */
-                           jerry_size_t path_size) /**< size of the path */
+jerry_port_path_normalize (const jerry_char_t *path_p, jerry_size_t path_size)
 {
   (void) path_size;
 
   return (jerry_char_t *) realpath ((char *) path_p, NULL);
 } /* jerry_port_path_normalize */
 
-/**
- * Free a path buffer returned by jerry_port_path_normalize.
- */
 void
 jerry_port_path_free (jerry_char_t *path_p)
 {
   free (path_p);
 } /* jerry_port_path_free */
 
-/**
- * Computes the end of the directory part of a path.
- *
- * @return end of the directory part of a path.
- */
 jerry_size_t JERRY_ATTR_WEAK
-jerry_port_path_base (const jerry_char_t *path_p) /**< path */
+jerry_port_path_base (const jerry_char_t *path_p)
 {
   const jerry_char_t *basename_p = (jerry_char_t *) strrchr ((char *) path_p, '/') + 1;
 
   return (jerry_size_t) (basename_p - path_p);
-} /* jerry_port_get_directory_end */
+} /* jerry_port_path_base */
 
 #endif /* defined(__unix__) || defined(__APPLE__) */
diff --git a/jerry-port/unix/jerry-port-unix-process.c b/jerry-port/unix/jerry-port-unix-process.c
index b08caaf247..ebef05e071 100644
--- a/jerry-port/unix/jerry-port-unix-process.c
+++ b/jerry-port/unix/jerry-port-unix-process.c
@@ -25,11 +25,8 @@
 
 #include <unistd.h>
 
-/**
- * Default implementation of jerry_port_sleep, uses 'usleep'.
- */
 void
-jerry_port_sleep (uint32_t sleep_time) /**< milliseconds to sleep */
+jerry_port_sleep (uint32_t sleep_time)
 {
   usleep ((useconds_t) sleep_time * 1000);
 } /* jerry_port_sleep */
diff --git a/jerry-port/win/jerry-port-win-date.c b/jerry-port/win/jerry-port-win-date.c
index 6d82f1514e..9682ace927 100644
--- a/jerry-port/win/jerry-port-win-date.c
+++ b/jerry-port/win/jerry-port-win-date.c
@@ -44,7 +44,7 @@ unix_time_to_filetime (double t, LPFILETIME ft_p)
 
   ft_p->dwLowDateTime = (DWORD) ll;
   ft_p->dwHighDateTime = (DWORD) (ll >> 32);
-} /* unix_time_to_file_time */
+} /* unix_time_to_filetime */
 
 /**
  * Convert a FILETIME to a unix time value.
@@ -58,14 +58,8 @@ filetime_to_unix_time (LPFILETIME ft_p)
   date.HighPart = ft_p->dwHighDateTime;
   date.LowPart = ft_p->dwLowDateTime;
   return (double) (((LONGLONG) date.QuadPart - UNIX_EPOCH_IN_TICKS) / TICKS_PER_MS);
-} /* FileTimeToUnixTimeMs */
+} /* filetime_to_unix_time */
 
-/**
- * Default implementation of jerry_port_local_tza.
- *
- * @return offset between UTC and local time at the given unix timestamp, if
- *         available. Otherwise, returns 0, assuming UTC time.
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -86,11 +80,6 @@ jerry_port_local_tza (double unix_ms)
   return 0;
 } /* jerry_port_local_tza */
 
-/**
- * Default implementation of jerry_port_current_time.
- *
- * @return milliseconds since Unix epoch
- */
 double
 jerry_port_current_time (void)
 {
diff --git a/jerry-port/win/jerry-port-win-fs.c b/jerry-port/win/jerry-port-win-fs.c
index c0f18a9ec7..b55f0cd44d 100644
--- a/jerry-port/win/jerry-port-win-fs.c
+++ b/jerry-port/win/jerry-port-win-fs.c
@@ -20,37 +20,20 @@
 #include <stdlib.h>
 #include <string.h>
 
-/**
- * Normalize a file path.
- *
- * @return a newly allocated buffer with the normalized path if the operation is successful,
- *         NULL otherwise
- */
 jerry_char_t *
-jerry_port_path_normalize (const jerry_char_t *path_p, /**< input path */
-                           jerry_size_t path_size) /**< size of the path */
+jerry_port_path_normalize (const jerry_char_t *path_p, jerry_size_t path_size)
 {
   (void) path_size;
 
   return (jerry_char_t *) _fullpath (NULL, path_p, _MAX_PATH);
 } /* jerry_port_path_normalize */
 
-/**
- * Free a path buffer returned by jerry_port_path_normalize.
- */
 void
 jerry_port_path_free (jerry_char_t *path_p)
 {
   free (path_p);
 } /* jerry_port_path_free */
 
-/**
- * Get the end of the directory part of the input path.
- *
- * @param path_p: input zero-terminated path string
- *
- * @return offset of the directory end in the input path string
- */
 jerry_size_t
 jerry_port_path_base (const jerry_char_t *path_p)
 {
diff --git a/jerry-port/win/jerry-port-win-process.c b/jerry-port/win/jerry-port-win-process.c
index c4949a2bf5..43fa0ec841 100644
--- a/jerry-port/win/jerry-port-win-process.c
+++ b/jerry-port/win/jerry-port-win-process.c
@@ -18,11 +18,8 @@
 
 #include <windows.h>
 
-/**
- * Default implementation of jerry_port_sleep, uses 'Sleep'.
- */
 void
-jerry_port_sleep (uint32_t sleep_time) /**< milliseconds to sleep */
+jerry_port_sleep (uint32_t sleep_time)
 {
   Sleep (sleep_time);
 } /* jerry_port_sleep */
diff --git a/targets/baremetal-sdk/esp-idf/jerry_port.c b/targets/baremetal-sdk/esp-idf/jerry_port.c
index 6eba60cfe3..3d31208e4d 100644
--- a/targets/baremetal-sdk/esp-idf/jerry_port.c
+++ b/targets/baremetal-sdk/esp-idf/jerry_port.c
@@ -30,35 +30,22 @@
 
 static const char TAG[] = "JS";
 
-/**
- * Default implementation of jerry_port_fatal. Calls 'abort' if exit code is
- * non-zero, 'exit' otherwise.
- */
 void
-jerry_port_fatal (jerry_fatal_code_t code) /**< cause of error */
+jerry_port_fatal (jerry_fatal_code_t code)
 {
   ESP_LOGE (TAG, "Fatal error %d", code);
   vTaskSuspend (NULL);
   abort ();
 } /* jerry_port_fatal */
 
-/**
- * Default implementation of jerry_port_sleep. Uses 'nanosleep' or 'usleep' if
- * available on the system, does nothing otherwise.
- */
 void
-jerry_port_sleep (uint32_t sleep_time) /**< milliseconds to sleep */
+jerry_port_sleep (uint32_t sleep_time)
 {
   vTaskDelay (sleep_time / portTICK_PERIOD_MS);
 } /* jerry_port_sleep */
 
-/**
- * Opens file with the given path and reads its source.
- * @return the source of the file
- */
 jerry_char_t *
-jerry_port_source_read (const char *file_name_p, /**< file name */
-                        jerry_size_t *out_size_p) /**< [out] read bytes */
+jerry_port_source_read (const char *file_name_p, jerry_size_t *out_size_p)
 {
   FILE *file_p = fopen (file_name_p, "rb");
 
@@ -93,23 +80,12 @@ jerry_port_source_read (const char *file_name_p, /**< file name */
   return buffer_p;
 } /* jerry_port_source_read */
 
-/**
- * Release the previously opened file's content.
- */
 void
-jerry_port_source_free (uint8_t *buffer_p) /**< buffer to free */
+jerry_port_source_free (uint8_t *buffer_p)
 {
   free (buffer_p);
 } /* jerry_port_source_free */
 
-/**
- * Default implementation of jerry_port_local_tza. Uses the 'tm_gmtoff' field
- * of 'struct tm' (a GNU extension) filled by 'localtime_r' if available on the
- * system, does nothing otherwise.
- *
- * @return offset between UTC and local time at the given unix timestamp, if
- *         available. Otherwise, returns 0, assuming UTC time.
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -122,14 +98,6 @@ jerry_port_local_tza (double unix_ms)
   return -atoi (buf) * 3600 * 1000 / 100;
 } /* jerry_port_local_tza */
 
-/**
- * Default implementation of jerry_port_current_time. Uses 'gettimeofday' if
- * available on the system, does nothing otherwise.
- *
- * @return milliseconds since Unix epoch - if 'gettimeofday' is available and
- *                                         executed successfully,
- *         0 - otherwise.
- */
 double
 jerry_port_current_time (void)
 {
diff --git a/targets/baremetal-sdk/esp8266-rtos-sdk/user/jerry_port.c b/targets/baremetal-sdk/esp8266-rtos-sdk/user/jerry_port.c
index f88daf68d3..a81f1cf836 100644
--- a/targets/baremetal-sdk/esp8266-rtos-sdk/user/jerry_port.c
+++ b/targets/baremetal-sdk/esp8266-rtos-sdk/user/jerry_port.c
@@ -21,18 +21,12 @@
 
 #include "esp_common.h"
 
-/**
- * Provide log message implementation for the engine.
- */
 void
-jerry_port_log (const char *message_p) /**< message */
+jerry_port_log (const char *message_p)
 {
   fputs (message_p, stderr);
 } /* jerry_port_log */
 
-/**
- * Provide fatal message implementation for the engine.
- */
 void
 jerry_port_fatal (jerry_fatal_code_t code)
 {
@@ -45,11 +39,6 @@ jerry_port_fatal (jerry_fatal_code_t code)
   }
 } /* jerry_port_fatal */
 
-/**
- * Implementation of jerry_port_current_time.
- *
- * @return current timer's counter value in milliseconds
- */
 double
 jerry_port_current_time (void)
 {
@@ -57,11 +46,6 @@ jerry_port_current_time (void)
   return (double) rtc_time;
 } /* jerry_port_current_time */
 
-/**
- * Dummy function to get the time zone adjustment.
- *
- * @return 0
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
diff --git a/targets/os/mbedos5/jerry-port.cpp b/targets/os/mbedos5/jerry-port.cpp
index 9ba1383c48..bdd88cf3bf 100644
--- a/targets/os/mbedos5/jerry-port.cpp
+++ b/targets/os/mbedos5/jerry-port.cpp
@@ -20,20 +20,14 @@
 
 #include "mbed.h"
 
-/**
- * Aborts the program.
- */
 void
 jerry_port_fatal (jerry_fatal_code_t code)
 {
   exit ((int) code);
 } /* jerry_port_fatal */
 
-/**
- * Provide log message implementation for the engine.
- */
 void
-jerry_port_log (const char *message_p) /**< message */
+jerry_port_log (const char *message_p)
 {
   while (*message_p != '\0')
   {
@@ -47,11 +41,6 @@ jerry_port_log (const char *message_p) /**< message */
   }
 } /* jerry_port_log */
 
-/**
- * Dummy function to get the time zone adjustment.
- *
- * @return 0
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -60,11 +49,6 @@ jerry_port_local_tza (double unix_ms)
   return 0;
 } /* jerry_port_local_tza */
 
-/**
- * Implementation of jerry_port_current_time.
- *
- * @return current timer's counter value in milliseconds
- */
 double
 jerry_port_current_time (void)
 {
diff --git a/targets/os/nuttx/jerry-port.c b/targets/os/nuttx/jerry-port.c
index c4f65a44a6..cdc57f67ce 100644
--- a/targets/os/nuttx/jerry-port.c
+++ b/targets/os/nuttx/jerry-port.c
@@ -19,23 +19,12 @@
 
 #include "jerryscript-port.h"
 
-/**
- * Default implementation of jerry_port_log. Prints log messages to stderr.
- */
 void
-jerry_port_log (const char *message_p) /**< message */
+jerry_port_log (const char *message_p)
 {
   (void) message_p;
 } /* jerry_port_log */
 
-/**
- * Read a line from standard input as a zero-terminated string.
- *
- * @param out_size_p: length of the string
- *
- * @return pointer to the buffer storing the string,
- *         or NULL if end of input
- */
 jerry_char_t *
 jerry_port_line_read (jerry_size_t *out_size_p)
 {
@@ -43,20 +32,12 @@ jerry_port_line_read (jerry_size_t *out_size_p)
   return NULL;
 } /* jerry_port_line_read */
 
-/**
- * Aborts the program.
- */
 void
 jerry_port_fatal (jerry_fatal_code_t code)
 {
   exit ((int) code);
 } /* jerry_port_fatal */
 
-/**
- * Dummy function to get the time zone adjustment.
- *
- * @return 0
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -66,11 +47,6 @@ jerry_port_local_tza (double unix_ms)
   return 0;
 } /* jerry_port_local_tza */
 
-/**
- * Dummy function to get the current time.
- *
- * @return 0
- */
 double
 jerry_port_current_time (void)
 {
diff --git a/targets/os/riot/source/jerry-port.c b/targets/os/riot/source/jerry-port.c
index bd7192c6f5..122e240306 100644
--- a/targets/os/riot/source/jerry-port.c
+++ b/targets/os/riot/source/jerry-port.c
@@ -18,11 +18,6 @@
 
 #include "jerryscript-port.h"
 
-/**
- * Dummy function to get the time zone adjustment.
- *
- * @return 0
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -32,11 +27,6 @@ jerry_port_local_tza (double unix_ms)
   return 0;
 } /* jerry_port_local_tza */
 
-/**
- * Dummy function to get the current time.
- *
- * @return 0
- */
 double
 jerry_port_current_time (void)
 {
diff --git a/targets/os/zephyr/src/jerry-port.c b/targets/os/zephyr/src/jerry-port.c
index de5df897d7..2f083ddfa0 100644
--- a/targets/os/zephyr/src/jerry-port.c
+++ b/targets/os/zephyr/src/jerry-port.c
@@ -22,20 +22,12 @@
 
 #include "getline-zephyr.h"
 
-/**
- * Aborts the program.
- */
 void
 jerry_port_fatal (jerry_fatal_code_t code)
 {
   exit ((int) code);
 } /* jerry_port_fatal */
 
-/**
- * Dummy function to get the time zone adjustment.
- *
- * @return 0
- */
 int32_t
 jerry_port_local_tza (double unix_ms)
 {
@@ -45,11 +37,6 @@ jerry_port_local_tza (double unix_ms)
   return 0;
 } /* jerry_port_local_tza */
 
-/**
- * Dummy function to get the current time.
- *
- * @return 0
- */
 double
 jerry_port_current_time (void)
 {
@@ -57,18 +44,12 @@ jerry_port_current_time (void)
   return (double) ms;
 } /* jerry_port_current_time */
 
-/**
- * Provide implementation of jerry_port_sleep.
- */
 void
-jerry_port_sleep (uint32_t sleep_time) /**< milliseconds to sleep */
+jerry_port_sleep (uint32_t sleep_time)
 {
   k_usleep ((useconds_t) sleep_time * 1000);
 } /* jerry_port_sleep */
 
-/**
- * Read line from stdin
- */
 jerry_char_t *
 jerry_port_line_read (jerry_size_t *out_size_p)
 {
@@ -78,9 +59,6 @@ jerry_port_line_read (jerry_size_t *out_size_p)
   return (jerry_char_t *) line_p;
 } /* jerry_port_line_read */
 
-/**
- * Free line, no-op.
- */
 void
 jerry_port_line_free (jerry_char_t *line_p)
 {