Ticket #31433: 31433.diff

src/wp-includes/general-template.php

@@ -2578 +2578 @@
  *
  * @since 2.1.0
  *
- * @param string|array $args Optional. Override defaults.
+ * @param string|array $args {
+ *     Optional. Override defaults.
+ *
+ *     @type string $base               Base of the paginated url. Default is empty string.
+ *     @type string $format             Format for the pagination structure. Default is empty string.
+ *     @type int    $total              The total amount of pages. Default is WP_Query's max_num_pages or 1.
+ *     @type int    $current            The current page number. Default is 'paged' query var or 1.
+ *     @type bool   $show_all           Whether to show all pages. Default is false.
+ *     @type int    $end_size           How many numbers on either the start and the end list edges.
+ *                                      Default is 1.
+ *     @type int    $mid_size           How many numbers to either side of the current pages.
+ *                                      Default is 2.
+ *     @type bool   $prev_next          Whether to include the previous and next links in the list or not.
+ *                                      Default is true.
+ *     @type bool   $prev_text          The previous page text. Default: __( '« Previous' ).
+ *     @type bool   $next_text          The next page text. Default: __('« Previous').
+ *     @type string $type               Controls format of the returned value. Possible values are 'plain',
+ *                                      'array' and 'list'. Default is 'plain'.
+ *     @type array  $add_args           An array of query args to add. Default is false.
+ *     @type string $add_fragment       A string to append to each link. Default is empty.
+ *     @type string $before_page_number A string to appear before the page number. Default is none.
+ *     @type string $after_page_number  A string to append after the page number. Default is none.
+ * }
  * @return array|string String of page links or array of page links.
  */
 function paginate_links( $args = '' ) {