Ticket #28680: 28680.2.patch

src/wp-includes/post-template.php

@@ -714 +714 @@
  * Displays page links for paginated posts (i.e. includes the <!--nextpage-->.
  * Quicktag one or more times). This tag must be within The Loop.
  *
- * The defaults for overwriting are:
- * 'before' - Default is '<p> Pages:' (string). The html or text to prepend to
- *      each bookmarks.
- * 'after' - Default is '</p>' (string). The html or text to append to each
- *      bookmarks.
- * 'link_before' - Default is '' (string). The html or text to prepend to each
- *      Pages link inside the <a> tag. Also prepended to the current item, which
- *      is not linked.
- * 'link_after' - Default is '' (string). The html or text to append to each
- *      Pages link inside the <a> tag. Also appended to the current item, which
- *      is not linked.
- * 'next_or_number' - Default is 'number' (string). Indicates whether page
- *      numbers should be used. Valid values are number and next.
- * 'separator' - Default is ' ' (string). Text used between pagination links.
- * 'nextpagelink' - Default is 'Next Page' (string). Text for link to next page.
- *      of the bookmark.
- * 'previouspagelink' - Default is 'Previous Page' (string). Text for link to
- *      previous page, if available.
- * 'pagelink' - Default is '%' (String).Format string for page numbers. The % in
- *      the parameter string will be replaced with the page number, so Page %
- *      generates "Page 1", "Page 2", etc. Defaults to %, just the page number.
- * 'echo' - Default is 1 (integer). When not 0, this triggers the HTML to be
- *      echoed and then returned.
- *
  * @since 1.2.0
  *
- * @param string|array $args Optional. Overwrite the defaults.
+ * @param string|array $args {
+ *     Default arguments. Optional.
+ *
+ *     @type string       $before           The html or text to prepend to each bookmarks. Default is '<p> Pages:'.
+ *     @type string       $after            The html or text to append to each bookmarks. Default is '</p>'.
+ *     @type string       $link_before      The html or text to prepend to each Pages link inside the <a> tag.
+ *                                          Also prepended to the current item, which is not linked. Default is ''.
+ *     @type string       $link_after       The html or text to append to each Pages link inside the <a> tag.
+ *                                          Also appended to the current item, which is not linked. Default is ''.
+ *     @type string       $next_or_number   Indicates whether page numbers should be used. Valid values are number
+ *                                          and next. Default is 'number'
+ *     @type string       $separator        Text used between pagination links. Default is ' '
+ *     @type string       $nextpagelink     Text for link to next page. Default is 'Next Page'
+ *     @type string       $previouspagelink Text for link to previous page, if available. Default is 'Previous Page'
+ *     @type string       $pagelink         Format string for page numbers. The % in the parameter string will be
+ *                                          replaced with the page number, so Page % generates "Page 1", "Page 2", etc.
+ *                                          Defaults to %, just the page number.
+ *     @type integer|bool $echo             When true or not 0, this triggers the HTML to be echoed and then returned.
+ *                                          Default is 1.
+ * }
  * @return string Formatted output in HTML.
  */
 function wp_link_pages( $args = '' ) {