Fixed grammar error and fixed problem with TODO items (changed to 'C' style comment so Doxygen strips them out). Tried // but it caused the generator to not write the file.

Review URL: http://codereview.chromium.org/9235017

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@122332 0039d316-1c4b-4281-b951-d872f2087c98

4 files changed, 10 insertions, 15 deletions

diff --git a/ppapi/api/ppb_file_io.idl b/ppapi/api/ppb_file_io.idl
index 9661e49..58f3f13 100644
--- a/ppapi/api/ppb_file_io.idl
+++ b/ppapi/api/ppb_file_io.idl
@@ -154,7 +154,7 @@ interface PPB_FileIO {
    * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
    * completion of Read().
    *
-   * @return An The number of bytes read an error code from
+   * @return The number of bytes read or an error code from
    * <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
    * reached. It is valid to call Read() multiple times with a completion
    * callback to queue up parallel reads from the file, but pending reads
@@ -179,7 +179,7 @@ interface PPB_FileIO {
    * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
    * completion of Write().
    *
-   * @return An The number of bytes written or an error code from
+   * @return The number of bytes written or an error code from
    * <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
    * reached. It is valid to call Write() multiple times with a completion
    * callback to queue up parallel writes to the file, but pending writes
diff --git a/ppapi/api/ppb_graphics_2d.idl b/ppapi/api/ppb_graphics_2d.idl
index 7d60497..0e0649e 100644
--- a/ppapi/api/ppb_graphics_2d.idl
+++ b/ppapi/api/ppb_graphics_2d.idl
@@ -240,12 +240,9 @@ interface PPB_Graphics2D {
    * and no callback will be scheduled.
    */
 
-  /*
-   * TODO(darin): We should ensure that the completion callback always runs, so
+  /* TODO(darin): We should ensure that the completion callback always runs, so
    * that it is easier for consumers to manage memory referenced by a callback.
-   */
-
-  /*
+   *
    * TODO(): Add back in the synchronous mode description once we have support
    * for it.
    */
diff --git a/ppapi/c/ppb_file_io.h b/ppapi/c/ppb_file_io.h
index 51203dd..4b9db95 100644
--- a/ppapi/c/ppb_file_io.h
+++ b/ppapi/c/ppb_file_io.h
@@ -3,7 +3,7 @@
  * found in the LICENSE file.
  */
 
-/* From ppb_file_io.idl modified Thu Jan 12 16:13:13 2012. */
+/* From ppb_file_io.idl modified Wed Feb 15 15:55:56 2012. */
 
 #ifndef PPAPI_C_PPB_FILE_IO_H_
 #define PPAPI_C_PPB_FILE_IO_H_
@@ -170,7 +170,7 @@ struct PPB_FileIO_1_0 {
    * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
    * completion of Read().
    *
-   * @return An The number of bytes read an error code from
+   * @return The number of bytes read or an error code from
    * <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
    * reached. It is valid to call Read() multiple times with a completion
    * callback to queue up parallel reads from the file, but pending reads
@@ -194,7 +194,7 @@ struct PPB_FileIO_1_0 {
    * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
    * completion of Write().
    *
-   * @return An The number of bytes written or an error code from
+   * @return The number of bytes written or an error code from
    * <code>pp_errors.h</code>. If the return value is 0, then end-of-file was
    * reached. It is valid to call Write() multiple times with a completion
    * callback to queue up parallel writes to the file, but pending writes
diff --git a/ppapi/c/ppb_graphics_2d.h b/ppapi/c/ppb_graphics_2d.h
index f9c9953..9224d1b 100644
--- a/ppapi/c/ppb_graphics_2d.h
+++ b/ppapi/c/ppb_graphics_2d.h
@@ -3,7 +3,7 @@
  * found in the LICENSE file.
  */
 
-/* From ppb_graphics_2d.idl modified Thu Jan 12 16:11:14 2012. */
+/* From ppb_graphics_2d.idl modified Tue Jan 24 16:03:48 2012. */
 
 #ifndef PPAPI_C_PPB_GRAPHICS_2D_H_
 #define PPAPI_C_PPB_GRAPHICS_2D_H_
@@ -245,11 +245,9 @@ struct PPB_Graphics2D_1_0 {
    * not issued its callback yet.  In the failure case, nothing will be updated
    * and no callback will be scheduled.
    */
-  /*
-   * TODO(darin): We should ensure that the completion callback always runs, so
+  /* TODO(darin): We should ensure that the completion callback always runs, so
    * that it is easier for consumers to manage memory referenced by a callback.
-   */
-  /*
+   *
    * TODO(): Add back in the synchronous mode description once we have support
    * for it.
    */