Clarify status of html() function

Fixes #266

Author: hadley

R/parse.R

@@ -1,6 +1,6 @@
 #' Parse an HTML page.
 #'
-#' html is deprecated: please use `read_html`() instead.
+#' html is deprecated: please use `xml2::read_html()` instead.
 #'
 #' @param x A url, a local path, a string containing html, or a response from
 #'   an httr request.
@@ -9,7 +9,7 @@
 #' @param encoding Specify encoding of document. See [iconvlist()]
 #'   for complete list. If you have problems determining the correct encoding,
 #'   try [stringi::stri_enc_detect()]
-#' @keywords deprecated
+#' @keywords internal
 #' @export
 #' @examples
 #' # From a url:

README.Rmd

@@ -62,10 +62,7 @@ devtools::install_github("tidyverse/rvest")
 
 ## Key functions
 
-The most important functions in rvest are:
-
-* Create an html document from a url, a file on disk or a string containing
-  html with `read_html()`.
+Once you have read a HTML document with `read_html()`, you can:
 
 * Select parts of a document using CSS selectors: `html_nodes(doc, "table td")`
   (or if you've a glutton for punishment, use XPath selectors with

README.md

@@ -64,10 +64,7 @@ devtools::install_github("tidyverse/rvest")
 
 ## Key functions
 
-The most important functions in rvest are:
-
-  - Create an html document from a url, a file on disk or a string
-    containing html with `read_html()`.
+Once you have read a HTML document with `read_html()`, you can:
 
   - Select parts of a document using CSS selectors: `html_nodes(doc,
     "table td")` (or if you’ve a glutton for punishment, use XPath

_pkgdown.yml

@@ -10,7 +10,6 @@ template:
 reference:
 - title: Extract data from HTML
   contents:
-  - html
   - html_form
   - html_nodes
   - html_table