(libxml-parse-html-region): Make DISCARD-COMMENTS obsolete

* lisp/subr.el (libxml-parse-xml-region)
(libxml-parse-html-region): Make DISCARD-COMMENTS obsolete.

* src/xml.c (Flibxml_parse_html_region)
(Flibxml_parse_xml_region): Don't mention DISCARD-COMMENTS, since
it's now no longer part of the advertised signature (bug#27178).

1 files changed, 4 insertions, 10 deletions

diff --git a/src/xml.c b/src/xml.c
index fa88040597d..3674e320ef6 100644
--- a/src/xml.c
+++ b/src/xml.c
@@ -272,11 +272,8 @@ DEFUN ("libxml-parse-html-region", Flibxml_parse_html_region,
        doc: /* Parse the region as an HTML document and return the parse tree.
 If BASE-URL is non-nil, it is used to expand relative URLs.
 
-If DISCARD-COMMENTS is non-nil, the top-level HTML comment is discarded.
-
-This parameter is obsolete as of 27.1, and you should use the
-`xml-remove-comments' function to strip comments before calling
-this function if you don't want comments.  */)
+If you want comments to be stripped, use the `xml-remove-comments'
+function to strip comments before calling this function.  */)
   (Lisp_Object start, Lisp_Object end, Lisp_Object base_url, Lisp_Object discard_comments)
 {
   if (init_libxml2_functions ())
@@ -290,11 +287,8 @@ DEFUN ("libxml-parse-xml-region", Flibxml_parse_xml_region,
        doc: /* Parse the region as an XML document and return the parse tree.
 If BASE-URL is non-nil, it is used to expand relative URLs.
 
-If DISCARD-COMMENTS is non-nil, the top-level XML comment is discarded.
-
-This parameter is obsolete as of 27.1, and you should use the
-`xml-remove-comments' function to strip comments before calling
-this function if you don't want comments.  */)
+If you want comments to be stripped, use the `xml-remove-comments'
+function to strip comments before calling this function.  */)
   (Lisp_Object start, Lisp_Object end, Lisp_Object base_url, Lisp_Object discard_comments)
 {
   if (init_libxml2_functions ())