code: public void configureForConvenience()
      {
          // StAX (1.0) settings:
          doCoalesceText(true);
          doReplaceEntityRefs(true);
  
          // StAX2: 
          doReportCData(false);
          doReportPrologWhitespace(false);
          /* Also, knowing exact locations is nice esp. for error
           * reporting purposes
           */
          doPreserveLocation(true);
  
          // Woodstox-specific:
  
          /* Also, we can force errors to be reported in timely manner:
           * (once again, at potential expense of performance)
           */
          doParseLazily(false);
      }
docs: Method to call to make Reader created be as "convenient" to use
  as possible; ie try to avoid having to deal with some of things
  like segmented text chunks. This may incur some slight performance
  penalties, but should not affect XML conformance.
  See {@link XMLInputFactory2#configureForConvenience} for
  required settings for standard StAX/StAX properties.
  <p>
  In addition to the standard settings, following Woodstox-specific
  settings are also done:
  <ul>
  <li>Disable <code>XMLStreamFactory2.P_LAZY_PARSING</code> (to allow for synchronous
  error notification by forcing full XML events to be completely
  parsed when reader's <code>next() is called)
  </li>
  </ul>