- * Register new Javascript file.
- *
- * @since r16
- * @param string $handle Script name
- * @param string $src Script url
- * @param array $deps (optional) Array of script names on which this script depends
- * @param string|bool $ver (optional) Script version (used for cache busting), set to null to disable
- * @param bool $in_footer (optional) Whether to enqueue the script before </head> or before </body>
- * @return null
+ * Register a new script.
+ *
+ * Registers a script to be linked later using the wp_enqueue_script() function.
+ *
+ * @see WP_Dependencies::add(), WP_Dependencies::add_data()
+ *
+ * @since 2.6.0
+ * @since 4.3.0 A return value was added.
+ *
+ * @param string $handle Name of the script. Should be unique.
+ * @param string $src Path to the script from the WordPress root directory. Example: '/js/myscript.js'.
+ * @param array $deps Optional. An array of registered script handles this script depends on. Set to false if there
+ * are no dependencies. Default empty array.
+ * @param string|bool $ver Optional. String specifying script version number, if it has one, which is concatenated
+ * to end of path as a query string. If no version is specified or set to false, a version
+ * number is automatically added equal to current installed WordPress version.
+ * If set to null, no version is added. Default 'false'. Accepts 'false', 'null', or 'string'.
+ * @param bool $in_footer Optional. Whether to enqueue the script before </head> or before </body>.
+ * Default 'false'. Accepts 'false' or 'true'.
+ * @return bool Whether the script has been registered. True on success, false on failure.