diff --git a/src/btstack_defines.h b/src/btstack_defines.h
index bf0777812..ce27a0081 100644
--- a/src/btstack_defines.h
+++ b/src/btstack_defines.h
@@ -2585,7 +2585,7 @@ typedef uint8_t sm_key_t[16];
  * @format 1211
  * @param subevent_code
  * @param con_handle
- * @param measurement_type  // 0 - force magnitude, 1 - torque magnitude, see cycling_power_sensor_measurement_context_t
+ * @param measurement_type 0 - force magnitude, 1 - torque magnitude, see cycling_power_sensor_measurement_context_t
  * @param is_enhanced
 */
 #define GATTSERVICE_SUBEVENT_CYCLING_POWER_START_CALIBRATION               0x01
@@ -2880,7 +2880,7 @@ typedef uint8_t sm_key_t[16];
  * @param element_index
  * @param model_identifier
  * @param present_value
- * @param target_value       // optinal, if value > 0, than remaining_time_ms must be read
+ * @param target_value       optional, if value > 0, than remaining_time_ms must be read
  * @param remaining_time_ms  
  */
 #define MESH_SUBEVENT_GENERIC_ON_OFF_STATUS                                           0x31
@@ -2891,7 +2891,7 @@ typedef uint8_t sm_key_t[16];
  * @param element_index
  * @param model_identifier
  * @param present_value
- * @param target_value       // optinal, if value > 0, than remaining_time_ms must be read
+ * @param target_value       optional, if value > 0, than remaining_time_ms must be read
  * @param remaining_time_ms  
  */
 #define MESH_SUBEVENT_GENERIC_LEVEL_STATUS                                           0x32
diff --git a/src/classic/rfcomm.h b/src/classic/rfcomm.h
index ff0edcc7e..83a482c00 100644
--- a/src/classic/rfcomm.h
+++ b/src/classic/rfcomm.h
@@ -406,7 +406,7 @@ uint16_t  rfcomm_get_max_frame_size(uint16_t rfcomm_cid);
  *     rfcomm_reserve_packet_buffer();
  *     uint8_t * buffer = rfcomm_get_outgoing_buffer();
  *     uint16_t buffer_size = rfcomm_get_max_frame_size(cid);
- *     // .. setup data in buffer with len
+ *     .. setup data in buffer with len ..
  *     rfcomm_send_prepared(cid, len)
  * }
  */