Ticket #28499: 28499.diff

wp-includes/link-template.php

@@ -2626 +2626 @@
 }
 
 /**
- * Retrieve the url to the plugins directory or to a specific file within that directory.
- * You can hardcode the plugin slug in $path or pass __FILE__ as a second argument to get the correct folder name.
+ * Retrieve the url to the plugins directory, or a specific directory under plugins
+ * or mu-plugins.
+ *
+ * When a $plugin is supplied, the directory containing the referenced file will be
+ * appended to the base URL.
+ *
+ * When a $path is supplied, it will be appended to the URL.
  *
  * @since 2.6.0
  *
- * @param string $path Optional. Path relative to the plugins url.
- * @param string $plugin Optional. The plugin file that you want to be relative to - i.e. pass in __FILE__
- * @return string Plugins url link with optional path appended.
+ * @param  string $path   Optional. Path appended to the URL.
+ * @param  string $plugin Optional. The plugin path that the URL will be relative to.
+ *                        Typically this is done by passing `__FILE__`
+ * @return string         Plugins url link with optional path appended.
 */
 function plugins_url($path = '', $plugin = '') {