File 0850-erts-Fix-doxygen-formatting.patch of Package erlang

From f64e5a13080e97f92dcc9034d63f2c60e0ed3c4b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?John=20H=C3=B6gberg?= <john@erlang.org>
Date: Tue, 15 Oct 2019 12:00:20 +0200
Subject: [PATCH] erts: Fix doxygen formatting

doxygen only looks for tags in comments that start with `/**` or
`///`, tags inside plain comments are ignored.
---
 erts/emulator/beam/erl_db_catree.c        |  8 ++++----
 erts/emulator/beam/erl_db_tree.c          |  8 ++++----
 erts/emulator/beam/erl_db_util.h          |  6 +++---
 erts/emulator/beam/erl_lock_count.h       | 11 ++++++-----
 erts/emulator/beam/erl_lock_flags.h       |  4 ++--
 erts/emulator/nifs/common/prim_file_nif.h | 12 ++++++------
 erts/emulator/nifs/win32/win_prim_file.c  |  6 +++---
 erts/emulator/sys/common/erl_osenv.h      | 18 +++++++++---------
 8 files changed, 37 insertions(+), 36 deletions(-)

diff --git a/erts/emulator/beam/erl_lock_count.h b/erts/emulator/beam/erl_lock_count.h
index 0d47b16e0b..c061e7894d 100644
--- a/erts/emulator/beam/erl_lock_count.h
+++ b/erts/emulator/beam/erl_lock_count.h
@@ -78,7 +78,7 @@ typedef struct {
 } erts_lcnt_time_t;
 
 typedef struct {
-    /* @brief log2 array of nano seconds occurences */
+    /** @brief log2 array of nano seconds occurences */
     Uint32 ns[ERTS_LCNT_HISTOGRAM_SLOT_SIZE];
 } erts_lcnt_hist_t;
 
@@ -271,7 +271,7 @@ int erts_lcnt_check_ref_installed(erts_lcnt_ref_t *ref);
 
 erts_lcnt_lock_info_carrier_t *erts_lcnt_create_lock_info_carrier(int count);
 
-/* @brief Initializes the lock info at the given index.
+/** @brief Initializes the lock info at the given index.
  * @param id An immediate erlang term with whatever extra data you want to
  * identify this lock with.
  * @param flags The flags the lock itself was initialized with. Keep in mind
@@ -300,9 +300,10 @@ void erts_lcnt_pre_thr_init(void);
 void erts_lcnt_post_thr_init(void);
 void erts_lcnt_late_init(void);
 
-/* @brief Called after everything in the system has been initialized, including
- * the schedulers. This is mainly a backwards compatibility shim for matching
- * the old lcnt behavior where all lock counting was enabled by default. */
+/** @brief Called after everything in the system has been initialized,
+ * including the schedulers. This is mainly a backwards compatibility shim for
+ * matching the old lcnt behavior where all lock counting was enabled by
+ * default. */
 void erts_lcnt_post_startup(void);
 
 void erts_lcnt_thread_setup(void);
diff --git a/erts/emulator/beam/erl_lock_flags.h b/erts/emulator/beam/erl_lock_flags.h
index 2db133b598..9d2216eaf6 100644
--- a/erts/emulator/beam/erl_lock_flags.h
+++ b/erts/emulator/beam/erl_lock_flags.h
@@ -71,10 +71,10 @@
 typedef unsigned short erts_lock_flags_t;
 typedef unsigned short erts_lock_options_t;
 
-/* @brief Gets the type name of the lock, honoring the RW flag if supplied. */
+/** @brief Gets the type name of the lock, honoring the RW flag if supplied. */
 const char *erts_lock_flags_get_type_name(erts_lock_flags_t flags);
 
-/* @brief Gets a short-form description of the given lock options. (rw/r/w) */
+/** @brief Gets a short-form description of the given lock options. (rw/r/w) */
 const char *erts_lock_options_get_short_desc(erts_lock_options_t options);
 
 #endif /* ERTS_LOCK_FLAGS_H__ */
-- 
2.16.4