[ros-diffs] [cwittich] 32279: translate some GreatLordish comments into something more similar to English

[cwittich at svn.reactos.org]

Author: cwittich
Date: Sun Feb 10 23:45:56 2008
New Revision: 32279

URL: http://svn.reactos.org/svn/reactos?rev=32279&view=rev
Log:
translate some GreatLordish comments into something more similar to English

Modified:
    trunk/reactos/dll/directx/ddraw/cleanup.c
    trunk/reactos/dll/directx/ddraw/main.c

Modified: trunk/reactos/dll/directx/ddraw/cleanup.c
URL: http://svn.reactos.org/svn/reactos/trunk/reactos/dll/directx/ddraw/cleanup.c?rev=32279&r1=32278&r2=32279&view=diff
==============================================================================
--- trunk/reactos/dll/directx/ddraw/cleanup.c (original)
+++ trunk/reactos/dll/directx/ddraw/cleanup.c Sun Feb 10 23:45:56 2008
@@ -35,7 +35,7 @@
     DdDeleteDirectDrawObject(&ddgbl);
 
     /*
-       are it any more I forget to release ?
+       anything else to release?
     */
 
     /* release the linked interface */

Modified: trunk/reactos/dll/directx/ddraw/main.c
URL: http://svn.reactos.org/svn/reactos/trunk/reactos/dll/directx/ddraw/main.c?rev=32279&r1=32278&r2=32279&view=diff
==============================================================================
--- trunk/reactos/dll/directx/ddraw/main.c (original)
+++ trunk/reactos/dll/directx/ddraw/main.c Sun Feb 10 23:45:56 2008
@@ -77,8 +77,8 @@
 *        <FILLMEIN>.
 *
 * @param pUnkOuter
-*        Alwas set to NULL other wise will  DirectDrawCreate fail it return
-*        errror code CLASS_E_NOAGGREGATION
+*        Always set to NULL otherwise DirectDrawCreate will fail and return
+*        error code CLASS_E_NOAGGREGATION
 *
 * @return  <FILLMEIN>.
 *
@@ -94,14 +94,14 @@
 {
     HRESULT retVal = DDERR_GENERIC;
     /*
-       remove this when UML digram are in place
-       this api is finish and is working as it should
+       remove this when UML diagram is in place
+       this api is finished and is working as it should
     */
 
     DX_WINDBG_trace();
      _SEH_TRY
     {
-        /* check see if pUnkOuter is null or not */
+        /* check if pUnkOuter is null or not */
         if (pUnkOuter)
         {
             retVal = CLASS_E_NOAGGREGATION;
@@ -131,8 +131,8 @@
 *        <FILLMEIN>.
 *
 * @param pUnkOuter
-*        Alwas set to NULL other wise will  DirectDrawCreateEx fail it return
-*        errror code CLASS_E_NOAGGREGATION
+*        Always set to NULL otherwise DirectDrawCreateEx will fail and return
+*        error code CLASS_E_NOAGGREGATION
 *
 * @return  <FILLMEIN>.
 *
@@ -148,8 +148,8 @@
 {
     HRESULT retVal = DDERR_GENERIC;
     /*
-        remove this when UML digram are in place
-        this api is finish and is working as it should
+        remove this when UML diagram is in place
+        this api is finished and is working as it should
     */
     DX_WINDBG_trace();
 
@@ -249,17 +249,17 @@
             RegCloseKey(hKey);
         }
 
-        /* Call the user supplyed callback function */
+        /* Call the user supplied callback function */
         rc = lpCallback(NULL, strMsg, "display", lpContext, NULL);
 
-        /* If the callback function returns DDENUMRET_CANCEL, we will stop enumerating devices now */
+        /* If the callback function returns DDENUMRET_CANCEL, we will stop enumerating devices */
         if(rc == DDENUMRET_CANCEL)
         {
             retVal = DD_OK;
         }
         else
         {
-            // not finish
+            // not finished
             retVal = DDERR_UNSUPPORTED;
         }
     }
@@ -295,11 +295,10 @@
    See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/
        Display_d/hh/Display_d/d3d_21ac30ea-9803-401e-b541-6b08af79653d.xml.asp
 
-   for more info about this command
-
-   summuer the msdn
-
-    The buffer start with D3DHAL_DP2COMMAND struct afer that it follow either one struct or no struct at at all
+   for more info about this command see msdn documentation
+
+    The buffer start with D3DHAL_DP2COMMAND struct afer that follows either one struct or 
+    no struct at at all
     example for command D3DDP2OP_VIEWPORTINFO
 
     then lpCmd will look like this
@@ -311,9 +310,9 @@
     | D3DHAL_DP2VIEWPORTINFO | 0x04 - xxxx |
     ---------------------------------------
 
-    to calc end of the lpCmd buffer in this exmaple
+    to calculate the end of the lpCmd buffer in this exmaple
     D3DHAL_DP2COMMAND->wStateCount * sizeof(D3DHAL_DP2VIEWPORTINFO);
-    now you got number of bytes but we need add the size of D3DHAL_DP2COMMAND
+    now you got number of bytes but we need to add the size of D3DHAL_DP2COMMAND
     to get this right. the end should be
     sizeof(D3DHAL_DP2COMMAND) + ( D3DHAL_DP2COMMAND->wStateCount * sizeof(D3DHAL_DP2VIEWPORTINFO));
     to get the xxxx end positions.
@@ -338,12 +337,12 @@
 *       } D3DHAL_DP2COMMAND, *LPD3DHAL_DP2COMMAND;
 *
 *       lpCmd->bCommand
-*       only accpect D3DDP2OP_VIEWPORTINFO, and undocument command 0x0D
-*       rest of the command will be return error code for.
+*       only accept D3DDP2OP_VIEWPORTINFO, and undocumented command 0x0D
+*       anything else will result in an error
 *
         Command 0x0D
 *       dp2command->bReserved
-*       is how big struect we got in wStateCount or how many wStateCount we got
+*       is the size of the struct we got in wStateCount or how many wStateCount we got
 *       do not known more about it, no info in msdn about it either.
 *
 *       Command  D3DDP2OP_VIEWPORTINFO
@@ -378,7 +377,7 @@
 
     switch (dp2command->bCommand)
     {
-       /* check for vaild command, only 3 command is vaild */
+       /* check for vaild command, only 3 commands are vaild */
        case D3DDP2OP_VIEWPORTINFO:
            *(PBYTE)lpRetCmd += ((dp2command->wStateCount * sizeof(D3DHAL_DP2VIEWPORTINFO)) + sizeof(D3DHAL_DP2COMMAND));
            break;