amend #958: use a single paragraph because \item{} in Rd doesn't support more than one paragraph

Author: yihui

NEWS.md

@@ -6,7 +6,7 @@
 
 ## BUG FIXES
 
-- Correctly encode the document title when creating the twitter sharing link from a bookdown chapter (thanks, @maelle, #934).
+- Correctly encode the document title when creating the Twitter sharing link from a bookdown chapter (thanks, @maelle, #934).
 
 - Make sure `search_index.json` contains valid characters for the JSON format (thanks, @wlandau, #913).
 
@@ -18,7 +18,7 @@
 
 ## MINOR CHANGES
 
-- Updated documentation for `render_book` to make it clearer how options are set for the `output_format` parameter (See #930) (thanks, @jonathan-g, #958)
+- Updated documentation for `render_book()` to make it clearer how options are set for the `output_format` parameter (thanks, @jonathan-g, #958 #930).
 
 # CHANGES IN bookdown VERSION 0.20
 

R/render.R

@@ -14,12 +14,11 @@
 #'   Markdown files specified by the book are rendered.
 #' @param output_format,...,clean,envir Arguments to be passed to
 #'   \code{rmarkdown::\link{render}()}. For \code{preview_chapter()}, \code{...}
-#'   is passed to \code{render_book()}.
-#'
-#'   See \code{rmarkdown::\link{render}} and
-#'   \href{https://bookdown.org/yihui/bookdown/build-the-book.html}{the bookdown
-#'   reference book} for details on how output formatting options are set from
-#'   YAML or parameters supplied by the user when calling \code{render_book()}.
+#'   is passed to \code{render_book()}. See \code{rmarkdown::\link{render}()}
+#'   and \href{https://bookdown.org/yihui/bookdown/build-the-book.html}{the
+#'   bookdown reference book} for details on how output formatting options are
+#'   set from YAML or parameters supplied by the user when calling
+#'   \code{render_book()}.
 #' @param clean_envir This argument has been deprecated and will be removed in
 #'   future versions of \pkg{bookdown}.
 #' @param output_dir The output directory. If \code{NULL}, a field named
@@ -40,12 +39,12 @@
 #' # see https://bookdown.org/yihui/bookdown for the full documentation
 #' if (file.exists('index.Rmd')) bookdown::render_book('index.Rmd')
 #' \dontrun{
-#'   # will use the default format defined in _output.yml
-#'   bookdown::render_book("index.Rmd")
-#'   # will use the options for format defined in yaml
-#'   bookdown::render_book("index.Rmd",  "pdf_book")
-#'   # If you pass an output format, it must have all the options set
-#'   bookdown::render_book("index.Rmd", bookdown::pdf_book(toc = FALSE))
+#' # will use the default format defined in index.Rmd or _output.yml
+#' bookdown::render_book("index.Rmd")
+#' # will use the options for format defined in YAML metadata
+#' bookdown::render_book("index.Rmd",  "pdf_book")
+#' # If you pass an output format object, it must have all the options set
+#' bookdown::render_book("index.Rmd", bookdown::pdf_book(toc = FALSE))
 #' }
 render_book = function(
   input, output_format = NULL, ..., clean = TRUE, envir = parent.frame(),