Review setId() Javadocs for readers/writers

- expand description of setId() for the FormatReader/FormatWriter interfaces
- properly link to the interface setId Javadoc for classes overriding setId()
Merge pull request #1484 from sbesson/javadocs_setid

Review setId() Javadocs for readers/writers
Update auto-generated documentation

Repository: openmicroscopy/bioformats
Already up-to-date.

Generated by BIOFORMATS-5.1-latest-docs-autogen#236 (http://ci.openmicroscopy.org/job/BIOFORMATS-5.1-latest-docs-autogen/236/)