Hi, I think XWPF is still officially "incomplete" according to the homepage, so I myself would not be too concerned about a breaking change as long as we document it properly and there is a fairly easy way to adjust the code included in the description as well.
Dominik. On Wed, Oct 26, 2016 at 4:15 AM, Mark Murphy <[email protected]> wrote: > XWPF automatically creates a blank paragraph in a new header or footer when > no paragraphs are assigned during creation. This makes header/footer > creation more complicated than it needs to be because it requires the user > to either create an array of unbound paragraphs prior to the header / > footer, or the user has to treat the first paragraph in the header / footer > differently than all the rest. It is also inconvenient when the first > element in a header / footer is something other than a paragraph. > > I would like to remove this behavior since if a user of this library is > creating a header or footer, they are going to add something to it. > > This behavior change would be a breaking change though for some people who > are creating documents with headers or footers, but the assumption that > most headers and footers only contain a single paragraph is incorrect, at > least it is for most of my documents, and for many of them, my header > contains a table to split things up into left side / center / right side > text. > > What do you think? >
