Removed overly detailed comments.

src/interface.tcc

@@ -1,15 +1,5 @@
 #pragma once
 
-/*
- * Template library for exporting native C and C++ functions as remote
- * procedure calls.
- *
- * For more information about (variadic) templates:
- * \li http://www.drdobbs.com/cpp/extracting-function-parameter-and-return/240000586
- * \li https://eli.thegreenplace.net/2014/variadic-templates-in-c/
- * \li https://en.cppreference.com/w/cpp/language/parameter_pack
- */
-
 #include "rpcCall.tcc"
 #include "signature.tcc"
 
@@ -55,11 +45,6 @@ inline void describe_(Stream& io) {
  */
 template <class F, class D, class... Ts>
 void describe_(Stream& io, F f, D doc, Ts... args) {
-  /*
-   * The first two parameters `f` and `doc` are isolated and passed to
-   * `writeDescription_()`. Then a recursive call to process the remaining
-   * parameters is made.
-   */
   writeDescription_(io, f, doc);
   describe_(io, args...);
 }
@@ -90,12 +75,6 @@ inline void select_(Stream&, uint8_t, uint8_t) {}
  */
 template <class F, class D, class... Ts>
 void select_(Stream& io, uint8_t number, uint8_t depth, F f, D, Ts... args) {
-  /*
-   * The parameter `f` and its documentation string are isolated, discarding
-   * the latter. If the selected function is encountered (i.e., if `depth`
-   * equals `number`), function `f` is called. Otherwise, a new try is made
-   * recursively.
-   */
   if (depth == number) {
     rpcCall(io, f);
     return;
@@ -118,11 +97,6 @@ void select_(Stream& io, uint8_t number, uint8_t depth, F f, D, Ts... args) {
  */
 template <class... Ts>
 void interface(Stream& io, Ts... args) {
-  /*
-   * One byte is read into `command`, if the value equals `LIST_REQ_`, the
-   * list of functions is described. Otherwise, the function indexed by
-   * `command` is called.
-   */
   if (io.available()) {
     uint8_t command;
 

src/rpcCall.tcc

@@ -19,11 +19,6 @@
  */
 template <class T, class... Ts, class... Us>
 void call_(Stream& io, void (*)(), T (*f)(Ts...), Us&... args) {
-  /*
-   * All parameters have been collected since function pointer `*f_` has no
-   * parameter types. All values are now present in the `args` parameter
-   * pack.
-   */
   T data {f(args...)};
   rpcWrite(io, &data);
 }
@@ -83,13 +78,6 @@ void call_(
  */
 template <class T, class... Ts, class F, class... Us>
 void call_(Stream& io, void (*)(T, Ts...), F f, Us&... args) {
-  /*
-   * The first parameter type `T` is isolated from the function pointer. This
-   * type is used to instantiate the variable `data`, which is used to
-   * receive `sizeof(T)` bytes. This value is passed recursively to `call_()`
-   * function, adding it to the `args` parameter pack. The first parameter
-   * type `T` is removed from the function pointer in the recursive call.
-   */
   T data;
   rpcRead(io, &data);
 
@@ -158,11 +146,6 @@ void call_(Stream& io, void (*)(T*, Ts...), F f, Us&... args) {
  */
 template <class T, class... Ts>
 void rpcCall(Stream& io, T (*f)(Ts...)) {
-  /*
-   * A dummy function pointer is prepared, which will be used to isolate
-   * parameter types. The return type of this function pointer is removed to
-   * avoid unneeded template expansion.
-   */
   void (*f_)(Ts...) {};
   call_(io, f_, f);
 }

src/signature.tcc

@@ -20,12 +20,6 @@ inline void parameterTypes_(Stream&, void (*)()) {}
  */
 template <class T, class... Ts>
 void parameterTypes_(Stream& io, void (*)(T, Ts...)) {
-  /*
-   * The first parameter type `T` is isolated from function pointer. This
-   * type is used to instantiate the variable `data`, which is passed to
-   * `rpcTypeOf()` to encode its type. The first parameter type `T` is
-   * removed from the function pointer in the recursive call.
-   */
   T data {};
   rpcWrite(io, ' ');
   rpcTypeOf(io, data);
@@ -55,11 +49,6 @@ void parameterTypes_(Stream& io, void (*)(T&, Ts...)) {
  */
 template <class T, class... Ts>
 void signature(Stream& io, T (*)(Ts...)) {
-  /*
-   * A dummy function pointer is prepared, which will be used to isolate
-   * parameter types. The return type of this function pointer is removed to
-   * avoid unneeded template expansion.
-   */
   T data {};
   rpcTypeOf(io, data);
   rpcWrite(io, ':');

src/types.tcc

@@ -96,11 +96,6 @@ inline void rpcTypeOf(Stream& io, char const*) {
   rpcWrite(io, 's');
 }
 
-/*
- * The `int` and `double` type sizes vary between boards, see:
- * https://www.arduino.cc/reference/en/language/variables/data-types/
- */
-
 /*! \ingroup types
  * \copydoc rpcTypeOf(Stream&, bool) */
 inline void rpcTypeOf(Stream& io, int) {