doc: copyedit fs doc

[Trott]

Minor editing for clarity and concision.

[thefourtheye]

Recursive support for Windows has been added only recently and I assume this is going to be an ongoing process. So, we may not require that change.

cc @saghul

[Trott]

@thefourtheye I'm not sure I understand what you mean. The only change I'm proposing for that part of the doc is to change currently supported on OS X and Windows to only supported on OS X and Windows. I think that's an improvement because:

• The word currently is superfluous. Whatever you put in the documentation, it is assumed to be the current state of the API.
• The word only makes it explicit that it is not supported anywhere else. Leaving out only makes it ambiguous. Is it supported on OS X and Windows as well as other platforms? Or just those two platforms and nowhere else?

Am I misunderstanding something?

[thefourtheye]

Hmmm okay. LGTM then

[targos]

LGTM

[saghul]

IMHO it can be trimmed further.

"Only FSEvents supports this type of file watching so it is unlikely any additional platforms will be added soon."

Here "FSEvents" refers to the OSX API, but since we added Windows support I don't think we should say it's unlikely that we add more.

[Trott]

@saghul OK, trimmed further. Thanks. How's it look now? /cc @thefourtheye@targos

[thefourtheye]

LGTM

[targos]

LGTM

[saghul]

LGTM

[Trott]

Landed in 0e4b772