X-Git-Url: http://nitlanguage.org

diff --git a/src/model/mdoc.nit b/src/model/mdoc.nit
index 4e8c565..261fafe 100644
--- a/src/model/mdoc.nit
+++ b/src/model/mdoc.nit
@@ -35,13 +35,18 @@ end
 
 redef class MEntity
 	# The documentation associated to the entity
-	var mdoc: nullable MDoc is writable
+	var mdoc: nullable MDoc = null is writable
 
 	# The documentation associated to the entity or their main nested entity.
 	#
-	# MProject fall-back to their root MGroup
-	# MGroup fall-back to their default_mmodule
-	# Other entities do not fall-back
+	# * `MPackage`s fall back to their root `MGroup`.
+	# * `MGroup`s fall back to their `default_mmodule`.
+	# * `MClass`es, `MClassDef`s, `MProperty`s and `MPropDef`s fall-back to
+	#   their introducing definition.
+	# * `MClassType`s fall back to their wrapped `MClass`.
+	# * `MVirtualType`s fall back to their wrapped `MProperty`.
+	# * `CallSite` fall back on the wrapped `MProperty`.
+	# * Other entities do not fall back.
 	#
 	# One may use `MDoc::original_mentity` to retrieve the original
 	# source of the documentation.