Adding more comments to every header file in api/ subdirectory.

Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
TBR=pthatcher@webrtc.org
NOTRY=True

Review-Url: https://codereview.webrtc.org/2680273002
Cr-Commit-Position: refs/heads/master@{#16485}
Committed: https://chromium.googlesource.com/external/webrtc/+/b10f32f9b24a7c0e3971b150d2d835c41e685c95

[Taylor Brandstetter, 2017-02-08 08:58:52]

deadbeef@webrtc.org changed reviewers:
+ pthatcher@webrtc.org

[Taylor Brandstetter, 2017-02-08 08:59:06]

Description was changed from

==========
Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
==========

to

==========
Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
TBR=pthatcher@webrtc.org
==========

[Taylor Brandstetter, 2017-02-08 08:59:12]

The CQ bit was checked by deadbeef@webrtc.org

[commit-bot: I haz the power, 2017-02-08 08:59:23]

CQ is trying da patch. Follow status at
 
https://chromium-cq-status.appspot.com/v2/patch-status/codereview.webrtc.org/...

[commit-bot: I haz the power, 2017-02-08 09:02:48]

The CQ bit was unchecked by commit-bot@chromium.org

[commit-bot: I haz the power, 2017-02-08 09:02:49]

Try jobs failed on following builders:
  ios_arm64_dbg on master.tryserver.webrtc (JOB_FAILED,
http://build.chromium.org/p/tryserver.webrtc/builders/ios_arm64_dbg/builds/17239)
  ios_dbg on master.tryserver.webrtc (JOB_FAILED,
http://build.chromium.org/p/tryserver.webrtc/builders/ios_dbg/builds/22502)

[Taylor Brandstetter, 2017-02-08 09:35:31]

Description was changed from

==========
Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
TBR=pthatcher@webrtc.org
==========

to

==========
Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
TBR=pthatcher@webrtc.org
NOTRY=True
==========

[Taylor Brandstetter, 2017-02-08 09:35:36]

The CQ bit was checked by deadbeef@webrtc.org

[commit-bot: I haz the power, 2017-02-08 09:35:43]

CQ is trying da patch. Follow status at
 
https://chromium-cq-status.appspot.com/v2/patch-status/codereview.webrtc.org/...

[commit-bot: I haz the power, 2017-02-08 09:38:21]

CQ is committing da patch.

Bot data: {"patchset_id": 40001, "attempt_start_ts": 1486546536407450,
"parent_rev": "76e02cd4d8298de9d8a849af39cbeaf3a5a8ab39", "commit_rev":
"b10f32f9b24a7c0e3971b150d2d835c41e685c95"}

[commit-bot: I haz the power, 2017-02-08 09:38:23]

Description was changed from

==========
Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
TBR=pthatcher@webrtc.org
NOTRY=True
==========

to

==========
Adding more comments to every header file in api/ subdirectory.

Many of these interfaces are not intuitive, or are the way they are for
complex historical reasons, so it would be nice to document these things
for future developers.

Also, many nonstandard things (such as RTCConfiguration options) were
not documented at all before this CL.

BUG=webrtc:7131
TBR=pthatcher@webrtc.org
NOTRY=True

Review-Url: https://codereview.webrtc.org/2680273002
Cr-Commit-Position: refs/heads/master@{#16485}
Committed:
https://chromium.googlesource.com/external/webrtc/+/b10f32f9b24a7c0e3971b150d...
==========

[commit-bot: I haz the power, 2017-02-08 09:38:24]

Committed patchset #3 (id:40001) as
https://chromium.googlesource.com/external/webrtc/+/b10f32f9b24a7c0e3971b150d...