add NEWS item and document support for posterior draws format

Author: jgabry

NEWS.md

@@ -2,6 +2,8 @@
 
 # bayesplot 1.8.1.9000
 
+* `mcmc_*()` functions now support all draws formats from the **posterior** package. (#277, @Ozan147)
+
 * `mcmc_dens()` and `mcmc_dens_overlay()` gain arguments for controlling the 
   the density calculation. (#258)
 

R/mcmc-overview.R

@@ -25,6 +25,8 @@
 #' have already been merged), or a data frame with one column per parameter plus
 #' an additional column `"Chain"` that contains the chain number (an integer)
 #' corresponding to each row in the data frame.
+#' * __draws__: Any of the `draws` formats supported by the
+#' \pkg{\link{posterior}} package.
 #'
 #' __Note__: typically the user should *not* include warmup iterations
 #' in the object passed to **bayesplot** plotting functions, although for

man-roxygen/args-mcmc-x.R

@@ -1,5 +1,8 @@
-#' @param x A 3-D array, matrix, list of matrices, or data frame of MCMC draws.
-#'   The [MCMC-overview] page provides details on how to specify each these
-#'   allowed inputs. It is also possible to use an object with an
-#'   `as.array()` method that returns the same kind of 3-D array described on
-#'   the [MCMC-overview] page.
+#' @param x An object containing MCMC draws:
+#' * A 3-D array, matrix, list of matrices, or data frame. The [MCMC-overview]
+#' page provides details on how to specify each these.
+#' * A `draws` object from the \pkg{\link{posterior}} package (e.g.,
+#' `draws_array`, `draws_rvars`, etc.).
+#' * An object with an `as.array()` method that returns the same kind of 3-D
+#' array described on the [MCMC-overview] page.
+#'