From 92e880f3b1635f2cf034db76de6c95cf8b1ccd82 Mon Sep 17 00:00:00 2001
From: John Wellbelove <john.wellbelove@etlcpp.com>
Date: Sat, 14 Oct 2023 21:34:39 +0100
Subject: [PATCH] #773 Return raw pointer for etl::multi_span::operator->()

---
 arduino/library-arduino.json                  |  2 +-
 arduino/library-arduino.properties            |  2 +-
 include/etl/generators/largest_generator.h    |  8 ++--
 include/etl/generators/smallest_generator.h   |  2 +-
 .../etl/generators/type_traits_generator.h    |  2 +-
 include/etl/largest.h                         |  2 +-
 include/etl/message_packet.h                  | 48 +++++++++----------
 include/etl/version.h                         |  2 +-
 library.json                                  |  2 +-
 library.properties                            |  2 +-
 support/Release notes.txt                     |  4 ++
 version.txt                                   |  2 +-
 12 files changed, 41 insertions(+), 37 deletions(-)

diff --git a/arduino/library-arduino.json b/arduino/library-arduino.json
index 3264a7d2d..822e28f84 100644
--- a/arduino/library-arduino.json
+++ b/arduino/library-arduino.json
@@ -1,6 +1,6 @@
 {
   "name": "Embedded Template Library - Arduino",
-  "version": "20.38.2",
+  "version": "20.38.4",
   "authors": {
     "name": "John Wellbelove",
     "email": "john.wellbelove@etlcpp.com"
diff --git a/arduino/library-arduino.properties b/arduino/library-arduino.properties
index 02282cd27..41ce4dfd1 100644
--- a/arduino/library-arduino.properties
+++ b/arduino/library-arduino.properties
@@ -1,5 +1,5 @@
 name=Embedded Template Library - Arduino
-version=20.38.2
+version=20.38.4
 author= John Wellbelove <john.wellbelove@etlcpp.com>
 maintainer=John Wellbelove <john.wellbelove@etlcpp.com>
 license=MIT
diff --git a/include/etl/generators/largest_generator.h b/include/etl/generators/largest_generator.h
index 40307bf23..a8cb40837 100644
--- a/include/etl/generators/largest_generator.h
+++ b/include/etl/generators/largest_generator.h
@@ -140,7 +140,7 @@ namespace etl
   cog.outl("/// Supports up to %s types." % NTypes)
   cog.outl("/// Defines 'value_type' which is the type of the largest parameter.")
   cog.outl("/// Defines 'size' which is the size of the largest parameter.")
-  cog.outl("///\ingroup largest")
+  cog.outl("///\\ingroup largest")
   cog.outl("//***************************************************************************")
   cog.out("template <typename T1, ")
   for n in range(2, int(NTypes)):
@@ -249,7 +249,7 @@ namespace etl
   cog.outl("/// Template to determine the largest alignment.")
   cog.outl("/// Supports up to %s types." % int(NTypes))
   cog.outl("/// Defines <b>value</b> which is the largest alignment of all the parameters.")
-  cog.outl("///\ingroup largest")
+  cog.outl("///\\ingroup largest")
   cog.outl("//***************************************************************************")
   cog.out("template <typename T1, ")
   for n in range(2, int(NTypes)):
@@ -309,7 +309,7 @@ namespace etl
   //***************************************************************************
   /// Defines a type that is as larger or larger than the specified type.
   /// Will return the specified type is there is not a larger type.
-  ///\ingroup largest
+  ///\\ingroup largest
   //***************************************************************************
   template <typename T>
   struct larger_int_type
@@ -407,7 +407,7 @@ namespace etl
   cog.outl("/// Template to determine the largest type, size and alignment.")
   cog.outl("/// Supports up to %s types." % NTypes)
   cog.outl("/// Defines <b>value</b> which is the largest type, size and alignment of all the parameters.")
-  cog.outl("///\ingroup largest")
+  cog.outl("///\\ingroup largest")
   cog.outl("//***************************************************************************")
   cog.out("template <typename T1, ")
   for n in range(2, int(NTypes)):
diff --git a/include/etl/generators/smallest_generator.h b/include/etl/generators/smallest_generator.h
index 2e1908c7e..064420db1 100644
--- a/include/etl/generators/smallest_generator.h
+++ b/include/etl/generators/smallest_generator.h
@@ -140,7 +140,7 @@ namespace etl
   cog.outl("/// Supports up to %s types." % NTypes)
   cog.outl("/// Defines 'value_type' which is the type of the smallest parameter.")
   cog.outl("/// Defines 'size' which is the size of the smallest parameter.")
-  cog.outl("///\ingroup smallest")
+  cog.outl("///\\ingroup smallest")
   cog.outl("//***************************************************************************")
   cog.out("template <typename T1, ")
   for n in range(2, int(NTypes)):
diff --git a/include/etl/generators/type_traits_generator.h b/include/etl/generators/type_traits_generator.h
index 4922d9db1..b22887fd4 100644
--- a/include/etl/generators/type_traits_generator.h
+++ b/include/etl/generators/type_traits_generator.h
@@ -1380,7 +1380,7 @@ typedef integral_constant<bool, true>  true_type;
   import cog
   cog.outl("//***************************************************************************")
   cog.outl("/// Template to determine if a type is one of a specified list.")
-  cog.outl("///\ingroup types")
+  cog.outl("///\\ingroup types")
   cog.outl("template <typename T,")
   cog.out("          ")
   cog.out("typename T1, ")
diff --git a/include/etl/largest.h b/include/etl/largest.h
index b3aec9ac0..0c52af2e1 100644
--- a/include/etl/largest.h
+++ b/include/etl/largest.h
@@ -261,7 +261,7 @@ namespace etl
   //***************************************************************************
   /// Defines a type that is as larger or larger than the specified type.
   /// Will return the specified type is there is not a larger type.
-  ///\ingroup largest
+  ///\\ingroup largest
   //***************************************************************************
   template <typename T>
   struct larger_int_type
diff --git a/include/etl/message_packet.h b/include/etl/message_packet.h
index 17ef11552..df4d6d29f 100644
--- a/include/etl/message_packet.h
+++ b/include/etl/message_packet.h
@@ -339,9 +339,9 @@ namespace etl
   //***************************************************************************
   // The definition for all 16 message types.
   //***************************************************************************
-  template <typename T1, typename T2 = void, typename T3 = void, typename T4 = void,
-            typename T5 = void, typename T6 = void, typename T7 = void, typename T8 = void,
-            typename T9 = void, typename T10 = void, typename T11 = void, typename T12 = void,
+  template <typename T1, typename T2 = void, typename T3 = void, typename T4 = void, 
+            typename T5 = void, typename T6 = void, typename T7 = void, typename T8 = void, 
+            typename T9 = void, typename T10 = void, typename T11 = void, typename T12 = void, 
             typename T13 = void, typename T14 = void, typename T15 = void, typename T16 = void>
   class message_packet
   {
@@ -634,9 +634,9 @@ namespace etl
   //***************************************************************************
   // Specialisation for 15 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
-            typename T9, typename T10, typename T11, typename T12,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
+            typename T9, typename T10, typename T11, typename T12, 
             typename T13, typename T14, typename T15>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, void>
   {
@@ -927,9 +927,9 @@ namespace etl
   //***************************************************************************
   // Specialisation for 14 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
-            typename T9, typename T10, typename T11, typename T12,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
+            typename T9, typename T10, typename T11, typename T12, 
             typename T13, typename T14>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, void, void>
   {
@@ -1218,9 +1218,9 @@ namespace etl
   //***************************************************************************
   // Specialisation for 13 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
-            typename T9, typename T10, typename T11, typename T12,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
+            typename T9, typename T10, typename T11, typename T12, 
             typename T13>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, void, void, void>
   {
@@ -1507,8 +1507,8 @@ namespace etl
   //***************************************************************************
   // Specialisation for 12 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
             typename T9, typename T10, typename T11, typename T12>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, void, void, void, void>
   {
@@ -1790,8 +1790,8 @@ namespace etl
   //***************************************************************************
   // Specialisation for 11 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
             typename T9, typename T10, typename T11>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, void, void, void, void, void>
   {
@@ -2071,8 +2071,8 @@ namespace etl
   //***************************************************************************
   // Specialisation for 10 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
             typename T9, typename T10>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, void, void, void, void, void, void>
   {
@@ -2350,8 +2350,8 @@ namespace etl
   //***************************************************************************
   // Specialisation for 9 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
-            typename T5, typename T6, typename T7, typename T8,
+  template <typename T1, typename T2, typename T3, typename T4, 
+            typename T5, typename T6, typename T7, typename T8, 
             typename T9>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, T9, void, void, void, void, void, void, void>
   {
@@ -2627,7 +2627,7 @@ namespace etl
   //***************************************************************************
   // Specialisation for 8 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
+  template <typename T1, typename T2, typename T3, typename T4, 
             typename T5, typename T6, typename T7, typename T8>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, T8, void, void, void, void, void, void, void, void>
   {
@@ -2898,7 +2898,7 @@ namespace etl
   //***************************************************************************
   // Specialisation for 7 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
+  template <typename T1, typename T2, typename T3, typename T4, 
             typename T5, typename T6, typename T7>
   class message_packet<T1, T2, T3, T4, T5, T6, T7, void, void, void, void, void, void, void, void, void>
   {
@@ -3167,7 +3167,7 @@ namespace etl
   //***************************************************************************
   // Specialisation for 6 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
+  template <typename T1, typename T2, typename T3, typename T4, 
             typename T5, typename T6>
   class message_packet<T1, T2, T3, T4, T5, T6, void, void, void, void, void, void, void, void, void, void>
   {
@@ -3434,7 +3434,7 @@ namespace etl
   //***************************************************************************
   // Specialisation for 5 message types.
   //***************************************************************************
-  template <typename T1, typename T2, typename T3, typename T4,
+  template <typename T1, typename T2, typename T3, typename T4, 
             typename T5>
   class message_packet<T1, T2, T3, T4, T5, void, void, void, void, void, void, void, void, void, void, void>
   {
diff --git a/include/etl/version.h b/include/etl/version.h
index f55495a02..66d517cd0 100644
--- a/include/etl/version.h
+++ b/include/etl/version.h
@@ -40,7 +40,7 @@ SOFTWARE.
 
 #define ETL_VERSION_MAJOR 20
 #define ETL_VERSION_MINOR 38
-#define ETL_VERSION_PATCH 3
+#define ETL_VERSION_PATCH 4
 
 #define ETL_VERSION       ETL_STRING(ETL_VERSION_MAJOR) "." ETL_STRING(ETL_VERSION_MINOR) "." ETL_STRING(ETL_VERSION_PATCH)
 #define ETL_VERSION_W     ETL_WIDE_STRING(ETL_VERSION_MAJOR) L"." ETL_WIDE_STRING(ETL_VERSION_MINOR) L"." ETL_WIDE_STRING(ETL_VERSION_PATCH)
diff --git a/library.json b/library.json
index 2f7ce90fb..9f7d179ec 100644
--- a/library.json
+++ b/library.json
@@ -1,6 +1,6 @@
 {
   "name": "Embedded Template Library",
-  "version": "20.38.3",
+  "version": "20.38.4",
   "authors": {
     "name": "John Wellbelove",
     "email": "john.wellbelove@etlcpp.com"
diff --git a/library.properties b/library.properties
index 29337c202..5d849ddaf 100644
--- a/library.properties
+++ b/library.properties
@@ -1,5 +1,5 @@
 name=Embedded Template Library
-version=20.38.3
+version=20.38.4
 author= John Wellbelove <john.wellbelove@etlcpp.com>
 maintainer=John Wellbelove <john.wellbelove@etlcpp.com>
 license=MIT
diff --git a/support/Release notes.txt b/support/Release notes.txt
index e546f0eaa..5bf9df98e 100644
--- a/support/Release notes.txt	
+++ b/support/Release notes.txt	
@@ -1,3 +1,7 @@
+===============================================================================
+20.38.4
+#773 Return raw pointer for etl::multi_span::operator->()
+
 ===============================================================================
 20.38.3
 #767 etl::pool silently produces unaligned allocations for types with stricter alignment requirements than built in types 
diff --git a/version.txt b/version.txt
index ab630adc2..f2655965a 100644
--- a/version.txt
+++ b/version.txt
@@ -1 +1 @@
-20.38.3
+20.38.4