Clarify comments and code in webkitpy.common.find_files.

Clarify comments and code in webkitpy.common.find_files.

Reason: I was looking at this piece of code to see what it does,
and made this CL to better understand what it does.

In this CL:
 - Simplify module docstring.
 - Expand find() docstring.
 - Add test with example invocation of find().

Review-Url: https://codereview.chromium.org/2761623002
Cr-Commit-Position: refs/heads/master@{#458951}
Committed: https://chromium.googlesource.com/chromium/src/+/dcf957a9f996b63113bffa8dad3c5a6382823a28

[qyearsley, 2017-03-20 19:37:35]

Description was changed from

==========
Clarify comments and code in webkitpy.common.find_files.

Reason: I was looking at this piece of code to see what it does,
and made this CL to better understand what it does.
==========

to

==========
Clarify comments and code in webkitpy.common.find_files.

Reason: I was looking at this piece of code to see what it does,
and made this CL to better understand what it does.

In this CL:
 - Simplify module docstring.
 - Expand find() docstring.
 - Add test with example invocation of find().
==========

[qyearsley, 2017-03-20 19:37:35]

qyearsley@chromium.org changed reviewers:
+ jeffcarp@chromium.org

[qyearsley, 2017-03-20 19:37:38]

The CQ bit was checked by qyearsley@chromium.org to run a CQ dry run

[commit-bot: I haz the power, 2017-03-20 19:37:57]

Dry run: CQ is trying da patch. Follow status at
 
https://chromium-cq-status.appspot.com/v2/patch-status/codereview.chromium.or...

[commit-bot: I haz the power, 2017-03-20 20:48:39]

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

[commit-bot: I haz the power, 2017-03-20 20:48:40]

Dry run: This issue passed the CQ dry run.

[jeffcarp, 2017-03-22 22:51:10]

lgtm

[qyearsley, 2017-03-22 23:10:55]

The CQ bit was checked by qyearsley@chromium.org

[commit-bot: I haz the power, 2017-03-22 23:11:47]

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

[commit-bot: I haz the power, 2017-03-23 00:25:26]

CQ is committing da patch.

Bot data: {"patchset_id": 1, "attempt_start_ts": 1490224255290150, "parent_rev":
"90711039262bcbbc20c28c6b6d79ce2d73aa5e3c", "commit_rev":
"dcf957a9f996b63113bffa8dad3c5a6382823a28"}

[commit-bot: I haz the power, 2017-03-23 00:26:42]

Description was changed from

==========
Clarify comments and code in webkitpy.common.find_files.

Reason: I was looking at this piece of code to see what it does,
and made this CL to better understand what it does.

In this CL:
 - Simplify module docstring.
 - Expand find() docstring.
 - Add test with example invocation of find().
==========

to

==========
Clarify comments and code in webkitpy.common.find_files.

Reason: I was looking at this piece of code to see what it does,
and made this CL to better understand what it does.

In this CL:
 - Simplify module docstring.
 - Expand find() docstring.
 - Add test with example invocation of find().

Review-Url: https://codereview.chromium.org/2761623002
Cr-Commit-Position: refs/heads/master@{#458951}
Committed:
https://chromium.googlesource.com/chromium/src/+/dcf957a9f996b63113bffa8dad3c...
==========

[commit-bot: I haz the power, 2017-03-23 00:26:45]

Committed patchset #1 (id:1) as
https://chromium.googlesource.com/chromium/src/+/dcf957a9f996b63113bffa8dad3c...