resourceloader: Reword and expand doc comment about FileModule "packageFiles"

Change-Id: Id9d68205504ecbddea6ca248e108f368fdcac2d2

1 files changed, 5 insertions, 4 deletions

diff --git a/includes/resourceloader/ResourceLoaderFileModule.php b/includes/resourceloader/ResourceLoaderFileModule.php
index 28488712ddbf..9be5de3d6d4c 100644
--- a/includes/resourceloader/ResourceLoaderFileModule.php
+++ b/includes/resourceloader/ResourceLoaderFileModule.php
@@ -198,10 +198,11 @@ class ResourceLoaderFileModule extends ResourceLoaderModule {
 	 *         ],
 	 *         // Scripts to include in debug contexts
 	 *         'debugScripts' => [file path string or array of file path strings],
-	 *         // For package modules: files to make available for internal require() use
-	 *         // 'type' is optional, and will be inferred from the file name extension if omitted
-	 *         // 'config' can only be used when 'type' is 'data'; vars are resolved with Config::get()
-	 *         // If 'packageFiles' is set, 'scripts' cannot also be set
+	 *         // For package modules: files to be made available for internal require() do not
+	 *         // need to have 'type' defined; it will be inferred from the file name extension
+	 *         // if omitted. 'config' can only be used when 'type' is 'data'; the variables are
+	 *         // resolved with Config::get(). The first entry in 'packageFiles' is always the
+	 *         // module entry point. If 'packageFiles' is set, 'scripts' cannot also be set.
 	 *         'packageFiles' => [
 	 *             [file path string], // or:
 	 *             [ 'name' => [file name], 'file' => [file path], 'type' => 'script'|'data' ], // or: