Changeset 45917 for trunk/src/wp-admin/includes/plugin.php

Timestamp:

08/30/2019 04:56:39 PM (6 years ago)

Author:

SergeyBiryukov

Message:

Docs: Simplify get_plugin_data() and get_file_data() description.

See #47110.

File:

• trunk/src/wp-admin/includes/plugin.php (modified) (3 diffs)

trunk/src/wp-admin/includes/plugin.php

@@ -10 +10 @@
  * Parses the plugin contents to retrieve plugin's metadata.
  *
- * The metadata of the plugin's data searches for the following in the plugin's
- * header. All plugin data must be on its own line. For plugin description, it
- * must not have any newlines or only parts of the description will be displayed
- * and the same goes for the plugin data. The below is formatted for printing.
+ * All plugin headers must be on their own line. Plugin description must not have
+ * any newlines, otherwise only parts of the description will be displayed.
+ * The below is formatted for printing.
  *
  *     /*
@@ -34 +33 @@
  *     Requires at least: Optional. Specify the minimum required WordPress version.
  *     Requires PHP: Optional. Specify the minimum required PHP version.
- *      * / # Remove the space to close comment
- *
- * Some users have issues with opening large files and manipulating the contents
- * for want is usually the first 1kiB or 2kiB. This function stops pulling in
- * the plugin contents when it has all of the required plugin data.
- *
- * The first 8kiB of the file will be pulled in and if the plugin data is not
- * within that first 8kiB, then the plugin author should correct their plugin
+ *     * / # Remove the space to close comment.
+ *
+ * The first 8 KB of the file will be pulled in and if the plugin data is not
+ * within that first 8 KB, then the plugin author should correct their plugin
  * and move the plugin data headers to the top.
  *
@@ -49 +44 @@
  *
  * @since 1.5.0
- * @since 5.3.0 Added support for `Requires at least` and `Requires PHP`.
+ * @since 5.3.0 Added support for `Requires at least` and `Requires PHP` headers.
  *
  * @param string $plugin_file Absolute path to the main plugin file.