update blavCompare() manpage

man/blavCompare.Rd

@@ -16,13 +16,23 @@ blavCompare(object1, object2, ...)
   \item{\dots}{Other arguments to loo().}
 }
 \details{
-This function approximates the log-Bayes factor of two candidate models using the Laplace approximation to each model's marginal log-likelihood.
+This function computes Bayesian model comparison metrics, including a
+Bayes factor approximation, WAIC, and LOOIC.
+
+The log-Bayes factor of the two models is based on the Laplace
+approximation to each model's marginal log-likelihood.
+
+The WAIC and LOOIC metrics come from the loo package. The ELPD
+difference and SE specifically come from loo::loo_compare().
 }
 \value{
-The log-Bayes factor approximation, along with each model's approximate marginal log-likelihood.
+A list containing separate results for log-Bayes factor, WAIC, LOOIC,
+and differences between WAIC and LOOIC.
 }
 \references{
 Raftery, A. E. (1993). Bayesian model selection in structural equation models. In K. A. Bollen & J. S. Long (Eds.), Testing structural equation models (pp. 163-180). Beverly Hills, CA: Sage.
+
+Vehtari A, Gelman A, Gabry J (2017). “Practical Bayesian model evaluation using leave-one-out cross-validation and WAIC.” _Statistics and Computing_, *27*, 1413-1432.
 }
 \examples{
 \dontrun{