comparison vendor/masterminds/html5/src/HTML5/Parser/FileInputStream.php @ 4:a9cd425dd02b

Update, including to Drupal core 8.6.10

 <?php
+
 namespace Masterminds\HTML5\Parser;
 
 /**
  * The FileInputStream loads a file to be parsed.
  *

  * development, and also because we could optimize toward processing
  * arbitrarily large chunks of the input. But in the future, we'd
  * really like to rewrite this class to efficiently handle lower level
  * stream reads (and thus efficiently handle large documents).
  *
- * @todo A buffered input stream would be useful.
+ * @deprecated since 2.4, to remove in 3.0. Use a string in the scanner instead.
  */
 class FileInputStream extends StringInputStream implements InputStream
 {
-
     /**
      * Load a file input stream.
      *
-     * @param string $data
-     *            The file or url path to load.
+     * @param string $data     The file or url path to load.
+     * @param string $encoding The encoding to use for the data.
+     * @param string $debug    A fprintf format to use to echo the data on stdout.
      */
     public function __construct($data, $encoding = 'UTF-8', $debug = '')
     {
         // Get the contents of the file.
         $content = file_get_contents($data);