docs/story-class.rst fitz/fitz.i: Removed Story.warnings(), as currently unsafe to use.

The underlying fz_story_warnings() fn invalidates the story's xml, so
attempting afterwards to use the xml from python could cause a crash.

Author: julian-smith-artifex-com

docs/story-class.rst

@@ -14,7 +14,6 @@ Story
 :meth:`Story.reset`                         "rewind" story output to its beginning
 :meth:`Story.place`                         compute story content to fit in provided rectangle
 :meth:`Story.draw`                          write the computed content to current page
-:meth:`Story.warnings`                      read any warnings generated by HTML/CSS parsers
 :meth:`Story.element_positions`             callback function logging currently processed story content
 :attr:`Story.body`                          the story's underlying :htmlTag:`body`
 :meth:`Story.write`                         places and draws Story to a DocumentWriter
@@ -88,14 +87,6 @@ Story
 
       Rewind the story's document to the beginning for starting over its output.
 
-   .. method:: warnings()
-
-      An entirely optional method to check for any errors when parsing HTML / CSS source. Use this if the source quality is uncertain and / or may contain HTML / CSS language elements that are not (yet) supported by the parsers used by MuPDF. For example, MuPDF only supports CSS up to level 2, not the more advanced level 3.
-
-      .. caution:: This method will invalidate the :ref:`Story` object! The same story must be created again afterwards -- so the method should only be used if there is a high chance to encounter problematic sources.
-
-      :returns: a string with error messages generated by the source parsing.
-
    .. attribute:: body
 
       The :htmlTag:`body` part of the story's DOM. Even if `html=None` has been used at story creation, the following minimum HTML source will always be available::

fitz/fitz.i

@@ -13582,19 +13582,6 @@ struct Story
             return (struct Xml*) dom;
         }
 
-        FITZEXCEPTION(warnings, !result)
-        PyObject* warnings()
-        {
-            const char *text=NULL;
-            fz_try(gctx) {
-                text = fz_story_warnings(gctx, (fz_story *)$self);
-            }
-            fz_catch(gctx) {
-                return NULL;
-            }
-            return Py_BuildValue("s", text);
-        }
-
         FITZEXCEPTION(element_positions, !result)
         %pythonprepend element_positions %{
         if type(args) is dict: