Minor tweaks to API documentation and code comments.

mojo/public/c/system/functions.h

Index: mojo/public/c/system/functions.h
diff --git a/mojo/public/c/system/functions.h b/mojo/public/c/system/functions.h
index 5e0a0c414df9dfd88afabb91e18c3ce75f86b11d..2b992d14e736ff0541adf590869dd41e86a5f2dd 100644
--- a/mojo/public/c/system/functions.h
+++ b/mojo/public/c/system/functions.h
@@ -9,8 +9,6 @@
 #ifndef MOJO_PUBLIC_C_SYSTEM_FUNCTIONS_H_
 #define MOJO_PUBLIC_C_SYSTEM_FUNCTIONS_H_
 
-// Note: This header should be compilable as C.
-
 #include "mojo/public/c/system/system_export.h"
 #include "mojo/public/c/system/types.h"
 
@@ -25,9 +23,9 @@ extern "C" {
 // operation's success/failure. E.g., a separate |flags| parameter may control
 // whether a given "in/out" parameter is used for input, output, or both.)
 
-// Platform-dependent monotonically increasing tick count representing "right
-// now." The resolution of this clock is ~1-15ms. Resolution varies depending
-// on hardware/operating system configuration.
+// Returns a platform-dependent, monotonically increasing tick count
+// representing "right now." The resolution of this clock is ~1-15ms.
+// Resolution varies depending on hardware/operating system configuration.
 MOJO_SYSTEM_EXPORT MojoTimeTicks MojoGetTimeTicksNow(void);
 
 // Closes the given |handle|.
@@ -71,7 +69,7 @@ MOJO_SYSTEM_EXPORT MojoResult MojoClose(MojoHandle handle);
 //       end of a message pipe and the other end is closed).
 //
 // If there are multiple waiters (on different threads, obviously) waiting on
-// the same handle and signal, and that signal becomes is satisfied, all waiters
+// the same handle and signal, and that signal becomes satisfied, all waiters
 // will be awoken.
 MOJO_SYSTEM_EXPORT MojoResult
 MojoWait(MojoHandle handle,