diff --git a/apps/shell/shell-download.c b/apps/shell/shell-download.c
index 86ad20207..1da5ad51a 100644
--- a/apps/shell/shell-download.c
+++ b/apps/shell/shell-download.c
@@ -33,7 +33,7 @@
 /**
  * \file Shell command for downloading files from a remote node.
  * Example usage:
- * 'download <node addr> <filename> | write <local_filename'.
+ * 'download \<node addr\> \<filename\> | write \<local_filename\>'.
  *
  * \author Luca Mottola <luca@sics.se>, Fredrik Osterlind <fros@sics.se>
  */
diff --git a/core/ctk/ctk-draw.h b/core/ctk/ctk-draw.h
index cb136a004..2f5cb8816 100644
--- a/core/ctk/ctk-draw.h
+++ b/core/ctk/ctk-draw.h
@@ -319,7 +319,7 @@ extern unsigned char ctk_draw_windowborder_width,
 /**
  * The character used for the Return/Enter key.
  *
- * \define #define CH_ENTER '\n'
+ * \#define CH_ENTER '\n'
  */
 
 /**
diff --git a/core/net/ipv6/sicslowpan.h b/core/net/ipv6/sicslowpan.h
index a46229b02..4dcb2ae11 100644
--- a/core/net/ipv6/sicslowpan.h
+++ b/core/net/ipv6/sicslowpan.h
@@ -234,7 +234,7 @@ struct sicslowpan_addr_context {
  * \brief check whether we can compress the IID in
  * address 'a' to 16 bits.
  * This is used for unicast addresses only, and is true
- * if the address is on the format <PREFIX>::0000:00ff:fe00:XXXX
+ * if the address is on the format \<PREFIX\>::0000:00ff:fe00:XXXX
  * NOTE: we currently assume 64-bits prefixes
  */
 #define sicslowpan_is_iid_16_bit_compressable(a) \
diff --git a/core/sys/cc.h b/core/sys/cc.h
index 53a5af4db..90ef3e710 100644
--- a/core/sys/cc.h
+++ b/core/sys/cc.h
@@ -133,7 +133,7 @@
  * strings.
  *
  * We need use two macros (CC_CONCAT and CC_CONCAT2) in order to allow
- * concatenation of two #defined macros.
+ * concatenation of two \#defined macros.
  */
 #define CC_CONCAT(s1, s2) CC_CONCAT2(s1, s2)