These require at least the following version of the text-test-data, dated January 6:

git: 2183e3e5423fbf0d9d0187a4455df699c5e04b74
hg:  6c0e2b527bbbc6e18c622e452d16634b5d953b34

Polish UTF-8 bytestring builder support

The counter-example for the existing code is a string of length '2*n' that
starts with 'n' characters with codepoints in the range (0x7F, 0x7FF) and ends
with 'n' ASCII characters. All 'n' ASCII characters will be written after the
end of the output buffer.

- adjust function names to 'encodeUtf8Builder' and 'encodeUtf8BuilderEscaped'
- expose the same conversion to builders for both lazy and strict text
- ensure 'Escaped' versions are inlined to allow specialization for specific
  escaping primitives
- fix some Haddock references
- add Haddock comment about bytestring >= 0.10.4.0 dependency
- remove stream-to-builder encoding functions. There is no direct use case for
  them and they require too much knowledge about the internals to be used
  correctly.

I somehow forgot that we allocate the initial ByteString to contain
the same number of bytes as the Text contains code units. This means
that we never need to ensure that the ByteString is big enough, nor
(with this observation) does a special-cased ASCII-only loop help
performance.

--HG--
rename : Data/Text/Encoding/Utf8.hs => Data/Text/Internal/Encoding/Utf8.hs

As far as I know, this completes the set of possible invalid encodings.

--HG--
extra : rebase_source : 67b2c2d04dd9aa582e4d8d5d0097be1525395c41
extra : amend_source : c88aefbe0c96c6a496c3a74bbf4d17a0a5da0e16

This test currently fails due to gh-61.

--HG--
extra : amend_source : ca66a1e6503a0cb9cf6cf5f2b82f2199133a6512

This version tries to force the real decoding function to be inlined
into each of its callers, which in turn each have different criteria
for backing up a byte. This avoids an extra test at the end of
strict decoding.

While this seems to fix gh-61, I want to beef up the test suite so
that it will correctly detect the bug.

The refactoring in that commit was performed incorrectly, such that
it would no longer detect as invalid an incomplete series of
continuation bytes at the end of a string.

--HG--
rename : Data/Text/Util.hs => Data/Text/Internal/Functions.hs
rename : Data/Text/Lazy/Internal.hs => Data/Text/Internal/Lazy.hs
rename : Data/Text/Private.hs => Data/Text/Internal/Private.hs
rename : Data/Text/Search.hs => Data/Text/Internal/Search.hs
rename : Data/Text/Unsafe/Base.hs => Data/Text/Internal/Unsafe.hs
rename : Data/Text/UnsafeChar.hs => Data/Text/Internal/Unsafe/Char.hs
rename : Data/Text/UnsafeShift.hs => Data/Text/Internal/Unsafe/Shift.hs

--HG--
rename : Data/Text/Lazy/Encoding/Fusion.hs => Data/Text/Internal/Lazy/Encoding/Fusion.hs
rename : Data/Text/Lazy/Fusion.hs => Data/Text/Internal/Lazy/Fusion.hs
rename : Data/Text/Lazy/Search.hs => Data/Text/Internal/Lazy/Search.hs
extra : amend_source : 2c28ab48f28c6a5750a180a503e1efec634253ea

--HG--
rename : Data/Text/Lazy/Builder/Internal.hs => Data/Text/Internal/Builder.hs
rename : Data/Text/Lazy/Builder/Functions.hs => Data/Text/Internal/Builder/Functions.hs
rename : Data/Text/Lazy/Builder/Int/Digits.hs => Data/Text/Internal/Builder/Int/Digits.hs
rename : Data/Text/Lazy/Builder/RealFloat/Functions.hs => Data/Text/Internal/Builder/RealFloat/Functions.hs
extra : amend_source : 8586afbbddd37de30ca45141e5f7a87a2c164b6d

--HG--
rename : Data/Text/IO/Internal.hs => Data/Text/Internal/IO.hs

--HG--
rename : Data/Text/Fusion.hs => Data/Text/Internal/Fusion.hs
rename : Data/Text/Fusion/CaseMapping.hs => Data/Text/Internal/Fusion/CaseMapping.hs
rename : Data/Text/Fusion/Common.hs => Data/Text/Internal/Fusion/Common.hs
rename : Data/Text/Fusion/Size.hs => Data/Text/Internal/Fusion/Size.hs
rename : Data/Text/Fusion/Internal.hs => Data/Text/Internal/Fusion/Types.hs

--HG--
rename : Data/Text/Encoding/Fusion.hs => Data/Text/Internal/Encoding/Fusion.hs
rename : Data/Text/Encoding/Fusion/Common.hs => Data/Text/Internal/Encoding/Fusion/Common.hs
rename : Data/Text/Encoding/Utf16.hs => Data/Text/Internal/Encoding/Utf16.hs
rename : Data/Text/Encoding/Utf32.hs => Data/Text/Internal/Encoding/Utf32.hs
rename : Data/Text/Encoding/Utf8.hs => Data/Text/Internal/Encoding/Utf8.hs

--HG--
extra : amend_source : 2ea79df013664562bb8015f1be08c47a7d03b858