Minor comment and string fixes.

[mtbc]

Small tweaks, partly caused by comments on PRs #669, #690.
Set Java source files to be UTF-8.
Also correct resource leakage in TempFileManager.

[mtbc]

Documentation update in ome/omero-documentation#245

[joshmoore]

@mtbc: all of these were in your fs-path PR?

[mtbc]

No, I'll have to rebase this to develop (but half of it should vanish in the process).

[joshmoore]

This doesn't really fall under the description of this commit/PR. Probably fine, but do shoot for the principle of least surprise where possible.

[mtbc]

Good point, I forgot I'd noticed this; adjusted description accordingly.

[jburel]

I will use one PR only to fix the UTF-8 stuf.

[mtbc]

@jburel: You want me to break this PR into two, one with UTF-8 things, one with the other things?

[jburel]

@mtbc: since @manics opened a PR related to UTF-8, I thought it was better to do cover the code in the same PR

[manics]

@jburel #690 fixed an incorrectly coded non-utf8 char on develop only which was causing compilation errors on some systems. This PR involves changing between two equally valid utf-8 representations.

[manics]

Though we could wait for this to be rebased and just cherry pick 08c0721

[manics]

What's the plan? Move the non-utf8 stuff into another PR?

[jburel]

@manics, @mtbc: I will vote for the UTF-8 changes in another PR.

[mtbc]

Okay, I'll close this one and open a UTF-8 one and a non-UTF-8 one against dev_4_4.

What do you want me to do about #690 ? Should my rebased UTF-8 be a PR against the Unicode fix branch of @manics ? Or should he close that and I should cherry pick his commit across to a rebase against develop?

[mtbc]

Split into #729, #730, #731.

[manics]

Cherry pick 08c0721 into your rebased develop PR. I'll close #690.

[mtbc]

Will do.