diff --git a/src/Buffer.h b/src/Buffer.h
index 2cd1495796..d4e8db8748 100644
--- a/src/Buffer.h
+++ b/src/Buffer.h
@@ -661,10 +661,11 @@ public:
 	///
 	Undo const & undo() const;
 
-	/// poor man versioning of the buffer (and its relatives).
+	/// Poor man versioning of the buffer (and its relatives).
+	///  This is currently used by updateMacros() and Statistics::update().
 	int id() const;
 	/// change the id of this buffer and its relatives (indicating
-	/// something has changed). This is currently used by updateMacros().
+	/// something has changed).
 	void updateId();
 
 	/// This function is called when the buffer is changed.