💡 N°4854 Document compiler behavior change for model.*.php files

setup/compiler.class.inc.php

@@ -3542,12 +3542,22 @@ EOF;
 
 	/**
 	 * Write a file only if not exists
-	 * Also add some informations in case of a write failleure
-	 * @param $sFilename
-	 * @param $sContent
+	 * Also add some informations when write failure occurs
+	 *
+	 * @param string $sFilename
+	 * @param string $sContent
+	 * @param int $flags
 	 *
 	 * @return bool|int
 	 * @throws \Exception
+	 *
+	 * @uses \unlink()
+	 * @uses \file_put_contents()
+	 *
+	 * @since 3.0.0 The file is removed before writing (commit c5d265f6)
+	 *      For now this causes model.*.php files to always be located in env-* dir, even if symlinks are enabled
+	 *      See N°4854
+	 * @link https://www.itophub.io/wiki/page?id=3_0_0%3Arelease%3A3_0_whats_new#compiler_always_generate_new_model_php compiler behavior change documentation
 	 */
 	protected function WriteFile($sFilename, $sContent, $flags = null)
 	{