diff --git a/ASTVisitor.h b/ASTVisitor.h
index a667ad392..e4818ee27 100644
--- a/ASTVisitor.h
+++ b/ASTVisitor.h
@@ -30,12 +30,14 @@ namespace dev
 namespace solidity
 {
 
-/// Visitor interface for the abstract syntax tree. This class is tightly bound to the
-/// implementation of @ref ASTNode::accept and its overrides. After a call to
-/// @ref ASTNode::accept, the function visit for the appropriate parameter is called and then
-/// (if it returns true) this continues recursively for all child nodes in document order
-/// (there is an exception for contracts). After all child nodes have been visited, endVisit is
-/// called for the node.
+/**
+ * Visitor interface for the abstract syntax tree. This class is tightly bound to the
+ * implementation of @ref ASTNode::accept and its overrides. After a call to
+ * @ref ASTNode::accept, the function visit for the appropriate parameter is called and then
+ * (if it returns true) this continues recursively for all child nodes in document order
+ * (there is an exception for contracts). After all child nodes have been visited, endVisit is
+ * called for the node.
+ */
 class ASTVisitor
 {
 public:
diff --git a/BaseTypes.h b/BaseTypes.h
index cfc14c7e9..d1ffd7bbc 100644
--- a/BaseTypes.h
+++ b/BaseTypes.h
@@ -29,8 +29,10 @@ namespace dev
 namespace solidity
 {
 
-/// Representation of an interval of source positions.
-/// The interval includes start and excludes end.
+/**
+ * Representation of an interval of source positions.
+ * The interval includes start and excludes end.
+ */
 struct Location
 {
 	Location(int _start, int _end): start(_start), end(_end) { }