diff --git a/libsolidity/ASTVisitor.h b/libsolidity/ASTVisitor.h
index a667ad392..e4818ee27 100644
--- a/libsolidity/ASTVisitor.h
+++ b/libsolidity/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/libsolidity/BaseTypes.h b/libsolidity/BaseTypes.h
index cfc14c7e9..d1ffd7bbc 100644
--- a/libsolidity/BaseTypes.h
+++ b/libsolidity/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) { }
diff --git a/test/solidityCompiler.cpp b/test/solidityCompiler.cpp
index 6e12fecf8..26bfc7cb6 100644
--- a/test/solidityCompiler.cpp
+++ b/test/solidityCompiler.cpp
@@ -41,7 +41,9 @@ namespace test
 namespace
 {
 
-/// Helper class that extracts the first expression in an AST.
+/**
+ * Helper class that extracts the first expression in an AST.
+ */
 class FirstExpressionExtractor: private ASTVisitor
 {
 public: