Changeset 1616 for trunk


Ignore:
Timestamp:
Aug 13, 2011, 8:32:14 PM (14 years ago)
Author:
Gregg Young
Message:

Updated a*.c files to Doxygen commenting style. (Ticket 55)

Location:
trunk/dll
Files:
5 edited

Legend:

Unmodified
Added
Removed

  • trunk/dll/arccnrs.c

    r1554 r1616  
    8686  20 Nov 10 GKY Check that pTmpDir IsValid and recreate if not found; Fixes hangs caused
    8787                by temp file creation failures.
     88  13 Aug 11 GKY Change to Doxygen comment format
    8889
    8990***********************************************************************/
    … …  
    383384      ret = TestCDates(&pai1->date, &pai1->time,
    384385                       &pai2->date, &pai2->time);
    385         /*(pai1->date.year < pai2->date.year) ? 1 :
    386         (pai1->date.year > pai2->date.year) ? -1 :
    387         (pai1->date.month < pai2->date.month) ? 1 :
    388         (pai1->date.month > pai2->date.month) ? -1 :
    389         (pai1->date.day < pai2->date.day) ? 1 :
    390         (pai1->date.day > pai2->date.day) ? -1 :
    391         (pai1->time.hours < pai2->time.hours) ? 1 :
    392         (pai1->time.hours > pai2->time.hours) ? -1 :
    393         (pai1->time.minutes < pai2->time.minutes) ? 1 :
    394         (pai1->time.minutes > pai2->time.minutes) ? -1 :
    395         (pai1->time.seconds < pai2->time.seconds) ? 1 :
    396         (pai1->time.seconds > pai2->time.seconds) ? -1 : 0;*/
    397386      break;
    398387
    … …  
    718707          gotend = TRUE;
    719708        else {
    720           /* add to container */
     709          // add to container
    721710          fname = NULL;
    722711          bstrip(s);
    … …  
    739728          for (fieldnum = 0; fieldnum <= highest; fieldnum++) {
    740729            pp = p;
    741             while (*pp && (*pp == ' ' || *pp == '\t'))  /* skip leading */
     730            while (*pp && (*pp == ' ' || *pp == '\t'))  // skip leading
    742731              pp++;
    743732            if (!*pp)
    … …  
    795784            else if (fieldnum == info->fnpos) {
    796785              fname = pp;
    797               if (pp && *pp == '*' && !*(pp + 1))       /* workaround for LH.EXE */
     786              if (pp && *pp == '*' && !*(pp + 1))       // workaround for LH.EXE
    798787                fname = NULL;
    799788              if (info->nameislast)
    … …  
    927916      }
    928917      else if (!nomove && tinfo) {
    929         /* if we got a false hit, move working hit to top */
     918        // if we got a false hit, move working hit to top
    930919        tinfo = info->next;
    931920        info->next = arcsighead;
    … …  
    12191208        if (AcceptOneDrop(hwnd, mp1, mp2))
    12201209          return MRFROM2SHORT(DOR_DROP, DO_MOVE);
    1221         return MRFROM2SHORT(DOR_NODROP, 0);     /* Drop not valid */
     1210        return MRFROM2SHORT(DOR_NODROP, 0);     // Drop not valid
    12221211      case DM_DROPHELP:
    12231212        DropHelp(mp1, mp2, hwnd, GetPString(IDS_ARCCNRFOLDERDROPHELPTEXT));
    … …  
    15121501      Fortify_BecomeOwner(dcd);
    15131502#     endif
    1514       /* set unique id */
     1503      // set unique id
    15151504      WinSetWindowUShort(hwnd, QWS_ID, ARCOBJ_FRAME + (ARC_FRAME - dcd->id));
    15161505      dcd->hwndObject = hwnd;           // pass back hwnd
    … …  
    15211510
    15221511  case UM_RESCAN:
    1523     /*
     1512    /**
    15241513     * populate container
    15251514     */
    … …  
    16801669            ad.namecanchange = 0;
    16811670            ad.fmoving = (li->type == IDM_ARCHIVEM);
    1682             if (!WinDlgBox(HWND_DESKTOP, dcd->hwndClient, ArchiveDlgProc, FM3ModHandle, ARCH_FRAME, (PVOID) & ad) || !*ad.arcname || !*ad.command)      /* we blew it */
     1671            if (!WinDlgBox(HWND_DESKTOP, dcd->hwndClient, ArchiveDlgProc,
     1672                           FM3ModHandle, ARCH_FRAME, (PVOID) & ad) || !*ad.arcname ||
     1673                !*ad.command)   // we blew it
    16831674              break;
    1684             /* build the sucker */
     1675            // build the sucker
    16851676            strcpy(szBuffer, ad.command);
    16861677            strcat(szBuffer, " ");
    … …  
    19161907            } while (li->list[x]);
    19171908            if (li->type == IDM_EXTRACT || li->type == IDM_EXTRACTWDIRS) {
    1918               /* update windows */
     1909              // update windows
    19191910              for (x = 0; li->list[x]; x++) {
    19201911
    … …  
    22982289
    22992290  case WM_SETFOCUS:
    2300     /*
     2291    /**
    23012292     * put name of our window (archive name) on status line
    23022293     */
    … …  
    24142405    else {
    24152406      if (!dcd->hwndObject) {
    2416         /*
     2407        /**
    24172408         * first time through -- set things up
    24182409         */
    … …  
    26932684
    26942685      case IDM_WINDOWSMENU:
    2695         /*
     2686        /**
    26962687         * add switchlist entries to end of pulldown menu
    26972688         */
    … …  
    28932884      case IDM_SORTLWDATE:
    28942885        dcd->sortFlags &= SORT_REVERSE;
    2895         /* intentional fallthru */
     2886        // intentional fallthru
    28962887      case IDM_SORTREVERSE:
    28972888        switch (SHORT1FROMMP(mp1)) {
    … …  
    32183209
    32193210          pDInfo = ((PCNRDRAGINFO) mp2)->pDragInfo;
    3220           DrgAccessDraginfo(pDInfo);    /* Access DRAGINFO */
    3221           DrgFreeDraginfo(pDInfo);      /* Free DRAGINFO */
     3211          DrgAccessDraginfo(pDInfo);    // Access DRAGINFO
     3212          DrgFreeDraginfo(pDInfo);      // Free DRAGINFO
    32223213        }
    32233214        return 0;
    … …  
    32273218        if (mp2) {
    32283219
    3229           PDRAGITEM pDItem;             /* Pointer to DRAGITEM */
    3230           PDRAGINFO pDInfo;             /* Pointer to DRAGINFO */
     3220          PDRAGITEM pDItem;             // Pointer to DRAGITEM
     3221          PDRAGINFO pDInfo;             // Pointer to DRAGINFO
    32313222          PARCITEM pci;
    32323223
    … …  
    32353226            pci = NULL;
    32363227          pDInfo = ((PCNRDRAGINFO) mp2)->pDragInfo;
    3237           DrgAccessDraginfo(pDInfo);    /* Access DRAGINFO */
     3228          DrgAccessDraginfo(pDInfo);    // Access DRAGINFO
    32383229          if (*dcd->arcname) {
    32393230            if ((driveflags[toupper(*dcd->arcname) - 'A'] &
    … …  
    32473238            return MRFROM2SHORT(DOR_NODROP, 0);
    32483239          }
    3249           pDItem = DrgQueryDragitemPtr(pDInfo,  /* Access DRAGITEM */
    3250                                        0);      /* Index to DRAGITEM */
    3251           if (DrgVerifyRMF(pDItem,      /* Check valid rendering */
    3252                            (CHAR *) DRM_OS2FILE,        /* mechanisms and data */
     3240          pDItem = DrgQueryDragitemPtr(pDInfo,          // Access DRAGITEM
     3241                                       0);              // Index to DRAGITEM
     3242          if (DrgVerifyRMF(pDItem,                      // Check valid rendering
     3243                           (CHAR *) DRM_OS2FILE,        // mechanisms and data
    32533244                           NULL) && !(pDItem->fsControl & DC_PREPARE)) {
    3254             DrgFreeDraginfo(pDInfo);    /* Free DRAGINFO */
    3255             return MRFROM2SHORT(DOR_DROP,       /* Return okay to drop */
     3245            DrgFreeDraginfo(pDInfo);    // Free DRAGINFO
     3246            return MRFROM2SHORT(DOR_DROP,       // Return okay to drop
    32563247                                fCopyDefault ? DO_COPY : DO_MOVE);
    32573248          }
    3258           DrgFreeDraginfo(pDInfo);      /* Free DRAGINFO */
    3259         }
    3260         return (MRFROM2SHORT(DOR_NEVERDROP, 0));        /* Drop not valid */
     3249          DrgFreeDraginfo(pDInfo);      // Free DRAGINFO
     3250        }
     3251        return (MRFROM2SHORT(DOR_NEVERDROP, 0));        // Drop not valid
    32613252
    32623253      case CN_INITDRAG:
    … …  
    35873578                 ARC_TYPE * sinfo)
    35883579{
    3589   /*
     3580  /**
    35903581   * bitmapped flags:
    35913582   *  1 = am extracted from another archive

  • trunk/dll/assoc.c

    r1594 r1616  
    2727  01 May 10 GKY Changes to move environment storage to INI file
    2828  03 Jul 11 GKY Fixed failure to save associations after reordering item to the top or bottom.
     29  13 Aug 11 GKY Change to Doxygen comment format
    2930
    3031**************************************************************************************/
    … …  
    195196          !xfgets(offset, sizeof(offset), fp, pszSrcFile, __LINE__) ||
    196197          !xfgets(flags, sizeof(flags), fp, pszSrcFile, __LINE__))
    197         break;                          /* error! */
     198        break;                          // error!
    198199      pszCmdLine[MaxComLineStrg - 1] = 0;
    199200      bstripcr(pszCmdLine);
    … …  
    241242VOID display_associations(HWND hwnd, ASSOC *temp, LINKASSOC *info)
    242243{
    243   //CHAR szEnviroment[ENVIRONMENT_SIZE];
    244244  PSZ pszDisplayStr;
    245245  SHORT x;
    246246
    247   //*szEnviroment = 0;
    248   //WinQueryDlgItemText(hwnd, ASS_ENVIRON, ENVIRONMENT_SIZE - 1, szEnviroment);
    249   //bstripcr(szEnviroment);
    250   //if (*szEnviroment)
    251   //  PrfWriteProfileString(fmprof, FM3Str, temp->pszCmdLine, szEnviroment);
    252247  pszDisplayStr = xmallocz((CCHMAXPATH * 2) + MaxComLineStrg + 6,
    253248                           pszSrcFile, __LINE__);
    … …  
    289284    next = info->next;
    290285    if (!strcmp("*", info->mask)) {
    291       if (info != asshead) {            /* already top record */
     286      if (info != asshead) {            // already top record
    292287        if (info->prev)
    293288          (info->prev)->next = info->next;
    … …  
    371366        }
    372367        else {
    373           if (!asshead)                 /* only item in list */
     368          if (!asshead)                 // only item in list
    374369            asshead = asstail = info;
    375370          else {
    376             if (asstail) {              /* place at tail */
     371            if (asstail) {              // place at tail
    377372              asstail->next = info;
    378373              info->prev = asstail;
    … …  
    505500        fclose(fp);
    506501      }
    507       if (didmatch) {                   /* got a match; do it... */
     502      if (didmatch) {                   // got a match; do it...
    508503
    509504        CHAR *list[2];
    … …  
    807802        info = add_association(&temp);
    808803        if (!info)
    809           WinDismissDlg(hwnd, 1);       /* Runtime_Error(pszSrcFile, __LINE__, "add_association"); */
     804          WinDismissDlg(hwnd, 1);       
    810805        else {
    811806          display_associations(hwnd, &temp, info);

  • trunk/dll/autoview.c

    r1498 r1616  
    3636                one or more miniapp but not to FM/2
    3737  17 JAN 10 GKY Changes to get working with Watcom 1.9 Beta (1/16/10). Mostly cast CHAR CONSTANT * as CHAR *.
     38  13 Aug 11 GKY Change to Doxygen comment format
    3839
    3940***********************************************************************/
    … …  
    9899             CHAR * data)
    99100{
    100   /* save an ea to disk */
     101  // save an ea to disk
    101102
    102103  FEA2LIST *pfealist = NULL;
    … …  
    236237      break;
    237238    }
    238     pfealist->list[0].cbValue = /*(ULONG)*/ (eaval -
    239                                          (pfealist->list[0].szName +
     239    pfealist->list[0].cbValue = (eaval - (pfealist->list[0].szName +
    240240                                          pfealist->list[0].cbName + 1));
    241241    memset(&eaop, 0, sizeof(eaop));
    … …  
    256256  register CHAR *p;
    257257
    258   if (comments) {                       /* check -- is it empty? */
     258  if (comments) {                       // check -- is it empty?
    259259    p = comments;
    260260    while (*p && isspace(*p))
    … …  
    632632                    readonly = TRUE;
    633633                }
    634                 /* else EA not present */
     634                // else EA not present
    635635                MLEsetchanged(hwndAutoMLE, FALSE);
    636636                MLEsetreadonly(hwndAutoMLE, readonly);

  • trunk/dll/avl.c

    r1557 r1616  
    4040  23 Oct 10 GKY Changes to populate and utilize a HELPTABLE for context specific help
    4141  21 Nov 10 GKY Check if archiver.bb2 has been changed on disk before editing
     42  13 Aug 11 GKY Change to Doxygen comment format
    4243
    4344***********************************************************************/
    … …  
    126127
    127128  for (pat = arcsighead; pat; pat = pat->next) {
    128     /*
     129    /**
    129130     * this inner loop tests for a dup signature entry and assures
    130131     * that only the entry at the top of the list gets used for
    … …  
    242243    if (!DosChgFilePtr(handle,
    243244                       abs(info->file_offset),
    244                        (info->file_offset >= 0) ?
    245                        FILE_BEGIN : FILE_END, &len)) {
     245                       (info->file_offset >= 0) ? FILE_BEGIN : FILE_END,
     246                      &len)) {
    246247      if (!DosRead(handle, buffer, l, &len) && len == l) {
    247248        if (!memcmp(info->signature, buffer, l))
    … …  
    252253  }                                     // for
    253254
    254   DosClose(handle);                     /* Either way, we're done for now */
    255   return info;                          /* Return signature, if any */
     255  DosClose(handle);                     // Either way, we're done for now
     256  return info;                          // Return signature, if any
    256257}
    257258
    … …  
    659660          ditem.hstrSourceName = DrgAddStrHandle(NullStr);
    660661          ditem.hstrTargetName = DrgAddStrHandle(NullStr);
    661           // ditem.fsControl = 0;
    662662          ditem.fsSupportedOps = DO_MOVEABLE;
    663663
    … …  
    671671          dimage.cxOffset = -16;
    672672          dimage.cyOffset = 0;
    673           DrgSetDragitem(pDInfo, &ditem, sizeof(DRAGITEM), 0);  /* Index of DRAGITEM */
    674           hwndDrop = DrgDrag(hwnd, pDInfo, &dimage, 1,  /* One DRAGIMAGE */
     673          DrgSetDragitem(pDInfo, &ditem, sizeof(DRAGITEM), 0);  // Index of DRAGITEM
     674          hwndDrop = DrgDrag(hwnd, pDInfo, &dimage, 1,  // One DRAGIMAGE
    675675                             VK_ENDDRAG, NULL);
    676676          if (!hwndDrop)
    … …  
    678678
    679679          DrgFreeDraginfo(pDInfo);
    680           // WinSetWindowPos(hwnd,HWND_TOP,0,0,0,0,SWP_ACTIVATE);
    681680        }
    682681      }
    … …  
    701700      // fprintf(stderr, "DRAGOVER posted 0x%x WM_BUTTON1CLICK x y %d %d\n", hwnd, ptl2.x, ptl2.y);
    702701    }
    703     pDInfo = (PDRAGINFO) mp1;           /* Get DRAGINFO pointer */
     702    pDInfo = (PDRAGINFO) mp1;           // Get DRAGINFO pointer
    704703    if (pDInfo) {
    705704      if (!DrgAccessDraginfo(pDInfo)) {
    … …  
    709708      else {
    710709        pDItem = DrgQueryDragitemPtr(pDInfo, 0);
    711         /* Check valid rendering mechanisms and data format */
     710        // Check valid rendering mechanisms and data format
    712711        ok = DrgVerifyRMF(pDItem, DRM_LBOX, NULL);
    713712        DrgFreeDraginfo(pDInfo);
    … …  
    737736      // DrawTargetEmphasis(hwnd, emphasized);
    738737    }
    739     pDInfo = (PDRAGINFO) mp1;           /* Get DRAGINFO pointer */
     738    pDInfo = (PDRAGINFO) mp1;           // Get DRAGINFO pointer
    740739    if (pDInfo) {
    741740      if (!DrgAccessDraginfo(pDInfo)) {
    … …  
    747746        if (!pDItem)
    748747          Win_Error(hwnd, hwnd, pszSrcFile, __LINE__, "DM_DROP");
    749         /* Check valid rendering mechanisms and data */
     748        // Check valid rendering mechanisms and data
    750749        ok = DrgVerifyRMF(pDItem, DRM_LBOX, NULL)
    751750                          && ~pDItem->fsControl & DC_PREPARE;
    752751        if (ok) {
    753           // ret = FullDrgName(pDItem,buffer,buflen);
    754           /* note: targetfail is returned to source for all items */
     752          // note: targetfail is returned to source for all items
    755753          DrgSendTransferMsg(pDInfo->hwndSource, DM_ENDCONVERSATION,
    756754                             MPFROMLONG(pDItem->ulItemID),
    … …  
    804802      break;
    805803    }
    806     /* Passed arg points to where to return selected archiver definition
     804    /** Passed arg points to where to return selected archiver definition
    807805     * On input arg value controls selection list content
    808806     * If non-NULL, dup names are suppressed
    … …  
    11211119}
    11221120
    1123 /*
    1124    see archiver.tmp
    1125    02-08-96  23:55              1
    1126    8 Feb 96 23:55:32            2
    1127    8 Feb 96  11:55p             3
    1128    96-02-08 23:55:32            4
    1129    31-02-98  23:55              5
     1121/**
     1122 *  see archiver.tmp
     1123 *  02-08-96  23:55              1
     1124 *  8 Feb 96 23:55:32            2
     1125 *  8 Feb 96  11:55p             3
     1126 *  96-02-08 23:55:32            4
     1127 *  31-02-98  23:55              5
    11301128 */
    11311129

  • trunk/dll/avv.c

    r1544 r1616  
    3030  11 Jan 08 GKY Replace "ARCHIVER.BB2" in string file with global set at compile in init.c
    3131  17 JAN 10 GKY Changes to get working with Watcom 1.9 Beta (1/16/10). Mostly cast CHAR CONSTANT * as CHAR *.
     32  13 Aug 11 GKY Change to Doxygen comment format
    3233
    3334***********************************************************************/
    … …  
    247248    archiverbb2 = (PSZ) PCSZ_ARCHIVERBB2;
    248249  }
    249   /* Check space on drive*/
    250   if (CheckDriveSpaceAvail(archiverbb2, ullDATFileSpaceNeeded * 4, 1) == 2) //* 4 is because this file is larger than other .dat files
     250  // Check space on drive
     251  if (CheckDriveSpaceAvail(archiverbb2, ullDATFileSpaceNeeded * 4, 1) == 2) // 4 is because this file is larger than other .dat files
    251252    return; //already gave error msg
    252253
    253   /* save a backup */
     254  // save a backup
    254255  psz = strrchr(archiverbb2, '.');
    255256  if (psz && !stricmp(psz, PCSZ_DOTBB2)) {
Note: See TracChangeset for help on using the changeset viewer.