More javadoc to CharSequenceFactory

In particular, the role of the third argument...