From 8686f5d0ccb213059281378d1d0bdb8653df38cc Mon Sep 17 00:00:00 2001
From: Christopher Allen <cpcallen+git@google.com>
Date: Sat, 18 Nov 2023 00:12:56 +0000
Subject: [PATCH] docs(generators): @fileoverview -> @file

With an update to the wording for generators/php.ts.
---
 generators/php.ts                   | 6 +++---
 generators/php/colour.ts            | 2 +-
 generators/php/lists.ts             | 2 +-
 generators/php/logic.ts             | 2 +-
 generators/php/loops.ts             | 2 +-
 generators/php/math.ts              | 2 +-
 generators/php/procedures.ts        | 2 +-
 generators/php/text.ts              | 2 +-
 generators/php/variables.ts         | 2 +-
 generators/php/variables_dynamic.ts | 2 +-
 10 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/generators/php.ts b/generators/php.ts
index 66d8a3d292a..18631ad9a37 100644
--- a/generators/php.ts
+++ b/generators/php.ts
@@ -5,9 +5,9 @@
  */
 
 /**
- * @fileoverview Complete helper functions for generating PHP for
- *     blocks.  This is the entrypoint for php_compressed.js.
- * @suppress {extraRequire}
+ * @file Instantiate a PhpGenerator and populate it with the complete
+ * set of block generator functions for PHP.  This is the entrypoint
+ * for php_compressed.js.
  */
 
 // Former goog.module ID: Blockly.PHP.all
diff --git a/generators/php/colour.ts b/generators/php/colour.ts
index 2c4acd74586..eefb7cba774 100644
--- a/generators/php/colour.ts
+++ b/generators/php/colour.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for colour blocks.
+ * @file Generating PHP for colour blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.colour
diff --git a/generators/php/lists.ts b/generators/php/lists.ts
index 32347ae2aeb..1a5322decc7 100644
--- a/generators/php/lists.ts
+++ b/generators/php/lists.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for list blocks.
+ * @file Generating PHP for list blocks.
  */
 
 /**
diff --git a/generators/php/logic.ts b/generators/php/logic.ts
index b7c3ad2a64c..8aaa5c89213 100644
--- a/generators/php/logic.ts
+++ b/generators/php/logic.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for logic blocks.
+ * @file Generating PHP for logic blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.logic
diff --git a/generators/php/loops.ts b/generators/php/loops.ts
index 24b3e002c59..ae87dbb294b 100644
--- a/generators/php/loops.ts
+++ b/generators/php/loops.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for loop blocks.
+ * @file Generating PHP for loop blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.loops
diff --git a/generators/php/math.ts b/generators/php/math.ts
index 811c6da8591..b18127c9316 100644
--- a/generators/php/math.ts
+++ b/generators/php/math.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for math blocks.
+ * @file Generating PHP for math blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.math
diff --git a/generators/php/procedures.ts b/generators/php/procedures.ts
index df33cb50f2e..5d44eb21bae 100644
--- a/generators/php/procedures.ts
+++ b/generators/php/procedures.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for procedure blocks.
+ * @file Generating PHP for procedure blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.procedures
diff --git a/generators/php/text.ts b/generators/php/text.ts
index 492e7c072c1..f2fa69faec3 100644
--- a/generators/php/text.ts
+++ b/generators/php/text.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for text blocks.
+ * @file Generating PHP for text blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.texts
diff --git a/generators/php/variables.ts b/generators/php/variables.ts
index 160725df328..4aacc293b6d 100644
--- a/generators/php/variables.ts
+++ b/generators/php/variables.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for variable blocks.
+ * @file Generating PHP for variable blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.variables
diff --git a/generators/php/variables_dynamic.ts b/generators/php/variables_dynamic.ts
index f893a20dc5b..5ab5ec6cab5 100644
--- a/generators/php/variables_dynamic.ts
+++ b/generators/php/variables_dynamic.ts
@@ -5,7 +5,7 @@
  */
 
 /**
- * @fileoverview Generating PHP for dynamic variable blocks.
+ * @file Generating PHP for dynamic variable blocks.
  */
 
 // Former goog.module ID: Blockly.PHP.variablesDynamic