Fix writing of tiff description

toCharArray() is the same as getBytes('UTF-16BE')
This leads to have unicode for units not being
correctly encoded.
Add test checking that the reader used is the OME-TIFF reader.
Add doc.
Merge pull request #1459 from jburel/encoding

Fix writing of tiff description
merge develop -Dnone -Ibreaking -Eexclude -Ssuccess-only

Repository: openmicroscopy/bioformats
Excluded PRs:
  # PR 1460 rleigh-dundee 'C++: Implement MetadataConverter' (user: rleigh-dundee)
  # PR 1469 rleigh-dundee 'cpp: bioformats: Correct placement of warning pragmas in PixelProperties' (user: rleigh-dundee)
  # PR 1426 qidane 'Initial Rendering Definitions schema' (exclude comment)
  # PR 1381 melissalinkert 'Parse physical pixel sizes from CellSens .vsi datasets' (user: melissalinkert)
  # PR 1467 rleigh-dundee 'cmake: Replace FindXerces with FindXercesC' (user: rleigh-dundee)
  # PR 1407 melissalinkert 'TIFF: fix plane count calculation for pyramids with multiple planes' (user: melissalinkert)
  # PR 1458 sbesson 'Fix Javadocs warnings' (user: sbesson)
  # PR 1161 sommerc 'Initial CellH5 Reader class' (user: sommerc)
  # PR 1015 qidane 'Messy binary' (exclude comment)
  # PR 1442 bramalingam 'Update roi handler' (user: bramalingam)
  # PR 857 melissalinkert 'Initial support for Zeiss .lms files' (user: melissalinkert)
  # PR 1468 rleigh-dundee 'C++: binary build and showinf fixes' (user: rleigh-dundee)
  # PR 858 melissalinkert 'Initial support for Veeco AFM data' (user: melissalinkert)
  # PR 1471 jburel 'mock object' (user: jburel)
  # PR 1457 melissalinkert 'IM3: fix memoization and whitespace' (user: melissalinkert)
  # PR 1443 joshmoore 'Genshi ZIP' (user: joshmoore)
  # PR 1177 rleigh-dundee 'specification: Add metadata for HDF5 embedding' (exclude comment)
  # PR 1420 qidane 'Updating samples and adding units samples' (user: qidane)
  # PR 1309 melissalinkert 'Allow tile-based access of large JPEG-2000 images' (exclude comment)
  # PR 1465 melissalinkert 'NDPI: fix tile offset adjustment for files larger than 4GB' (user: melissalinkert)
  # PR 1461 csachs 'Changed ND2 metadata string handling to work properly with empty strings' (user: csachs)
Updating c3521e7..4a55271
Previously merged:
  # PR 1459 jburel 'Fix writing of tiff description'
  # PR 1462 sbesson 'Add bash script for updating copyright headers'
  # PR 1463 sbesson 'Add script to bump version numbers'
  # PR 1365 ctrueden 'PrairieView 5.2 fixes and improvements'
  # PR 1437 stelfrich 'Changed handling of empty series names in ND2 files'
  # PR 1456 mtbc 'add note about using mvn eclipse:eclipse'
  # PR 1454 rleigh-dundee 'C++: Autoload schema catalogues and set up environment for tests'
  # PR 1366 ctrueden 'Miscellaneous cleanup'
  # PR 1452 joshmoore 'Use __import__ for generateDS to handle FS case issues'
  # PR 1448 melissalinkert 'Metamorph: allow both sanitized and unsanitized delimiters'
  # PR 1455 sbesson 'Remove source code hyperlinks from Java source files'
  # PR 1453 jburel 'Fix mock object to match changes from int to double for channel'

Generated by OME-5.1-breaking-push#222 (http://ci.openmicroscopy.org/job/OME-5.1-breaking-push/222/)