Changeset 1673 for trunk/dll/treecnr.c

Timestamp:

Dec 30, 2012, 7:51:01 PM (13 years ago)

Author:

Gregg Young

Message:

Update to Doxygen comment style Ticket 55. Also some minor code cleanup.

File:

• trunk/dll/treecnr.c (modified) (15 diffs)

trunk/dll/treecnr.c

@@ -265 +265 @@
                  BOOL maketop)
 {
-  /* Find a record in tree view, move it so it shows in container and
-     make it the current record */
+    /**
+     * Find a record in tree view, move it so it shows in container and
+     * make it the current record
+     */
 
   PCNRITEM pci, pciToSelect, pciP;
@@ -341 +343 @@
         } // while
       }
-      /* expand all parent branches */
+      // expand all parent branches
       pciToSelect = pci;
       for (;;) {
@@ -358 +360 @@
       } // for
     }
-    /* make record visible */
+    // make record visible
   MakeTop:
     pciToSelect = pci;
@@ -471 +473 @@
       mr = CommonFrameWndProc(TREE_CNR, hwnd, msg, mp1, mp2);
 
-      /*
+      /**
        * Calculate the position of the client rectangle.
        * Otherwise,  we'll see a lot of redraw when we move the
@@ -492 +494 @@
       sCount = (SHORT) CommonFrameWndProc(TREE_CNR, hwnd, msg, mp1, mp2);
 
-      /*
-       * Reformat the frame to "squeeze" the client
-       */
+      // Reformat the frame to "squeeze" the client
 
       pswp = (PSWP) mp1;
@@ -843 +843 @@
           }
           else {
-            /* find root record and strip it */
+            // find root record and strip it
             pci = FindParentRecord(dcd->hwndCnr, pci);
             driveserial[toupper(*pci->pszFileName) - 'A'] = -1;
@@ -857 +857 @@
 
   case UM_RESCAN:
-    /*
-     * populate container
-     */
+    // populate container
     DosWaitEventSem(hevTreeCnrScanComplete, SEM_INDEFINITE_WAIT);
     DosResetEventSem(hevTreeCnrScanComplete, &ulScanPostCnt);
@@ -1188 +1186 @@
 
     if (dcd && dcd->hwndFrame == WinQueryActiveWindow(dcd->hwndParent)) {
-      /*
-       * put name of our window on status line
-       */
+      // put name of our window on status line
 
       PCNRITEM pci = NULL;
@@ -1262 +1258 @@
     else {
       if (!dcd->hwndObject) {
-        /*
-         * first time through -- set things up
-         */
+        // first time through -- set things up
         CNRINFO cnri;
 
@@ -1461 +1455 @@
             Win_Error(hwnd, hwnd, pszSrcFile, __LINE__,
                       PCSZ_DRGACCESSDRAGINFO);
-            return (MRFROM2SHORT(DOR_NODROP, 0));       /* Drop not valid */
+            return (MRFROM2SHORT(DOR_NODROP, 0));       // Drop not valid
           }
           pci = (PCNRITEM) ((PCNRDRAGINFO) mp2)->pRecord;
@@ -1503 +1497 @@
             }
           }
-          pDItem = DrgQueryDragitemPtr(pDInfo,  /* Access DRAGITEM */
-                                       0);      /* Index to DRAGITEM */
-          if (DrgVerifyRMF(pDItem,      /* Check valid rendering */
-                           (CHAR *) DRM_OS2FILE,        /* mechanisms and data */
-                           NULL) || DrgVerifyRMF(pDItem, (CHAR *) DRM_FM2ARCMEMBER,
-                                                 (CHAR *) DRF_FM2ARCHIVE)) {    /* formats */
-            DrgFreeDraginfo(pDInfo);    /* Free DRAGINFO */
+          pDItem = DrgQueryDragitemPtr(pDInfo,          // Access DRAGITEM
+                                       0);              // Index to DRAGITEM
+          if (DrgVerifyRMF(pDItem,                      // Check valid rendering
+                           (CHAR *) DRM_OS2FILE,        // mechanisms and data
+                           NULL) || DrgVerifyRMF(pDItem,
+                                                 (CHAR *) DRM_FM2ARCMEMBER,
+                                                 (CHAR *) DRF_FM2ARCHIVE)) {    // formats
+            DrgFreeDraginfo(pDInfo);                    // Free DRAGINFO
             if (!pci || (INT) pci == -1)
               return MRFROM2SHORT(DOR_DROP, DO_MOVE);
@@ -1517 +1512 @@
             if (toupper(*pci->pszFileName) < 'C')
               return MRFROM2SHORT(DOR_DROP, DO_COPY);
-            return MRFROM2SHORT(DOR_DROP,       /* Return okay to drop */
+            return MRFROM2SHORT(DOR_DROP,               // Return okay to drop
                                 ((fCopyDefault) ? DO_COPY : DO_MOVE));
           }
-          DrgFreeDraginfo(pDInfo);      /* Free DRAGINFO */
-        }
-        return MRFROM2SHORT(DOR_NODROP, 0);     /* Drop not valid */
+          DrgFreeDraginfo(pDInfo);                      // Free DRAGINFO
+        }
+        return MRFROM2SHORT(DOR_NODROP, 0);             // Drop not valid
 
       case CN_INITDRAG:
@@ -2917 +2912 @@
           }
         }
-        /* else intentional fallthru */
+        // else intentional fallthru
       case IDM_ATTRS:
       case IDM_INFO:
@@ -3103 +3098 @@
       dcd->stopflag++;
     if (dcd && dcd->hwndObject) {
-      /* kill object window */
+      // kill object window
       if (WinIsWindow((HAB) 0, dcd->hwndObject)) {
         if (!PostMsg(dcd->hwndObject, WM_CLOSE, MPVOID, MPVOID))
@@ -3150 +3145 @@
 HWND StartTreeCnr(HWND hwndParent, ULONG flags)
 {
-  /* bitmapped flags:
+  /**
+   * bitmapped flags:
    * 0x00000001 = don't close app when window closes
    * 0x00000002 = no frame controls