Adds lots of Mojo documentation

mojo/public/c/system/types.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 // This file contains types and constants/macros common to different Mojo system
 // APIs.
 //
 // Note: This header should be compilable as C.
 
 #ifndef MOJO_PUBLIC_C_SYSTEM_TYPES_H_
 #define MOJO_PUBLIC_C_SYSTEM_TYPES_H_
 
 #include <stdint.h>
 
 #include "mojo/public/c/system/macros.h"
 
-// TODO(vtl): Notes: Use of undefined flags will lead to undefined behavior
-// (typically they'll be ignored), not necessarily an error.
-
 // |MojoTimeTicks|: A time delta, in microseconds, the meaning of which is
 // source-dependent.
 
 typedef int64_t MojoTimeTicks;
 
 // |MojoHandle|: Handles to Mojo objects.
 //   |MOJO_HANDLE_INVALID| - A value that is never a valid handle.
 
 typedef uint32_t MojoHandle;
 
@@ skipping 47 matching lines @@
 //   |MOJO_RESULT_BUSY| - One of the resources involved is currently being used
 //       (possibly on another thread) in a way that prevents the current
 //       operation from proceeding, e.g., if the other operation may result in
 //       the resource being invalidated.
 //   |MOJO_RESULT_SHOULD_WAIT| - The request cannot currently be completed
 //       (e.g., if the data requested is not yet available). The caller should
 //       wait for it to be feasible using a watcher.
 //
 // The codes from |MOJO_RESULT_OK| to |MOJO_RESULT_DATA_LOSS| come from
 // Google3's canonical error codes.
-//
-// TODO(vtl): Add a |MOJO_RESULT_UNSATISFIABLE|?
 
 typedef uint32_t MojoResult;
 
 #ifdef __cplusplus
 const MojoResult MOJO_RESULT_OK = 0;
 const MojoResult MOJO_RESULT_CANCELLED = 1;
 const MojoResult MOJO_RESULT_UNKNOWN = 2;
 const MojoResult MOJO_RESULT_INVALID_ARGUMENT = 3;
 const MojoResult MOJO_RESULT_DEADLINE_EXCEEDED = 4;
 const MojoResult MOJO_RESULT_NOT_FOUND = 5;
@@ skipping 120 matching lines @@
 //       users should refrain from making sync calls.
 typedef uint32_t MojoPropertyType;
 
 #ifdef __cplusplus
 const MojoPropertyType MOJO_PROPERTY_TYPE_SYNC_CALL_ALLOWED = 0;
 #else
 #define MOJO_PROPERTY_TYPE_SYNC_CALL_ALLOWED ((MojoPropertyType)0)
 #endif
 
 #endif  // MOJO_PUBLIC_C_SYSTEM_TYPES_H_