diff --git a/src/Layout.h b/src/Layout.h
index fa4bdc2da2..a549557c59 100644
--- a/src/Layout.h
+++ b/src/Layout.h
@@ -52,6 +52,7 @@ public:
 	///
 	Layout();
 	/// Reads a layout definition from file
+	/// \return false on success. FIXME: this is bad API, should return true!
 	bool read(Lexer &, TextClass const &);
 	///
 	void readAlign(Lexer &);
diff --git a/src/TextClass.h b/src/TextClass.h
index 644fb9c153..c4c737afbf 100644
--- a/src/TextClass.h
+++ b/src/TextClass.h
@@ -67,6 +67,7 @@ public:
 		MODULE //>This is a layout module
 	};
 	/// Performs the read of the layout file.
+	/// \return false on success. FIXME: this is bad API, should return true!
 	bool read(support::FileName const & filename, ReadType rt = BASECLASS);
 	///
 	void readOutputType(Lexer &);