Fix small inaccuracies in the HID API documentation.

Fix small inaccuracies in the HID API documentation.

Fix typos related to which functions send or receive data. Some of these
were already resolved in 1816af67d3fb992ff49fb22b2b8fc8908d6ee6b1. Also
document where the opaque device ID and connection IDs should be used
and how errors are reported.

BUG=392036
Committed: https://crrev.com/28bf19902bfb00402627f12392ab9718d0d0c018
Cr-Commit-Position: refs/heads/master@{#292745}

[Reilly Grant (use Gerrit), 2014-08-29 21:38:38]

reillyg@chromium.org changed reviewers:
+ juanlang@chromium.org, kalman@chromium.org, rockot@chromium.org

[Ken Rockot(use gerrit already), 2014-08-29 21:40:14]

lgtm

[not at google - send to devlin, 2014-08-29 21:40:33]

lgtm

[Reilly Grant (use Gerrit), 2014-08-29 21:41:08]

The CQ bit was checked by reillyg@chromium.org

[commit-bot: I haz the power, 2014-08-30 00:58:34]

FYI, CQ is re-trying this CL (attempt #1).
The failing builders are:
  android_clang_dbg_recipe on tryserver.chromium.linux
(http://build.chromium.org/p/tryserver.chromium.linux/builders/android_clang_d...)

[commit-bot: I haz the power, 2014-08-30 01:24:17]

Committed patchset #1 (id:1) as 9b90bd65d0e32c3bb9a459716cb38033cf4087f9

[commit-bot: I haz the power, 2014-09-10 03:12:42]

Patchset 1 (id:??) landed as
https://crrev.com/28bf19902bfb00402627f12392ab9718d0d0c018
Cr-Commit-Position: refs/heads/master@{#292745}