Doc: Add @file annotation to generated squirrel files.

src/script/api/CMakeLists.txt

@@ -52,6 +52,7 @@ foreach(API "ai;AI" "game;GS" "template;Template")
                         -DSCRIPT_API_SOURCE_FILE=${CMAKE_CURRENT_SOURCE_DIR}/squirrel_export.sq.hpp.in
                         -DSCRIPT_API_BINARY_FILE=${SCRIPT_API_BINARY_FILE}
                         -DSCRIPT_API_FILE=${SCRIPT_API_FILE}
+                        -DSQUIRREL_EXPORT_SQQ_HPP=${SCRIPT_API_FILE_NAME}.sq.hpp
                         -DAPIUC=${APIUC}
                         -DAPILC=${APILC}
                         -P ${CMAKE_SOURCE_DIR}/cmake/scripts/SquirrelExport.cmake

src/script/api/script_includes.hpp.in

@@ -5,7 +5,10 @@
  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
  */
 
-/* THIS FILE IS AUTO-GENERATED; PLEASE DO NOT ALTER MANUALLY */
+/**
+ * @file ${APILC}_includes.hpp Registers OTTD API in squirrel engine.
+ * @attention THIS FILE IS AUTO-GENERATED. PLEASE DO NOT ALTER MANUALLY.
+ */
 
 #include "../script_fatalerror.hpp"
 

src/script/api/squirrel_export.sq.hpp.in

@@ -5,5 +5,9 @@
  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
  */
 
-/* THIS FILE IS AUTO-GENERATED; PLEASE DO NOT ALTER MANUALLY */
+/**
+ * @file ${SQUIRREL_EXPORT_SQQ_HPP} Exposes ottd c++ api to squirrel.
+ * @attention THIS FILE IS AUTO-GENERATED. PLEASE DO NOT ALTER MANUALLY.
+ */
+
 ${SQUIRREL_EXPORT}