[m] Lots of Doxygen fixes/additions - thanks to lfxGroove

cmake/FindTBB.cmake

@@ -1,4 +1,3 @@
-#
 # Locate Intel Threading Building Blocks include paths and libraries
 # CPPunit can be found at http://cppunit.sourceforge.net
 # Written by Michael Hammer, michael _at_ derhammer.net

cmake/ImportACE.cmake

@@ -1,4 +1,3 @@
-#
 # This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
 #
 # This program is free software; you can redistribute it and/or modify
@@ -14,7 +13,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-#
 
 # Specify ace lib that was build externally
 # add_library(ace SHARED IMPORTED)
@@ -56,4 +54,3 @@ if(WIN32)
     )
   endforeach(DIR)
 endif()
-

cmake/ImportTBB.cmake

@@ -1,4 +1,3 @@
-#
 # This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
 #
 # This program is free software; you can redistribute it and/or modify
@@ -14,7 +13,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-#
 
 # Specify tbb lib that was build externally
 # add_library(tbb SHARED IMPORTED)

contrib/extractor/System.cpp

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #define _CRT_SECURE_NO_DEPRECATE
 
 #include <stdio.h>
@@ -292,7 +310,7 @@ uint32 ReadMapDBC(int const locale)
         map_ids[x].id = dbc.getRecord(x).getUInt(0);
         strcpy(map_ids[x].name, dbc.getRecord(x).getString(1));
     }
-    printf("Done! (%u maps loaded)\n", map_count);
+    printf("Done! (%lu maps loaded)\n", map_count);
     return map_count;
 }
 
@@ -331,7 +349,7 @@ void ReadAreaTableDBC(int const locale)
 
     maxAreaId = dbc.getMaxId();
 
-    printf("Done! (%u areas loaded)\n", area_count);
+    printf("Done! (%lu areas loaded)\n", area_count);
 }
 
 void ReadLiquidTypeTableDBC(int const locale)
@@ -366,7 +384,7 @@ void ReadLiquidTypeTableDBC(int const locale)
     for(uint32 x = 0; x < LiqType_count; ++x)
         LiqType[dbc.getRecord(x).getUInt(0)] = dbc.getRecord(x).getUInt(3);
 
-    printf("Done! (%u LiqTypes loaded)\n", LiqType_count);
+    printf("Done! (%lu LiqTypes loaded)\n", LiqType_count);
 }
 
 //

contrib/extractor/dbcfile.cpp

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #define _CRT_SECURE_NO_DEPRECATE
 
 #include "dbcfile.h"
@@ -83,7 +101,6 @@ bool DBCFile::open()
     SFileCloseFile(fileHandle);
     return true;
 }
-
 DBCFile::~DBCFile()
 {
     delete [] data;

contrib/extractor/dbcfile.h

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #ifndef DBCFILE_H
 #define DBCFILE_H
 #include <cassert>

contrib/extractor/loadlib/adt.h

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #ifndef ADT_H
 #define ADT_H
 
@@ -28,15 +46,16 @@ enum LiquidType
 class ADT_file;
 class adt_MCVT
 {
-    union{
+        union
-        uint32 fcc;
+        {
-        char   fcc_txt[4];
+            uint32 fcc;
-    };
+            char   fcc_txt[4];
-    uint32 size;
+        };
-public:
+        uint32 size;
-    float height_map[(ADT_CELL_SIZE+1)*(ADT_CELL_SIZE+1)+ADT_CELL_SIZE*ADT_CELL_SIZE];
+    public:
+        float height_map[(ADT_CELL_SIZE + 1) * (ADT_CELL_SIZE + 1) + ADT_CELL_SIZE* ADT_CELL_SIZE];
 
-    bool  prepareLoadedData();
+        bool  prepareLoadedData();
 };
 
 //
@@ -44,28 +63,30 @@ public:
 //
 class adt_MCLQ
 {
-    union{
+        union
-        uint32 fcc;
+        {
-        char   fcc_txt[4];
+            uint32 fcc;
-    };
+            char   fcc_txt[4];
-    uint32 size;
+        };
-public:
+        uint32 size;
-    float height1;
+    public:
-    float height2;
+        float height1;
-    struct liquid_data{
+        float height2;
-        uint32 light;
+        struct liquid_data
-        float  height;
+        {
-    } liquid[ADT_CELL_SIZE+1][ADT_CELL_SIZE+1];
+            uint32 light;
+            float  height;
+        } liquid[ADT_CELL_SIZE + 1][ADT_CELL_SIZE + 1];
 
-    // 1<<0 - ochen
+        // 1<<0 - ochen
-    // 1<<1 - lava/slime
+        // 1<<1 - lava/slime
-    // 1<<2 - water
+        // 1<<2 - water
-    // 1<<6 - all water
+        // 1<<6 - all water
-    // 1<<7 - dark water
+        // 1<<7 - dark water
-    // == 0x0F - not show liquid
+        // == 0x0F - not show liquid
-    uint8 flags[ADT_CELL_SIZE][ADT_CELL_SIZE];
+        uint8 flags[ADT_CELL_SIZE][ADT_CELL_SIZE];
-    uint8 data[84];
+        uint8 data[84];
-    bool  prepareLoadedData();
+        bool  prepareLoadedData();
 };
 
 //
@@ -73,59 +94,60 @@ public:
 //
 class adt_MCNK
 {
-    union{
+        union
-        uint32 fcc;
+        {
-        char   fcc_txt[4];
+            uint32 fcc;
-    };
+            char   fcc_txt[4];
-    uint32 size;
+        };
-public:
+        uint32 size;
-    uint32 flags;
+    public:
-    uint32 ix;
+        uint32 flags;
-    uint32 iy;
+        uint32 ix;
-    uint32 nLayers;
+        uint32 iy;
-    uint32 nDoodadRefs;
+        uint32 nLayers;
-    uint32 offsMCVT;        // height map
+        uint32 nDoodadRefs;
-    uint32 offsMCNR;        // Normal vectors for each vertex
+        uint32 offsMCVT;        // height map
-    uint32 offsMCLY;        // Texture layer definitions
+        uint32 offsMCNR;        // Normal vectors for each vertex
-    uint32 offsMCRF;        // A list of indices into the parent file's MDDF chunk
+        uint32 offsMCLY;        // Texture layer definitions
-    uint32 offsMCAL;        // Alpha maps for additional texture layers
+        uint32 offsMCRF;        // A list of indices into the parent file's MDDF chunk
-    uint32 sizeMCAL;
+        uint32 offsMCAL;        // Alpha maps for additional texture layers
-    uint32 offsMCSH;        // Shadow map for static shadows on the terrain
+        uint32 sizeMCAL;
-    uint32 sizeMCSH;
+        uint32 offsMCSH;        // Shadow map for static shadows on the terrain
-    uint32 areaid;
+        uint32 sizeMCSH;
-    uint32 nMapObjRefs;
+        uint32 areaid;
-    uint16 holes;           // locations where models pierce the heightmap
+        uint32 nMapObjRefs;
-    uint16 pad;
+        uint16 holes;           // locations where models pierce the heightmap
-    uint16 s[2];
+        uint16 pad;
-    uint32 data1;
+        uint16 s[2];
-    uint32 data2;
+        uint32 data1;
-    uint32 data3;
+        uint32 data2;
-    uint32 predTex;
+        uint32 data3;
-    uint32 nEffectDoodad;
+        uint32 predTex;
-    uint32 offsMCSE;
+        uint32 nEffectDoodad;
-    uint32 nSndEmitters;
+        uint32 offsMCSE;
-    uint32 offsMCLQ;         // Liqid level (old)
+        uint32 nSndEmitters;
-    uint32 sizeMCLQ;         //
+        uint32 offsMCLQ;         // Liqid level (old)
-    float  zpos;
+        uint32 sizeMCLQ;         //
-    float  xpos;
+        float  zpos;
-    float  ypos;
+        float  xpos;
-    uint32 offsMCCV;         // offsColorValues in WotLK
+        float  ypos;
-    uint32 props;
+        uint32 offsMCCV;         // offsColorValues in WotLK
-    uint32 effectId;
+        uint32 props;
+        uint32 effectId;
 
-    bool   prepareLoadedData();
+        bool   prepareLoadedData();
-    adt_MCVT *getMCVT()
+        adt_MCVT* getMCVT()
-    {
+        {
-        if (offsMCVT)
+            if (offsMCVT)
-            return (adt_MCVT *)((uint8 *)this + offsMCVT);
+                return (adt_MCVT*)((uint8*)this + offsMCVT);
-        return 0;
+            return 0;
-    }
+        }
-    adt_MCLQ *getMCLQ()
+        adt_MCLQ* getMCLQ()
-    {
+        {
-        if (offsMCLQ)
+            if (offsMCLQ)
-            return (adt_MCLQ *)((uint8 *)this + offsMCLQ);
+                return (adt_MCLQ*)((uint8*)this + offsMCLQ);
-        return 0;
+            return 0;
-    }
+        }
 };
 
 //
@@ -133,33 +155,36 @@ public:
 //
 class adt_MCIN
 {
-    union{
+        union
-        uint32 fcc;
+        {
-        char   fcc_txt[4];
+            uint32 fcc;
-    };
+            char   fcc_txt[4];
-    uint32 size;
+        };
-public:
-    struct adt_CELLS{
-        uint32 offsMCNK;
         uint32 size;
-        uint32 flags;
+    public:
-        uint32 asyncId;
+        struct adt_CELLS
-    } cells[ADT_CELLS_PER_GRID][ADT_CELLS_PER_GRID];
+        {
+            uint32 offsMCNK;
+            uint32 size;
+            uint32 flags;
+            uint32 asyncId;
+        } cells[ADT_CELLS_PER_GRID][ADT_CELLS_PER_GRID];
 
-    bool   prepareLoadedData();
+        bool   prepareLoadedData();
-    // offset from begin file (used this-84)
+        // offset from begin file (used this-84)
-    adt_MCNK *getMCNK(int x, int y)
+        adt_MCNK* getMCNK(int x, int y)
-    {
+        {
-        if (cells[x][y].offsMCNK)
+            if (cells[x][y].offsMCNK)
-            return (adt_MCNK *)((uint8 *)this + cells[x][y].offsMCNK - 84);
+                return (adt_MCNK*)((uint8*)this + cells[x][y].offsMCNK - 84);
-        return 0;
+            return 0;
-    }
+        }
 };
 
 #define ADT_LIQUID_HEADER_FULL_LIGHT   0x01
 #define ADT_LIQUID_HEADER_NO_HIGHT     0x02
 
-struct adt_liquid_header{
+struct adt_liquid_header
+{
     uint16 liquidType;             // Index from LiquidType.dbc
     uint16 formatFlags;
     float  heightLevel1;
@@ -177,70 +202,72 @@ struct adt_liquid_header{
 //
 class adt_MH2O
 {
-public:
+    public:
-    union{
+        union
-        uint32 fcc;
+        {
-        char   fcc_txt[4];
+            uint32 fcc;
-    };
+            char   fcc_txt[4];
-    uint32 size;
+        };
+        uint32 size;
 
-    struct adt_LIQUID{
+        struct adt_LIQUID
-        uint32 offsData1;
+        {
-        uint32 used;
+            uint32 offsData1;
-        uint32 offsData2;
+            uint32 used;
-    } liquid[ADT_CELLS_PER_GRID][ADT_CELLS_PER_GRID];
+            uint32 offsData2;
+        } liquid[ADT_CELLS_PER_GRID][ADT_CELLS_PER_GRID];
 
-    bool   prepareLoadedData();
+        bool   prepareLoadedData();
 
-    adt_liquid_header *getLiquidData(int x, int y)
+        adt_liquid_header* getLiquidData(int x, int y)
-    {
+        {
-        if (liquid[x][y].used && liquid[x][y].offsData1)
+            if (liquid[x][y].used && liquid[x][y].offsData1)
-            return (adt_liquid_header *)((uint8*)this + 8 + liquid[x][y].offsData1);
+                return (adt_liquid_header*)((uint8*)this + 8 + liquid[x][y].offsData1);
-        return 0;
-    }
-
-    float *getLiquidHeightMap(adt_liquid_header *h)
-    {
-        if (h->formatFlags & ADT_LIQUID_HEADER_NO_HIGHT)
             return 0;
-        if (h->offsData2b)
+        }
-            return (float *)((uint8*)this + 8 + h->offsData2b);
-        return 0;
-    }
 
-    uint8 *getLiquidLightMap(adt_liquid_header *h)
+        float* getLiquidHeightMap(adt_liquid_header* h)
-    {
-        if (h->formatFlags&ADT_LIQUID_HEADER_FULL_LIGHT)
-            return 0;
-        if (h->offsData2b)
         {
             if (h->formatFlags & ADT_LIQUID_HEADER_NO_HIGHT)
-                return (uint8 *)((uint8*)this + 8 + h->offsData2b);
+                return 0;
-            return (uint8 *)((uint8*)this + 8 + h->offsData2b + (h->width+1)*(h->height+1)*4);
+            if (h->offsData2b)
-        }
+                return (float*)((uint8*)this + 8 + h->offsData2b);
-        return 0;
-    }
-
-    uint32 *getLiquidFullLightMap(adt_liquid_header *h)
-    {
-        if (!(h->formatFlags&ADT_LIQUID_HEADER_FULL_LIGHT))
             return 0;
-        if (h->offsData2b)
-        {
-            if (h->formatFlags & ADT_LIQUID_HEADER_NO_HIGHT)
-                return (uint32 *)((uint8*)this + 8 + h->offsData2b);
-            return (uint32 *)((uint8*)this + 8 + h->offsData2b + (h->width+1)*(h->height+1)*4);
         }
-        return 0;
-    }
 
-    uint64 getLiquidShowMap(adt_liquid_header *h)
+        uint8* getLiquidLightMap(adt_liquid_header* h)
-    {
+        {
-        if (h->offsData2a)
+            if (h->formatFlags & ADT_LIQUID_HEADER_FULL_LIGHT)
-            return *((uint64 *)((uint8*)this + 8 + h->offsData2a));
+                return 0;
-        else
+            if (h->offsData2b)
-            return 0xFFFFFFFFFFFFFFFFLL;
+            {
-    }
+                if (h->formatFlags & ADT_LIQUID_HEADER_NO_HIGHT)
+                    return (uint8*)((uint8*)this + 8 + h->offsData2b);
+                return (uint8*)((uint8*)this + 8 + h->offsData2b + (h->width + 1) * (h->height + 1) * 4);
+            }
+            return 0;
+        }
+
+        uint32* getLiquidFullLightMap(adt_liquid_header* h)
+        {
+            if (!(h->formatFlags & ADT_LIQUID_HEADER_FULL_LIGHT))
+                return 0;
+            if (h->offsData2b)
+            {
+                if (h->formatFlags & ADT_LIQUID_HEADER_NO_HIGHT)
+                    return (uint32*)((uint8*)this + 8 + h->offsData2b);
+                return (uint32*)((uint8*)this + 8 + h->offsData2b + (h->width + 1) * (h->height + 1) * 4);
+            }
+            return 0;
+        }
+
+        uint64 getLiquidShowMap(adt_liquid_header* h)
+        {
+            if (h->offsData2a)
+                return *((uint64*)((uint8*)this + 8 + h->offsData2a));
+            else
+                return 0xFFFFFFFFFFFFFFFFLL;
+        }
 
 };
 
@@ -249,46 +276,46 @@ public:
 //
 class adt_MHDR
 {
-    union{
+        union
-        uint32 fcc;
+        {
-        char   fcc_txt[4];
+            uint32 fcc;
-    };
+            char   fcc_txt[4];
-
+        };
-public:
+    public:
-    uint32 size;
+        uint32 size;
-
-    uint32 flags;
-    uint32 offsMCIN;           // MCIN
-    uint32 offsTex;	           // MTEX
-    uint32 offsModels;	       // MMDX
-    uint32 offsModelsIds;	   // MMID
-    uint32 offsMapObejcts;	   // MWMO
-    uint32 offsMapObejctsIds;  // MWID
-    uint32 offsDoodsDef;       // MDDF
-    uint32 offsObjectsDef;     // MODF
-    uint32 offsMFBO;           // MFBO
-    uint32 offsMH2O;           // MH2O
-    uint32 data1;
-    uint32 data2;
-    uint32 data3;
-    uint32 data4;
-    uint32 data5;
-public:
-    bool prepareLoadedData();
-    adt_MCIN* getMCIN() { return offsMCIN ? (adt_MCIN *)((uint8 *)&flags+offsMCIN) : 0; }
-    adt_MH2O* getMH2O() { return offsMH2O ? (adt_MH2O *)((uint8 *)&flags+offsMH2O) : 0; }
 
+        uint32 flags;
+        uint32 offsMCIN;           // MCIN
+        uint32 offsTex;            // MTEX
+        uint32 offsModels;         // MMDX
+        uint32 offsModelsIds;      // MMID
+        uint32 offsMapObejcts;     // MWMO
+        uint32 offsMapObejctsIds;  // MWID
+        uint32 offsDoodsDef;       // MDDF
+        uint32 offsObjectsDef;     // MODF
+        uint32 offsMFBO;           // MFBO
+        uint32 offsMH2O;           // MH2O
+        uint32 data1;
+        uint32 data2;
+        uint32 data3;
+        uint32 data4;
+        uint32 data5;
+    public:
+        bool prepareLoadedData();
+        adt_MCIN* getMCIN() { return offsMCIN ? (adt_MCIN*)((uint8*)&flags + offsMCIN) : 0; }
+        adt_MH2O* getMH2O() { return offsMH2O ? (adt_MH2O*)((uint8*)&flags + offsMH2O) : 0; }
 };
 
-class ADT_file : public FileLoader{
+class ADT_file : public FileLoader
-public:
+{
-    bool prepareLoadedData();
+    public:
-    ADT_file();
+        bool prepareLoadedData();
-    ~ADT_file();
+        ADT_file();
-    void free();
+        ~ADT_file();
+        void free();
 
-    adt_MHDR* a_grid;
+        adt_MHDR* a_grid;
-    adt_MCNK* cells[ADT_CELLS_PER_GRID][ADT_CELLS_PER_GRID];
+        adt_MCNK* cells[ADT_CELLS_PER_GRID][ADT_CELLS_PER_GRID];
 };
 
 bool isHole(int holes, int i, int j);

contrib/extractor/loadlib/loadlib.cpp

@@ -27,7 +27,7 @@ bool OpenArchive(char const* mpqFileName, HANDLE* mpqHandlePtr /*= NULL*/)
 
 bool OpenNewestFile(char const* filename, HANDLE* fileHandlerPtr)
 {
-    for(ArchiveSet::const_reverse_iterator i=gOpenArchives.rbegin(); i!=gOpenArchives.rend();++i)
+    for (ArchiveSet::const_reverse_iterator i = gOpenArchives.rbegin(); i != gOpenArchives.rend(); ++i)
     {
         // always prefer get updated file version
         if (SFileOpenFileEx(*i, filename, SFILE_OPEN_PATCHED_FILE, fileHandlerPtr))
@@ -37,9 +37,9 @@ bool OpenNewestFile(char const* filename, HANDLE* fileHandlerPtr)
     return false;
 }
 
-bool ExtractFile( char const* mpq_name, std::string const& filename )
+bool ExtractFile(char const* mpq_name, std::string const& filename)
 {
-    for(ArchiveSet::const_reverse_iterator i=gOpenArchives.rbegin(); i!=gOpenArchives.rend();++i)
+    for (ArchiveSet::const_reverse_iterator i = gOpenArchives.rbegin(); i != gOpenArchives.rend(); ++i)
     {
         HANDLE fileHandle;
         if (!SFileOpenFileEx(*i, mpq_name, SFILE_OPEN_PATCHED_FILE, &fileHandle))
@@ -69,7 +69,7 @@ bool ExtractFile( char const* mpq_name, std::string const& filename )
 
 void CloseArchives()
 {
-    for(ArchiveSet::const_iterator i = gOpenArchives.begin(); i != gOpenArchives.end();++i)
+    for (ArchiveSet::const_iterator i = gOpenArchives.begin(); i != gOpenArchives.end(); ++i)
         SFileCloseArchive(*i);
     gOpenArchives.clear();
 }
@@ -86,7 +86,7 @@ FileLoader::~FileLoader()
     free();
 }
 
-bool FileLoader::loadFile(char *filename, bool log)
+bool FileLoader::loadFile(char* filename, bool log)
 {
     free();
 
@@ -132,11 +132,9 @@ bool FileLoader::loadFile(char *filename, bool log)
 bool FileLoader::prepareLoadedData()
 {
     // Check version
-    version = (file_MVER *) data;
+    version = (file_MVER*) data;
-
     if (version->fcc != 'MVER')
         return false;
-
     if (version->ver != FILE_FORMAT_VERSION)
         return false;
     return true;

contrib/extractor/loadlib/loadlib.h

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #ifndef LOAD_LIB_H
 #define LOAD_LIB_H
 

contrib/extractor/loadlib/wdt.cpp

@@ -59,4 +59,4 @@ bool WDT_file::prepareLoadedData()
     if (!wmo->prepareLoadedData())
         return false;
     return true;
-}
+}

contrib/extractor/loadlib/wdt.h

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #ifndef WDT_H
 #define WDT_H
 #include "loadlib.h"
@@ -65,4 +83,4 @@ public:
     wdt_MWMO *wmo;
 };
 
-#endif
+#endif

contrib/extractor_binary/README.txt

@@ -31,6 +31,6 @@ MaNGOSExtractor_detailed.log which includes all the information about the extrac
 
 If you want to toggle some parts in the extraction process, there are a few internal variables in the extraction scripts, that can be modified.
 
-Consider the Readme's in the directories extractor, vmap_assembler, vmap_extractor_v3 and mmap for further information about detail.
+Consider the Readme's in the directories extractor, vmap_assembler, vmap_extractor and mmap for further information about detail.
 
 Also especially related to mmaps updating you might be interested in using the MoveMapGen.sh script.

contrib/git_id/CMakeLists.txt

@@ -1,4 +1,18 @@
-SET(CMAKE_VERBOSE_MAKEFILE ON)
+# This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
-cmake_minimum_required (VERSION 2.6)
+#
-ADD_EXECUTABLE (git_id git_id.cpp)
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
+cmake_minimum_required (VERSION 2.8)
+ADD_EXECUTABLE (git_id git_id.cpp)

contrib/git_id/VC100/git_id_vc100.vcxproj

@@ -93,9 +93,9 @@
     </Link>
   </ItemDefinitionGroup>
   <ItemGroup>
-    <ClCompile Include="git_id.cpp" />
+    <ClCompile Include="..\git_id.cpp" />
   </ItemGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
   <ImportGroup Label="ExtensionTargets">
   </ImportGroup>
-</Project>
+</Project>

contrib/git_id/VC100/git_id_vc100.vcxproj.filters

@@ -15,7 +15,7 @@
     </Filter>
   </ItemGroup>
   <ItemGroup>
-    <ClCompile Include="git_id.cpp">
+    <ClCompile Include="..\git_id.cpp">
       <Filter>Source Files</Filter>
     </ClCompile>
   </ItemGroup>

contrib/git_id/VC110/git_id_vc110.vcxproj

@@ -0,0 +1,103 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup Label="ProjectConfigurations">
+    <ProjectConfiguration Include="Debug|Win32">
+      <Configuration>Debug</Configuration>
+      <Platform>Win32</Platform>
+    </ProjectConfiguration>
+    <ProjectConfiguration Include="Release|Win32">
+      <Configuration>Release</Configuration>
+      <Platform>Win32</Platform>
+    </ProjectConfiguration>
+  </ItemGroup>
+  <PropertyGroup Label="Globals">
+    <ProjectName>git_id</ProjectName>
+    <ProjectGuid>{AD81BF86-050B-4605-8AF2-03C01967D784}</ProjectGuid>
+    <RootNamespace>git_id</RootNamespace>
+    <Keyword>Win32Proj</Keyword>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="Configuration">
+    <ConfigurationType>Application</ConfigurationType>
+    <CharacterSet>Unicode</CharacterSet>
+    <WholeProgramOptimization>true</WholeProgramOptimization>
+    <PlatformToolset>v110</PlatformToolset>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="Configuration">
+    <ConfigurationType>Application</ConfigurationType>
+    <CharacterSet>Unicode</CharacterSet>
+    <PlatformToolset>v110</PlatformToolset>
+  </PropertyGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
+  <ImportGroup Label="ExtensionSettings">
+  </ImportGroup>
+  <ImportGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" Label="PropertySheets">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <ImportGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" Label="PropertySheets">
+    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
+  </ImportGroup>
+  <PropertyGroup Label="UserMacros" />
+  <PropertyGroup>
+    <_ProjectFileVersion>10.0.30319.1</_ProjectFileVersion>
+    <OutDir Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(SolutionDir)$(Configuration)\</OutDir>
+    <IntDir Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">$(Configuration)\</IntDir>
+    <LinkIncremental Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">true</LinkIncremental>
+    <OutDir Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(SolutionDir)$(Configuration)\</OutDir>
+    <IntDir Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">$(Configuration)\</IntDir>
+    <LinkIncremental Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">false</LinkIncremental>
+    <CodeAnalysisRuleSet Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">AllRules.ruleset</CodeAnalysisRuleSet>
+    <CodeAnalysisRules Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" />
+    <CodeAnalysisRuleAssemblies Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'" />
+    <CodeAnalysisRuleSet Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">AllRules.ruleset</CodeAnalysisRuleSet>
+    <CodeAnalysisRules Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" />
+    <CodeAnalysisRuleAssemblies Condition="'$(Configuration)|$(Platform)'=='Release|Win32'" />
+  </PropertyGroup>
+  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
+    <ClCompile>
+      <Optimization>Disabled</Optimization>
+      <PreprocessorDefinitions>WIN32;_DEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+      <MinimalRebuild>true</MinimalRebuild>
+      <BasicRuntimeChecks>EnableFastChecks</BasicRuntimeChecks>
+      <RuntimeLibrary>MultiThreadedDebugDLL</RuntimeLibrary>
+      <PrecompiledHeader>
+      </PrecompiledHeader>
+      <WarningLevel>Level3</WarningLevel>
+      <DebugInformationFormat>EditAndContinue</DebugInformationFormat>
+    </ClCompile>
+    <Link>
+      <GenerateDebugInformation>true</GenerateDebugInformation>
+      <SubSystem>Console</SubSystem>
+      <RandomizedBaseAddress>false</RandomizedBaseAddress>
+      <DataExecutionPrevention>
+      </DataExecutionPrevention>
+      <TargetMachine>MachineX86</TargetMachine>
+    </Link>
+  </ItemDefinitionGroup>
+  <ItemDefinitionGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
+    <ClCompile>
+      <PreprocessorDefinitions>WIN32;NDEBUG;_CONSOLE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+      <RuntimeLibrary>MultiThreadedDLL</RuntimeLibrary>
+      <PrecompiledHeader>
+      </PrecompiledHeader>
+      <WarningLevel>Level3</WarningLevel>
+      <DebugInformationFormat>ProgramDatabase</DebugInformationFormat>
+    </ClCompile>
+    <Link>
+      <GenerateDebugInformation>true</GenerateDebugInformation>
+      <SubSystem>Console</SubSystem>
+      <OptimizeReferences>true</OptimizeReferences>
+      <EnableCOMDATFolding>true</EnableCOMDATFolding>
+      <RandomizedBaseAddress>false</RandomizedBaseAddress>
+      <DataExecutionPrevention>
+      </DataExecutionPrevention>
+      <TargetMachine>MachineX86</TargetMachine>
+    </Link>
+  </ItemDefinitionGroup>
+  <ItemGroup>
+    <ClCompile Include="..\git_id.cpp" />
+  </ItemGroup>
+  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
+  <ImportGroup Label="ExtensionTargets">
+  </ImportGroup>
+</Project>

contrib/git_id/VC110/git_id_vc110.vcxproj.filters

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <ItemGroup>
+    <Filter Include="Source Files">
+      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
+      <Extensions>cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
+    </Filter>
+    <Filter Include="Header Files">
+      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
+      <Extensions>h;hpp;hxx;hm;inl;inc;xsd</Extensions>
+    </Filter>
+    <Filter Include="Resource Files">
+      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
+      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav</Extensions>
+    </Filter>
+  </ItemGroup>
+  <ItemGroup>
+    <ClCompile Include="..\git_id.cpp">
+      <Filter>Source Files</Filter>
+    </ClCompile>
+  </ItemGroup>
+</Project>

contrib/git_id/git_id.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -14,7 +14,7 @@
  * You should have received a copy of the GNU General Public License
  * along with this program; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-*/
+ */
 
 #include <stdio.h>
 #include <stdlib.h>
@@ -439,9 +439,9 @@ bool get_sql_update_info(const char* buffer, sql_update_info& info)
             sscanf(buffer, REV_SCAN "_%[^_]_%d_%[^.].sql", &info.rev, &info.nr, info.db) != 3)
     {
         info.rev = 0;       // this may be set by the first scans, even if they fail
-        if (sscanf(buffer, "%d_%[^_]_%[^.].sql", &info.nr, info.db, info.table) != 3 &&
+        if(sscanf(buffer, "%d_%[^_]_%[^.].sql", &info.nr, info.db, info.table) != 3 &&
-                sscanf(buffer, "%d_%[^.].sql", &info.nr, info.db) != 2)
+            sscanf(buffer, "%d_%[^.].sql", &info.nr, info.db) != 2)
-            return false;
+        return false;
     }
 
     for (info.db_idx = 0; info.db_idx < NUM_DATABASES; info.db_idx++)
@@ -512,7 +512,7 @@ bool find_sql_updates()
             {
                 last_sql_rev[info.db_idx] = info.rev;
                 last_sql_nr[info.db_idx] = info.nr;
-                sscanf(buffer, "%[^.]", last_sql_update[info.db_idx]);
+                    sscanf(buffer, "%[^.]", last_sql_update[info.db_idx]);
             }
             new_sql_updates.erase(itr);
         }
@@ -569,23 +569,23 @@ bool convert_sql_updates()
 
         std::ostringstream out_buff;
 
-        // add the update requirements
+            // add the update requirements
-        out_buff << "ALTER TABLE " << db_version_table[info.db_idx]
+            out_buff << "ALTER TABLE " << db_version_table[info.db_idx]
-                 << " CHANGE COLUMN required_" << last_sql_update[info.db_idx]
+                     << " CHANGE COLUMN required_" << last_sql_update[info.db_idx]
-                 << " required_" << new_name << " bit;\n\n";
+                     << " required_" << new_name << " bit;\n\n";
 
-        // skip the first one or two lines from the input
+            // skip the first one or two lines from the input
-        // if it already contains update requirements
+            // if it already contains update requirements
-        if (fgets(buffer, MAX_BUF, fin))
+            if (fgets(buffer, MAX_BUF, fin))
-        {
-            char dummy[MAX_BUF];
-            if (sscanf(buffer, "ALTER TABLE %s CHANGE COLUMN required_%s required_%s bit", dummy, dummy, dummy) == 3)
             {
-                if (fgets(buffer, MAX_BUF, fin) && buffer[0] != '\n')
+                char dummy[MAX_BUF];
+                if (sscanf(buffer, "ALTER TABLE %s CHANGE COLUMN required_%s required_%s bit", dummy, dummy, dummy) == 3)
+                {
+                    if (fgets(buffer, MAX_BUF, fin) && buffer[0] != '\n')
+                        out_buff << buffer;
+                }
+                else
                     out_buff << buffer;
-            }
-            else
-                out_buff << buffer;
         }
 
         // copy the rest of the file

contrib/git_id/git_id_vc100.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 11.00
 # Visual Studio 2010
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "git_id", "git_id_vc100.vcxproj", "{AD81BF86-050B-4605-8AF2-03C01967D784}"
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "git_id", "VC100\git_id_vc100.vcxproj", "{AD81BF86-050B-4605-8AF2-03C01967D784}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

contrib/git_id/git_id_vc110.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 2012
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "git_id", "git_id_vc110.vcxproj", "{AD81BF86-050B-4605-8AF2-03C01967D784}"
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "git_id", "VC110\git_id_vc110.vcxproj", "{AD81BF86-050B-4605-8AF2-03C01967D784}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

contrib/mmap/src/IntermediateValues.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/IntermediateValues.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/MMapCommon.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/MangosMap.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/MapBuilder.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/MapBuilder.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/TerrainBuilder.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/TerrainBuilder.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mmap/src/VMapExtensions.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -70,4 +70,4 @@ namespace VMAP
         tilesY = iTilesY;
         corner = iCorner;
     }
-}
+}

contrib/mmap/src/generator.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/mysql_to_pgsql/CMakeLists.txt

@@ -1,5 +1,20 @@
-SET(CMAKE_VERBOSE_MAKEFILE ON)
+# This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
-cmake_minimum_required (VERSION 2.6)
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+
+cmake_minimum_required (VERSION 2.8)
 
 INCLUDE(cmake/FindMySQL.cmake)
 INCLUDE(cmake/FindPostgreSQL.cmake)

contrib/mysql_to_pgsql/README

@@ -11,4 +11,3 @@ Using cmake on a Unix/Linux
     2. cmake -i
     3. make
     4. ./mysql2pgsql
-

contrib/mysql_to_pgsql/src/defines.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -181,4 +181,3 @@ void PG_Escape_Str(string& str)
 }
 
 #endif
-

contrib/mysql_to_pgsql/src/main.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/soap/example.php

@@ -17,7 +17,7 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
-/*
+/**
  * MaNGOSsoap client example
  *
  * a simple example how to invoke commands using SOAP

contrib/vmap_assembler/CMakeLists.txt

@@ -12,8 +12,6 @@ cmake_minimum_required (VERSION 2.8)
 
 project (MANGOS_VMAP_ASSEMB_IO)
 
-set(CMAKE_VERBOSE_MAKEFILE true)
-
 # uncomment next line to disable debug mode
 ADD_DEFINITIONS("-DIOMAP_DEBUG")
 ADD_DEFINITIONS("-DNO_CORE_FUNCS")

contrib/vmap_assembler/vmap_assembler.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/adtfile.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/adtfile.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/dbcfile.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -116,4 +116,3 @@ DBCFile::Iterator DBCFile::end()
     assert(_data);
     return Iterator(*this, _stringTable);
 }
-

contrib/vmap_extractor/vmapextract/dbcfile.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/gameobject_extract.cpp

@@ -21,7 +21,7 @@ bool ExtractSingleModel(std::string& fname, StringSet& failedPaths)
     // >= 3.1.0 ADT MMDX section store filename.m2 filenames for corresponded .m2 file
     // nothing do
 
-    std::string output(szWorkDirWmo);
+    std::string output(szWorkDirWmo);                       // Stores output filename (possible changed)
     output += "/";
     output += name;
 

contrib/vmap_extractor/vmapextract/loadlib/loadlib.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/model.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/model.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -71,6 +71,7 @@ class ModelInstance
 
         ModelInstance() {}
         ModelInstance(MPQFile& f, const char* ModelInstName, uint32 mapID, uint32 tileX, uint32 tileY, FILE* pDirfile);
+
 };
 
 #endif

contrib/vmap_extractor/vmapextract/modelheaders.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/vec3d.h

@@ -1,3 +1,21 @@
+/**
+ * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
 #ifndef VEC3D_H
 #define VEC3D_H
 

contrib/vmap_extractor/vmapextract/vmapexport.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -528,7 +528,6 @@ bool processArgv(int argc, char** argv)
             break;
         }
     }
-
     if (!result)
     {
         printf("Extract for %s.\n", szRawVMAPMagic);
@@ -607,7 +606,6 @@ int main(int argc, char** argv)
         printf("Detected and using locale locale: %s\n", Locales[i]);
         break;
     }
-
     ReadLiquidTypeTableDBC();
 
     // extract data

contrib/vmap_extractor/vmapextract/vmapexport.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/wdtfile.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/wdtfile.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/vmapextract/wmo.cpp

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify
@@ -184,6 +184,7 @@ bool WMOGroup::open()
             f.read(&fogIdx, 4);
             f.read(&liquidType, 4);
             f.read(&groupWMOID, 4);
+
         }
         else if (!strcmp(fourcc, "MOPY"))
         {

contrib/vmap_extractor/vmapextract/wmo.h

@@ -1,4 +1,4 @@
-/*
+/**
  * This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
  *
  * This program is free software; you can redistribute it and/or modify

contrib/vmap_extractor/win/vmapExtractor_VC90.sln

@@ -1,42 +0,0 @@
-Microsoft Visual Studio Solution File, Format Version 10.00
-# Visual Studio 2008
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "vmapExtractor", "VC90\vmapExtractor.vcproj", "{D4624B20-AC1E-4EE9-8C9C-0FB65EEE3393}"
-	ProjectSection(ProjectDependencies) = postProject
-		{B96F612A-C91D-43B3-A4C3-D4294817EC6C} = {B96F612A-C91D-43B3-A4C3-D4294817EC6C}
-		{8F1DEA42-6A5B-4B62-839D-C141A7BFACF2} = {8F1DEA42-6A5B-4B62-839D-C141A7BFACF2}
-		{03AB0F44-628E-4855-99A0-C98A1EB52C50} = {03AB0F44-628E-4855-99A0-C98A1EB52C50}
-	EndProjectSection
-EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "libmpq", "..\..\..\dep\libmpq\win\VC90\libmpq.vcproj", "{03AB0F44-628E-4855-99A0-C98A1EB52C50}"
-EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "zlib", "..\..\..\win\VC90\zlib.vcproj", "{8F1DEA42-6A5B-4B62-839D-C141A7BFACF2}"
-EndProject
-Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "bzip2", "..\..\..\win\VC90\bzip2.vcproj", "{B96F612A-C91D-43B3-A4C3-D4294817EC6C}"
-EndProject
-Global
-	GlobalSection(SolutionConfigurationPlatforms) = preSolution
-		Debug|Win32 = Debug|Win32
-		Release|Win32 = Release|Win32
-	EndGlobalSection
-	GlobalSection(ProjectConfigurationPlatforms) = postSolution
-		{D4624B20-AC1E-4EE9-8C9C-0FB65EEE3393}.Debug|Win32.ActiveCfg = Debug|Win32
-		{D4624B20-AC1E-4EE9-8C9C-0FB65EEE3393}.Debug|Win32.Build.0 = Debug|Win32
-		{D4624B20-AC1E-4EE9-8C9C-0FB65EEE3393}.Release|Win32.ActiveCfg = Release|Win32
-		{D4624B20-AC1E-4EE9-8C9C-0FB65EEE3393}.Release|Win32.Build.0 = Release|Win32
-		{03AB0F44-628E-4855-99A0-C98A1EB52C50}.Debug|Win32.ActiveCfg = Debug|Win32
-		{03AB0F44-628E-4855-99A0-C98A1EB52C50}.Debug|Win32.Build.0 = Debug|Win32
-		{03AB0F44-628E-4855-99A0-C98A1EB52C50}.Release|Win32.ActiveCfg = Release|Win32
-		{03AB0F44-628E-4855-99A0-C98A1EB52C50}.Release|Win32.Build.0 = Release|Win32
-		{8F1DEA42-6A5B-4B62-839D-C141A7BFACF2}.Debug|Win32.ActiveCfg = Debug|Win32
-		{8F1DEA42-6A5B-4B62-839D-C141A7BFACF2}.Debug|Win32.Build.0 = Debug|Win32
-		{8F1DEA42-6A5B-4B62-839D-C141A7BFACF2}.Release|Win32.ActiveCfg = Release|Win32
-		{8F1DEA42-6A5B-4B62-839D-C141A7BFACF2}.Release|Win32.Build.0 = Release|Win32
-		{B96F612A-C91D-43B3-A4C3-D4294817EC6C}.Debug|Win32.ActiveCfg = Debug|Win32
-		{B96F612A-C91D-43B3-A4C3-D4294817EC6C}.Debug|Win32.Build.0 = Debug|Win32
-		{B96F612A-C91D-43B3-A4C3-D4294817EC6C}.Release|Win32.ActiveCfg = Release|Win32
-		{B96F612A-C91D-43B3-A4C3-D4294817EC6C}.Release|Win32.Build.0 = Release|Win32
-	EndGlobalSection
-	GlobalSection(SolutionProperties) = preSolution
-		HideSolutionNode = FALSE
-	EndGlobalSection
-EndGlobal

dep/ACE_wrappers/CMakeLists.txt

@@ -1,4 +1,3 @@
-#
 # This code is part of MaNGOS. Contributor & Copyright details are in AUTHORS/THANKS.
 #
 # This program is free software; you can redistribute it and/or modify
@@ -14,7 +13,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-#
 
 include(ExternalProject)
 

dep/ACE_wrappers/ace/ACE.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  * @file    ACE.h
  *
  * $Id: ACE.h 92060 2010-09-27 18:08:48Z johnnyw $
@@ -49,7 +49,7 @@ class ACE_Time_Value;
 class ACE_Message_Block;
 class ACE_Handle_Set;
 
-/*
+/**
  * @namespace ACE
  *
  * @brief The namespace containing the ACE framework itself.
@@ -98,7 +98,7 @@ namespace ACE
   extern ACE_Export bool wild_match(const char* s, const char* pattern,
     bool case_sensitive = true, bool character_classes = false);
 
-  /*
+  /**
    * @name I/O operations
    *
    * Notes on common parameters:
@@ -209,7 +209,7 @@ namespace ACE
                   size_t *bytes_transferred = 0);
 
   /// Receive into a variable number of pieces.
-  /*
+  /**
    * Accepts a variable, caller-specified, number of pointer/length
    * pairs. Arguments following @a n are char *, size_t pairs.
    *
@@ -353,7 +353,7 @@ namespace ACE
                                       size_t *bytes_transferred = 0);
   //@}
 
-  /*
+  /**
    * Wait up to @a timeout amount of time to passively establish a
    * connection.  This method doesn't perform the @c accept, it just
    * does the timed wait.
@@ -362,7 +362,7 @@ namespace ACE
                                              ACE_Time_Value *timeout,
                                              bool restart);
 
-  /*
+  /**
    * Wait up to @a timeout amount of time to complete an actively
    * established non-blocking connection.  If @a is_tli is non-0 then
    * we are being called by a TLI wrapper (which behaves slightly
@@ -373,7 +373,7 @@ namespace ACE
     const ACE_Time_Value *timeout,
     int is_tli = 0);
 
-  /*
+  /**
    * Reset the limit on the number of open handles.  If @a new_limit
    * == -1 set the limit to the maximum allowable.  Otherwise, set
    * the limit value to @a new_limit.  If @a increase_limit_only is
@@ -382,7 +382,7 @@ namespace ACE
   extern ACE_Export int set_handle_limit (int new_limit = -1,
                                           int increase_limit_only = 0);
 
-  /*
+  /**
    * Returns the maximum number of open handles currently permitted in
    * this process.  This maximum may be extended using
    * @c ACE::set_handle_limit.
@@ -390,7 +390,7 @@ namespace ACE
   extern ACE_Export int max_handles (void);
 
   // = String functions
-  /*
+  /**
    * Return a dynamically allocated duplicate of @a str, substituting
    * the environment variable if @c str[0] @c == @c '$'.  Note that
    * the pointer is allocated with @c ACE_OS::malloc and must be freed
@@ -436,7 +436,7 @@ namespace ACE
 
 #endif /* ACE_HAS_WCHAR */
 
-  /*
+  /**
    * On Windows, determines if a specified pathname ends with ".exe"
    * (not case sensitive). If on Windows and there is no ".exe" suffix,
    * a new ACE_TCHAR array is allocated and a copy of @c pathname with
@@ -454,7 +454,7 @@ namespace ACE
    */
   extern ACE_Export const ACE_TCHAR *execname (const ACE_TCHAR *pathname);
 
-  /*
+  /**
    * Returns the "basename" of a @a pathname separated by @a delim.
    * For instance, the basename of "/tmp/foo.cpp" is "foo.cpp" when
    * @a delim is @a '/'.
@@ -463,7 +463,7 @@ namespace ACE
                                                ACE_TCHAR delim =
                                                ACE_DIRECTORY_SEPARATOR_CHAR);
 
-  /*
+  /**
    * Returns the "dirname" of a @a pathname.  For instance, the
    * dirname of "/tmp/foo.cpp" is "/tmp" when @a delim is @a '/'.  If
    * @a pathname has no @a delim ".\0" is returned.  This method does
@@ -473,7 +473,7 @@ namespace ACE
                                               ACE_TCHAR delim =
                                               ACE_DIRECTORY_SEPARATOR_CHAR);
 
-  /*
+  /**
    * Returns the given timestamp in the form
    * "hour:minute:second:microsecond."  The month, day, and year are
    * also stored in the beginning of the @a date_and_time array, which
@@ -489,7 +489,7 @@ namespace ACE
                                           size_t time_len,
                                           bool return_pointer_to_first_digit = false);
 
-  /*
+  /**
    * Returns the current timestamp in the form
    * "hour:minute:second:microsecond."  The month, day, and year are
    * also stored in the beginning of the @a date_and_time array, which
@@ -504,7 +504,7 @@ namespace ACE
                                           size_t time_len,
                                           bool return_pointer_to_first_digit = false);
 
-  /*
+  /**
    * if @a avoid_zombies == 0 call @c ACE_OS::fork directly, else
    * create an orphan process that's inherited by the init process;
    * init cleans up when the orphan process terminates so we don't
@@ -517,7 +517,7 @@ namespace ACE
     const ACE_TCHAR *program_name = ACE_TEXT ("<unknown>"),
     int avoid_zombies = 0);
 
-  /*
+  /**
    * Become a daemon process using the algorithm in Richard Stevens
    * "Advanced Programming in the UNIX Environment."  If
    * @a close_all_handles is non-zero then all open file handles are
@@ -584,7 +584,7 @@ namespace ACE
   /// Calculates the minimum enclosing frame size for the given values.
   extern ACE_Export u_long minimum_frame_size (u_long period1, u_long period2);
 
-  /*
+  /**
    * Function that can burn up noticeable CPU time:  brute-force
    * determination of whether number @a n is prime.  Returns 0 if
    * it is prime, or the smallest factor if it is not prime.
@@ -610,14 +610,14 @@ namespace ACE
   /// @internal
   extern ACE_Export bool is_sock_error (int error);
 
-  /*
+  /**
    * Checks if process with {pid} is still alive.  Returns 1 if it is
    * still alive, 0 if it isn't alive, and -1 if something weird
    * happened.
    */
   extern ACE_Export int process_active (pid_t pid);
 
-  /*
+  /**
    * Terminate the process abruptly with id @a pid.  On Win32 platforms
    * this uses {TerminateProcess} and on POSIX platforms is uses
    * {kill} with the -9 (SIGKILL) signal, which cannot be caught or
@@ -627,7 +627,7 @@ namespace ACE
    */
   extern ACE_Export int terminate_process (pid_t pid);
 
-  /*
+  /**
    * This method uses process id and object pointer to come up with a
    * machine wide unique name.  The process ID will provide uniqueness
    * between processes on the same machine. The "this" pointer of the

dep/ACE_wrappers/ace/ARGV.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //==========================================================================
-/*
+/**
  *  @file    ARGV.h
  *
  *  $Id: ARGV.h 81156 2008-03-30 20:56:47Z iliyan $
@@ -27,7 +27,7 @@
 // Open versioned namespace, if enabled by the user.
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_ARGV_Queue_Entry_T
  *
  * @brief An entry in the queue which keeps user supplied arguments.
@@ -40,7 +40,7 @@ public:
   /// Initialize a ACE_ARGV_Queue_Entry_T.
   ACE_ARGV_Queue_Entry_T (void);
 
-  /*
+  /**
    * Initialize a ACE_ARGV_Queue_Entry_T.
    *
    * @param arg   Pointer to an argument
@@ -51,7 +51,7 @@ public:
   ACE_ARGV_Queue_Entry_T (const CHAR_TYPE *arg,
                           bool quote_arg);
 
-  /*
+  /**
    * Initialize a ACE_ARGV_Queue_Entry_T.
    *
    * @param entry Pointer to a queue entry
@@ -75,7 +75,7 @@ public:
   bool quote_arg_;
 };
 
-/*
+/**
  * @class ACE_ARGV_T
  *
  * @brief Builds a counted argument vector (ala argc/argv) from either
@@ -97,7 +97,7 @@ class ACE_ARGV_T
 {
 public:
   // = Initialization and termination.
-  /*
+  /**
    * Splits the specified string into an argument vector. Arguments in the
    * string are delimited by whitespace. Whitespace-containing arguments
    * must be enclosed in quotes, either single (') or double (").
@@ -113,7 +113,7 @@ public:
   explicit ACE_ARGV_T (const CHAR_TYPE buf[],
                        bool substitute_env_args = true);
 
-  /*
+  /**
    * Initializes the argument vector from a set of arguments. Any environment
    * variable references are translated (if applicable) during execution of
    * this method. In contrast with ACE_ARGV_T(CHAR_TYPE *[], bool, bool), this
@@ -140,7 +140,7 @@ public:
                        bool substitute_env_args = true,
                        bool quote_args = false);
 
-  /*
+  /**
    * Initializes the argument vector from a set of arguments. Any environment
    * variable references are translated (if applicable) during execution of
    * this method.
@@ -163,7 +163,7 @@ public:
                        bool substitute_env_args = true,
                        bool quote_args = false);
 
-  /*
+  /**
    * Initializes the argument vector from two combined argument vectors.
    *
    * @param first_argv   An array of tokens to initialize the object with.
@@ -186,7 +186,7 @@ public:
               bool substitute_env_args = true,
               bool quote_args = false);
 
-  /*
+  /**
    * Initialize this object so arguments can be added later using one
    * of the add methods. This is referred to as the @i iterative method
    * of adding arguments to this object.
@@ -201,7 +201,7 @@ public:
    * These methods access the argument vector contained in this object.
    */
   //@{
-  /*
+  /**
    * Returns the specified element of the current argument vector.
    *
    * @param index   Index to the desired element.
@@ -211,7 +211,7 @@ public:
    */
   const CHAR_TYPE *operator[] (size_t index);
 
-  /*
+  /**
    * Returns the current argument vector. The returned pointers are to data
    * maintained internally to this class. Do not change or delete either the
    * pointers or the memory to which they refer.
@@ -221,7 +221,7 @@ public:
   /// Returns the current number of arguments.
   int argc (void) const;
 
-  /*
+  /**
    * Returns a single string form of the current arguments. The returned
    * pointer refers to memory maintained internally to this class. Do not
    * change or delete it.
@@ -236,7 +236,7 @@ public:
   // Declare the dynamic allocation hooks.
   ACE_ALLOC_HOOK_DECLARE;
 
-  /*
+  /**
    * Add another argument. This only works in the iterative mode.
    *
    * @note This method copies the specified pointer, but not the data
@@ -255,7 +255,7 @@ public:
    */
   int add (const CHAR_TYPE *next_arg, bool quote_arg = false);
 
-  /*
+  /**
    * Add an array of arguments. This only works in the iterative mode.
    *
    * @note This method copies the specified pointers, but not the data

dep/ACE_wrappers/ace/ATM_Acceptor.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    ATM_Acceptor.h
  *
  *  $Id: ATM_Acceptor.h 82723 2008-09-16 09:35:44Z johnnyw $
@@ -49,7 +49,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 // Forward declarations.
 class ACE_Time_Value;
 
-/*
+/**
  * @class ACE_ATM_Acceptor
  *
  * @brief Defines the member functions for ACE_ATM_Acceptor abstraction.

dep/ACE_wrappers/ace/ATM_Addr.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //==========================================================================
-/*
+/**
  *  @file    ATM_Addr.h
  *
  *  $Id: ATM_Addr.h 80826 2008-03-04 14:51:23Z wotte $
@@ -51,7 +51,7 @@ typedef struct _linux_atm_addr
 typedef int ATM_Addr;
 #endif /* ACE_HAS_FORE_ATM_XTI/ACE_HAS_FORE_ATM_WS2/ACE_HAS_LINUX_ATM */
 
-/*
+/**
  * @class ACE_ATM_Addr
  *
  * @brief Defines the ATM domain address family address format.
@@ -73,7 +73,7 @@ public:
   ACE_ATM_Addr (const ACE_ATM_Addr &,
                 u_char selector = DEFAULT_SELECTOR);
 
-  /*
+  /**
    * Creates an ACE_ATM_Addr from an ATMSAPAddress structure. This
    * is vendor specific (FORE systems). May need to change when other
    * vendors are supported.
@@ -81,7 +81,7 @@ public:
   ACE_ATM_Addr (const ATM_Addr *,
                 u_char selector = DEFAULT_SELECTOR);
 
-  /*
+  /**
    * Initializes an ACE_ATM_Addr from the <sap> which can be
    * "atm-address" (e.g.,
    * "47.0005.80.ffe100.0000.f20f.2200.0020480694f9.00") or "hostname"
@@ -102,7 +102,7 @@ public:
   int set (const ACE_ATM_Addr &,
            u_char selector = DEFAULT_SELECTOR);
 
-  /*
+  /**
    * Initializes an ACE_ATM_Addr from an ATMSAPAddress/sockaddr_atm
    * structure. This is vendor specific (FORE systems). May need to
    * change when other vendors are supported.
@@ -110,7 +110,7 @@ public:
   int set (const ATM_Addr *,
            u_char selector = DEFAULT_SELECTOR);
 
-  /*
+  /**
    * Initializes an ACE_ATM_Addr from the <sap> which can be
    * "atm-address" (e.g.,
    * "47.0005.80.ffe100.0000.f20f.2200.0020480694f9.00") or "hostname"
@@ -119,7 +119,7 @@ public:
   int set (const ACE_TCHAR sap[],
            u_char selector = DEFAULT_SELECTOR);
 
-  /*
+  /**
    * Initializes an ACE_ATM_Addr from the <sap> which can be
    * "atm-address" (e.g.,
    * "47.0005.80.ffe100.0000.f20f.2200.0020480694f9.00") or "hostname"
@@ -127,7 +127,7 @@ public:
    */
   virtual int string_to_addr (const ACE_TCHAR sap[]);
 
-  /*
+  /**
    * Return the character representation of the ATM address (e.g.,
    * "47.0005.80.ffe100.0000.f20f.2200.0020480694f9.00") storing it in
    * the @a addr (which is assumed to be <addrlen> bytes long). This
@@ -137,7 +137,7 @@ public:
   virtual int addr_to_string (ACE_TCHAR addr[],
                               size_t addrlen) const;
 
-  /*
+  /**
    * Return the character representation of the ATM address (e.g.,
    * "47.0005.80.ffe100.0000.f20f.2200.0020480694f9.00"). Returns -1
    * if the <size> of the <buffer> is too small, else 0.(This version
@@ -158,7 +158,7 @@ public:
   /// Set the selector for the network address.
   void set_selector (u_char selector);
 
-  /*
+  /**
    * Compare two addresses for equality.  The addresses are considered
    * equal if they contain the same ATM address.  Q: Is there any
    * other check for equality needed for ATM?

dep/ACE_wrappers/ace/ATM_Connector.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    ATM_Connector.h
  *
  *  $Id: ATM_Connector.h 82723 2008-09-16 09:35:44Z johnnyw $
@@ -42,7 +42,7 @@ ACE_END_VERSIONED_NAMESPACE_DECL
 // Open versioned namespace, if enabled by the user.
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_ATM_Connector
  *
  * @brief Defines an active connection factory for the ACE_ATM C++
@@ -55,7 +55,7 @@ public:
   /// Default constructor.
   ACE_ATM_Connector (void);
 
-  /*
+  /**
    * Actively connect and produce a @a new_stream if things go well.
    * The @a remote_sap is the address that we are trying to connect
    * with.  The <params> are the parameters needed for either socket
@@ -85,7 +85,7 @@ public:
 #endif /* ACE_WIN32 */
                      int perms = 0);
 
-  /*
+  /**
    * Actively connect and produce a @a new_stream if things go well.
    * The @a remote_sap is the address that we are trying to connect
    * with.  The <params> are the parameters needed for either socket
@@ -116,7 +116,7 @@ public:
 #endif /* ACE_WIN32 */
                int perms = 0);
 
-  /*
+  /**
    * Try to complete a non-blocking connection.
    * If connection completion is successful then @a new_stream contains
    * the connected ACE_SOCK_Stream.  If @a remote_sap is non-NULL then it
@@ -126,7 +126,7 @@ public:
                 ACE_ATM_Addr *remote_sap,
                 ACE_Time_Value *tv);
 
-  /*
+  /**
    * Actively add a leaf to the root (i.e., point-to-multipoint). The
    * @a remote_sap is the address of the leaf that we
    * are trying to add.

dep/ACE_wrappers/ace/ATM_Params.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //==========================================================================
-/*
+/**
  *  @file    ATM_Params.h
  *
  *  $Id: ATM_Params.h 80826 2008-03-04 14:51:23Z wotte $
@@ -51,7 +51,7 @@ typedef int Param_Udata;
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_ATM_Params
  *
  * @brief Wrapper class that simplifies the information passed to the ATM
@@ -60,7 +60,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 class ACE_Export ACE_ATM_Params
 {
 public:
-  /*
+  /**
    * Initialize the data members.  This class combines options from
    * ACE_SOCK_Connector (@a protocol_family, @a protocol, <type>,
    * @a protocol_info, <group>, and @a flags) and

dep/ACE_wrappers/ace/ATM_QoS.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //==========================================================================
-/*
+/**
  *  @file    ATM_QoS.h
  *
  *  $Id: ATM_QoS.h 80826 2008-03-04 14:51:23Z wotte $
@@ -46,7 +46,7 @@ ACE_END_VERSIONED_NAMESPACE_DECL
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_ATM_QoS
  *
  * @brief Define the QoS parameters for ATM

dep/ACE_wrappers/ace/ATM_Stream.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    ATM_Stream.h
  *
  *  $Id: ATM_Stream.h 80826 2008-03-04 14:51:23Z wotte $
@@ -40,7 +40,7 @@ ACE_END_VERSIONED_NAMESPACE_DECL
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_ATM_Stream
  *
  * @brief Defines the member functions for ACE_ATM_Stream abstraction.

dep/ACE_wrappers/ace/Acceptor.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Acceptor.h
  *
  *  $Id: Acceptor.h 88800 2010-02-01 23:18:34Z shuston $
@@ -26,7 +26,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Acceptor
  *
  * @brief Abstract factory for creating a service handler
@@ -64,7 +64,7 @@ public:
   ACE_Acceptor (ACE_Reactor * = 0,
                 int use_select = 1);
 
-  /*
+  /**
    * Open the contained @c PEER_ACCEPTOR object to begin listening, and
    * register with the specified reactor for accept events.  An
    * acceptor can only listen to one port at a time, so make sure to
@@ -103,7 +103,7 @@ public:
                 int use_select = 1,
                 int reuse_addr = 1);
 
-  /*
+  /**
    * Open the contained @c PEER_ACCEPTOR object to begin listening, and
    * register with the specified reactor for accept events.  An
    * acceptor can only listen to one port at a time, so make sure to
@@ -175,7 +175,7 @@ protected:
   // for creating, accepting, and activating SVC_HANDLER's,
   // respectively.
 
-  /*
+  /**
    * Bridge method for creating a SVC_HANDLER.  The default is to
    * create a new {SVC_HANDLER} if {sh} == 0, else {sh} is unchanged.
    * However, subclasses can override this policy to perform
@@ -185,14 +185,14 @@ protected:
    */
   virtual int make_svc_handler (SVC_HANDLER *&sh);
 
-  /*
+  /**
    * Bridge method for accepting the new connection into the
    * @a svc_handler.  The default behavior delegates to the
    * PEER_ACCEPTOR::accept.
    */
   virtual int accept_svc_handler (SVC_HANDLER *svc_handler);
 
-  /*
+  /**
    * Bridge method for activating a {svc_handler} with the appropriate
    * concurrency strategy.  The default behavior of this method is to
    * activate the SVC_HANDLER by calling its {open} method (which
@@ -240,7 +240,7 @@ protected:
   /// Needed to reopen the socket if {accept} fails.
   ACE_PEER_ACCEPTOR_ADDR peer_acceptor_addr_;
 
-  /*
+  /**
    * Flags that indicate how {SVC_HANDLER}'s should be initialized
    * prior to being activated.  Right now, the only flag that is
    * processed is {ACE_NONBLOCK}, which enabled non-blocking I/O on
@@ -256,7 +256,7 @@ protected:
   int reuse_addr_;
 };
 
-/*
+/**
  * @class ACE_Strategy_Acceptor
  *
  * @brief Abstract factory for creating a service handler
@@ -299,7 +299,7 @@ public:
                          int use_select = 1,
                          int reuse_addr = 1);
 
-  /*
+  /**
    * Initialize the appropriate strategies for creation, passive
    * connection acceptance, and concurrency, and then register {this}
    * with the Reactor and listen for connection requests at the
@@ -316,7 +316,7 @@ public:
                          int use_select = 1,
                          int reuse_addr = 1);
 
-  /*
+  /**
    * Open the contained @c PEER_ACCEPTOR object to begin listening, and
    * register with the specified reactor for accept events.
    *
@@ -356,7 +356,7 @@ public:
                     int use_select = 1,
                     int reuse_addr = 1);
 
-  /*
+  /**
    * Initialize the appropriate strategies for creation, passive
    * connection acceptance, and concurrency, and then register {this}
    * with the Reactor and listen for connection requests at the
@@ -413,7 +413,7 @@ protected:
   // for creating, accepting, and activating {SVC_HANDLER}'s,
   // respectively.
 
-  /*
+  /**
    * Bridge method for creating a {SVC_HANDLER}.  The strategy for
    * creating a {SVC_HANDLER} are configured into the Acceptor via
    * it's {creation_strategy_}.  The default is to create a new
@@ -425,14 +425,14 @@ protected:
    */
   virtual int make_svc_handler (SVC_HANDLER *&);
 
-  /*
+  /**
    * Bridge method for accepting the new connection into the
    * {SVC_HANDLER}.  The default behavior delegates to the
    * {PEER_ACCEPTOR::accept} in the {Acceptor_Strategy}.
    */
   virtual int accept_svc_handler (SVC_HANDLER *svc_handler);
 
-  /*
+  /**
    * Bridge method for activating a {SVC_HANDLER} with the appropriate
    * concurrency strategy.  The default behavior of this method is to
    * activate the {SVC_HANDLER} by calling its {open} method (which
@@ -499,7 +499,7 @@ protected:
   ACE_PEER_ACCEPTOR_ADDR service_addr_;
 };
 
-/*
+/**
  * @class ACE_Oneshot_Acceptor
  *
  * @brief Generic factory for passively connecting clients and creating
@@ -542,7 +542,7 @@ public:
   /// Constructor.
   ACE_Oneshot_Acceptor (void);
 
-  /*
+  /**
    * Initialize the appropriate strategies for concurrency and then
    * open the acceptor at the designated @a local_addr.  Note
    * that unlike ACE_Acceptor and ACE_Strategy_Acceptor, this
@@ -554,7 +554,7 @@ public:
                         ACE_Reactor *reactor = ACE_Reactor::instance (),
                         ACE_Concurrency_Strategy<SVC_HANDLER> * = 0);
 
-  /*
+  /**
    * Initialize the appropriate strategies for concurrency and then
    * open the acceptor at the designated @a local_addr.  Note
    * that unlike ACE_Acceptor and ACE_Strategy_Acceptor, this
@@ -597,7 +597,7 @@ public:
   ACE_ALLOC_HOOK_DECLARE;
 
 protected:
-  /*
+  /**
    * Bridge method for activating a {svc_handler} with the appropriate
    * concurrency strategy.  Default behavior is to activate the
    * {SVC_HANDLER} as a "passive object."  However, subclasses can
@@ -654,7 +654,7 @@ protected:
   virtual int resume (void);
 
 private:
-  /*
+  /**
    * Insert ourselves into the {ACE_Reactor} so that we can continue
    * accepting this connection asynchronously.  This method should NOT
    * be called by developers directly.

dep/ACE_wrappers/ace/Activation_Queue.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Activation_Queue.h
  *
  *  $Id: Activation_Queue.h 91066 2010-07-12 11:05:04Z johnnyw $
@@ -33,7 +33,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
 class ACE_Method_Request;
 
-/*
+/**
  * @class ACE_Activation_Queue
  *
  * @brief
@@ -53,7 +53,7 @@ class ACE_Export ACE_Activation_Queue : private ACE_Copy_Disabled
 {
 public:
   /// Constructor.
-  /*
+  /**
    * Initializes a new activation queue.
    *
    * @param new_queue The activation queue uses an ACE_Message_Queue to
@@ -84,7 +84,7 @@ public:
   // = Activate Queue operations.
 
   /// Dequeue the next available ACE_Method_Request.
-  /*
+  /**
    * @param tv  If 0, the method will block until a method request is
    *            available, else will wait until the absolute time specified
    *            in the referenced ACE_Time_Value.  This method will return,
@@ -98,7 +98,7 @@ public:
   ACE_Method_Request *dequeue (ACE_Time_Value *tv = 0);
 
   /// Enqueue the ACE_Method_Request in priority order.
-  /*
+  /**
    * The priority of the method request is obtained via the @c priority()
    * method of the queued method request. Priority ordering is determined
    * by the ACE_Message_Queue class; 0 is the lowest priority.

dep/ACE_wrappers/ace/Active_Map_Manager.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Active_Map_Manager.h
  *
  *  $Id: Active_Map_Manager.h 91066 2010-07-12 11:05:04Z johnnyw $
@@ -25,7 +25,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Active_Map_Manager_Key
  *
  * @brief Key used in the Active Object Map.
@@ -40,7 +40,7 @@ public:
   /// Default constructor.
   ACE_Active_Map_Manager_Key (void);
 
-  /*
+  /**
    * Constructor given the @a slot_index and @a slot_generation number.
    * This is useful once the user has somehow recovered the
    * @a slot_index and @a slot_generation number from the client.
@@ -83,7 +83,7 @@ public:
 
 private:
 
-  /*
+  /**
    * @brief Data for the Active Object Map Key.
    *
    * This separate structure makes it easier to manage copying

dep/ACE_wrappers/ace/Active_Map_Manager_T.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Active_Map_Manager_T.h
  *
  *  $Id: Active_Map_Manager_T.h 84316 2009-02-03 19:46:05Z johnnyw $
@@ -26,7 +26,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Active_Map_Manager
  *
  * @brief Define a map abstraction that associates system generated
@@ -81,7 +81,7 @@ public:
   /// corresponding key produced by the Active_Map_Manager.
   int bind (const T &value);
 
-  /*
+  /**
    * Reserves a slot in the internal structure and returns the key and
    * a pointer to the value.  User should place their @a value into
    * @a internal_value.  This method is useful in reducing the number
@@ -98,7 +98,7 @@ public:
   int rebind (const ACE_Active_Map_Manager_Key &key,
               const T &value);
 
-  /*
+  /**
    * Reassociate @a key with @a value, storing the old value into the
    * "out" parameter @a old_value.  The function fails if @a key is not
    * in the map.
@@ -107,7 +107,7 @@ public:
               const T &value,
               T &old_value);
 
-  /*
+  /**
    * Reassociate @a key with @a value, storing the old key and value
    * into the "out" parameter @a old_key and @a old_value.  The function
    * fails if @a key is not in the map.
@@ -124,7 +124,7 @@ public:
   /// Is @a key in the map?
   int find (const ACE_Active_Map_Manager_Key &key) const;
 
-  /*
+  /**
    * Locate @a value associated with @a key.  The value is returned via
    * @a internal_value and hence a copy is saved.  Note that
    * @a internal_value is only a temporary pointer and will change when
@@ -146,7 +146,7 @@ public:
   int unbind (const ACE_Active_Map_Manager_Key &key,
               T &value);
 
-  /*
+  /**
    * Locate @a value associated with @a key.  The value is returned via
    * @a internal_value and hence a copy is saved.  Note that
    * @a internal_value is only a temporary pointer and will change when

dep/ACE_wrappers/ace/Addr.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Addr.h
  *
  *  $Id: Addr.h 81030 2008-03-20 12:43:29Z johnnyw $
@@ -23,7 +23,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Addr
  *
  * @brief Defines the base class for the "address family independent"

dep/ACE_wrappers/ace/Arg_Shifter.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file     Arg_Shifter.h
  *
  *  $Id: Arg_Shifter.h 91459 2010-08-25 09:51:01Z mcorino $
@@ -25,7 +25,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Arg_Shifter_T
  *
  * @brief This ADT operates on a specified set of arguments (@a argv).
@@ -56,7 +56,7 @@ class ACE_Arg_Shifter_T
 {
 public:
   // = Initialization and termination methods.
-  /*
+  /**
    * Initialize the ACE_Arg_Shifter to the vector over which to
    * iterate. Optionally, also provide the temporary array for
    * use in shifting the arguments. If ACE_Arg_Shifter must allocate
@@ -93,7 +93,7 @@ public:
   /// Get the current head of the vector.
   const CHAR_TYPE *get_current (void) const;
 
-  /*
+  /**
    * If the @a flag matches the current_arg of arg shifter
    * this method will attempt to return the associated
    * parameter value
@@ -127,7 +127,7 @@ public:
    */
   const CHAR_TYPE *get_the_parameter (const CHAR_TYPE* flag);
 
-  /*
+  /**
    * Check if the current argument matches (case insensitive) @a flag
    *
    * ------------------------------------------------------------

dep/ACE_wrappers/ace/Argv_Type_Converter.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Argv_Type_Converter.h
  *
  *  $Id: Argv_Type_Converter.h 83891 2008-11-28 11:01:50Z johnnyw $
@@ -24,7 +24,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Argv_Type_Converter
  *
  * @brief To convert 'char' input/command line parameter to 'wchar_t'.

dep/ACE_wrappers/ace/Array_Base.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file Array_Base.h
  *
  *  $Id: Array_Base.h 84477 2009-02-16 13:30:38Z johnnyw $
@@ -30,7 +30,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 // Forward declaration.
 template <class T> class ACE_Array_Iterator;
 
-/*
+/**
  * @class ACE_Array_Base
  *
  * @brief Implement a simple dynamic array
@@ -72,14 +72,14 @@ public:
                   T const & default_value,
                   ACE_Allocator * the_allocator = 0);
 
-  /*
+  /**
    * The copy constructor performs initialization by making an exact
    * copy of the contents of parameter <s>, i.e., *this == s will
    * return true.
    */
   ACE_Array_Base (ACE_Array_Base<T> const & s);
 
-  /*
+  /**
    * Assignment operator performs an assignment by making an exact
    * copy of the contents of parameter <s>, i.e., *this == s will
    * return true.  Note that if the <max_size_> of <array_> is >= than
@@ -106,7 +106,7 @@ public:
   /// -1 if @a slot is not in range, else returns 0.
   int set (T const & new_item, size_type slot);
 
-  /*
+  /**
    * Get an item in the array at location @a slot.  Returns -1 if
    * @a slot is not in range, else returns 0.  Note that this function
    * copies the item.  If you want to avoid the copy, you can use
@@ -117,7 +117,7 @@ public:
   /// Returns the <cur_size_> of the array.
   size_type size (void) const;
 
-  /*
+  /**
    * Changes the size of the array to match @a new_size.
    * It copies the old contents into the new array.
    * Return -1 on failure.
@@ -127,7 +127,7 @@ public:
   /// Returns the <max_size_> of the array.
   size_type max_size (void) const;
 
-  /*
+  /**
    * Changes the size of the array to match @a new_size.
    * It copies the old contents into the new array.
    * Return -1 on failure.
@@ -135,7 +135,7 @@ public:
    */
   int max_size (size_type new_size);
 
-  /*
+  /**
    * @name Forward Iterator Accessors
    *
    * Forward iterator accessors.
@@ -147,7 +147,7 @@ public:
   const_iterator end   (void) const;
   //@}
 
-  /*
+  /**
    * @name Reverse Iterator Accessors
    *
    * Reverse iterator accessors.
@@ -173,7 +173,7 @@ protected:
   /// in @c array_.
   size_type max_size_;
 
-  /*
+  /**
    * Current size of the array.  This starts out being == to
    * <max_size_>.  However, if we are assigned a smaller array, then
    * <cur_size_> will become less than <max_size_>.  The purpose of
@@ -193,7 +193,7 @@ protected:
 
 // ****************************************************************
 
-/*
+/**
  * @class ACE_Array_Iterator
  *
  * @brief Implement an iterator over an ACE_Array.

dep/ACE_wrappers/ace/Array_Map.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  * @file    Array_Map.h
  *
  * $Id: Array_Map.h 84136 2009-01-12 11:01:17Z johnnyw $
@@ -34,7 +34,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Array_Map
  *
  * @brief Light weight array-based map with fast iteration, but linear
@@ -105,7 +105,7 @@ public:
   ACE_DECLARE_STL_REVERSE_ITERATORS
 
   /// Default Constructor.
-  /*
+  /**
    * Create an empty map with a preallocated buffer of size @a s.
    */
   ACE_Array_Map (size_type s = 0);
@@ -123,7 +123,7 @@ public:
   /// Destructor.
   ~ACE_Array_Map (void);
 
-  /*
+  /**
    * @name Forward Iterator Accessors
    *
    * Forward iterator accessors.
@@ -135,7 +135,7 @@ public:
   const_iterator end   (void) const;
   //@}
 
-  /*
+  /**
    * @name Reverse Iterator Accessors
    *
    * Reverse iterator accessors.
@@ -148,7 +148,7 @@ public:
   //@}
 
   /// Return current size of map.
-  /*
+  /**
    * @return The number of elements in the map.
    */
   size_type size (void) const;
@@ -159,7 +159,7 @@ public:
   /// Return @c true if the map is empty, else @c false.
   bool is_empty (void) const;  // ACE style
 
-  /*
+  /**
    * Return @c true if the map is empty, else @c false.  We recommend
    * using @c is_empty() instead since it's more consistent with the
    * ACE container naming conventions.
@@ -171,7 +171,7 @@ public:
   void swap (ACE_Array_Map & map);
 
   /// Insert the value @a x into the map.
-  /*
+  /**
    * STL-style map insertion method.
    *
    * @param x @c std::pair containing key and datum.
@@ -194,36 +194,36 @@ public:
   void erase (iterator pos);
 
   /// Remove element corresponding to key @a k from the map.
-  /*
+  /**
    * @return Number of elements that were erased.
    */
   size_type erase (key_type const & k);
 
   /// Remove range of elements [@a first, @a last) from the map.
-  /*
+  /**
    * @note [@a first, @a last) must be valid range within the map.
    */
   void erase (iterator first, iterator last);
 
   /// Clear contents of map.
-  /*
+  /**
    * @note This a constant time (O(1)) operation.
    */
   void clear (void);
 
-  /*
+  /**
    * @name Search Operations
    *
    * Search the map for data corresponding to key @a k.
    */
   //@{
-  /*
+  /**
    * @return @c end() if data corresponding to key @a k is not in the
    *         map.
    */
   iterator find (key_type const & k);
 
-  /*
+  /**
    * @return @c end() if data corresponding to key @a k is not in the
    *         map.
    */
@@ -231,14 +231,14 @@ public:
   //@}
 
   /// Count the number of elements corresponding to key @a k.
-  /*
+  /**
    * @return In the case of this map, the count will always be one if
    *         such exists in the map.
    */
   size_type count (key_type const & k);
 
   /// Convenience array index operator.
-  /*
+  /**
    * Array index operator that allows insertion and retrieval of
    * elements using an array index syntax, such as:
    * @par
@@ -257,7 +257,7 @@ private:
   size_type size_;
 
   /// Current size of underlying array.
-  /*
+  /**
    * @note @c capacity_ is always greater than or equal to @c size_;
    */
   size_type capacity_;

dep/ACE_wrappers/ace/Assert.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Assert.h
  *
  *  $Id: Assert.h 82808 2008-09-23 11:27:27Z smcqueen $

dep/ACE_wrappers/ace/Asynch_Acceptor.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Asynch_Acceptor.h
  *
  *  $Id: Asynch_Acceptor.h 91693 2010-09-09 12:57:54Z johnnyw $
@@ -32,7 +32,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 class ACE_Message_Block;
 class ACE_INET_Addr;
 
-/*
+/**
  * @class ACE_Asynch_Acceptor
  *
  * @brief This class is an example of the Acceptor Pattern.  This class
@@ -52,7 +52,7 @@ public:
   /// Virtual destruction
   virtual ~ACE_Asynch_Acceptor (void);
 
-  /*
+  /**
    * @c open starts one or more asynchronous accept requests on a
    * @a address. Each accept operation may optionally read an
    * initial buffer from the new connection when accepted.
@@ -119,7 +119,7 @@ public:
   /// Get the underlying handle.
   virtual ACE_HANDLE get_handle (void) const;
 
-  /*
+  /**
    * Set the underlying listen handle. It is the user's responsibility
    * to make sure that the old listen handle has been appropriately
    * closed and the all outstanding asynchronous operations have
@@ -128,13 +128,13 @@ public:
   virtual int set_handle (ACE_HANDLE handle);
 
   /// This initiates a new asynchronous accept operation.
-  /*
+  /**
    * You need only call this method if the @a reissue_accept argument
    * passed to @c open() was 0.
    */
   virtual int accept (size_t bytes_to_read = 0, const void *act = 0);
 
-  /*
+  /**
    * Cancels all pending accepts operations issued by this object.
    *
    * @note On Windows, only accept operations initiated by the calling thread
@@ -142,7 +142,7 @@ public:
    */
   virtual int cancel (void);
 
-  /*
+  /**
    * Template method to validate peer before service is opened.
    * This method is called after a new connection is accepted if the
    * @a validate_connection argument to @c open() was non-zero or
@@ -166,7 +166,7 @@ public:
                                    const ACE_INET_Addr &remote,
                                    const ACE_INET_Addr& local);
 
-  /*
+  /**
    * Template method for deciding whether to reissue accept.
    *
    * This hook method is called after each accept completes to decide if
@@ -229,7 +229,7 @@ protected:
   /// Return the asynch accept object.
   ACE_Asynch_Accept &asynch_accept (void);
 
-  /*
+  /**
    * This is the template method used to create new handler.
    * Subclasses must overwrite this method if a new handler creation
    * strategy is required.

dep/ACE_wrappers/ace/Asynch_Connector.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Asynch_Connector.h
  *
  *  $Id: Asynch_Connector.h 80826 2008-03-04 14:51:23Z wotte $
@@ -31,7 +31,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 // Forward declarations
 class ACE_Message_Block;
 
-/*
+/**
  * @class ACE_Asynch_Connector
  *
  * @brief This class is an example of the Connector pattern.  This class
@@ -52,7 +52,7 @@ public:
   /// Virtual destruction
   virtual ~ACE_Asynch_Connector (void);
 
-  /*
+  /**
    * This opens asynch connector
    */
   virtual int open (bool pass_addresses = false,
@@ -66,7 +66,7 @@ public:
                        int reuse_addr = 1,
                        const void *act = 0);
 
-  /*
+  /**
    * This cancels all pending accepts operations that were issued by
    * the calling thread.
    *
@@ -78,7 +78,7 @@ public:
   virtual int cancel (void);
 
 
-  /*
+  /**
    * Template method to validate peer before service is opened.
    * This method is called when the connection attempt completes,
    * whether it succeeded or failed, if the @a validate_connection
@@ -137,7 +137,7 @@ protected:
   /// Return the asynch Connect object.
   ACE_Asynch_Connect & asynch_connect (void);
 
-  /*
+  /**
    * This is the template method used to create new handler.
    * Subclasses must overwrite this method if a new handler creation
    * strategy is required.

dep/ACE_wrappers/ace/Asynch_IO.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Asynch_IO.h
  *
  *  $Id: Asynch_IO.h 84837 2009-03-16 13:01:15Z johnnyw $
@@ -88,7 +88,7 @@ class ACE_Addr;
 class ACE_Asynch_Result_Impl;
 class ACE_Time_Value;
 
-/*
+/**
  * @class ACE_Asynch_Result
  *
  * @brief An interface base class which allows users access to common
@@ -114,7 +114,7 @@ public:
   /// Did the operation succeed?
   int success (void) const;
 
-  /*
+  /**
    * This is the ACT associated with the handle on which the
    * Asynch_Operation takes place.
    *
@@ -128,7 +128,7 @@ public:
   /// Error value if the operation fails.
   unsigned long error (void) const;
 
-  /*
+  /**
    * On WIN32, this returns the event associated with the OVERLAPPED
    * structure.
    *
@@ -136,7 +136,7 @@ public:
    */
   ACE_HANDLE event (void) const;
 
-  /*
+  /**
    * This really makes sense only when doing file I/O.
    *
    * On WIN32, these are represented in the OVERLAPPED datastructure.
@@ -147,7 +147,7 @@ public:
   unsigned long offset (void) const;
   unsigned long offset_high (void) const;
 
-  /*
+  /**
    * Priority of the operation.
    *
    * On POSIX4-Unix, this is supported. Priority works like {nice} in
@@ -159,7 +159,7 @@ public:
    */
   int priority (void) const;
 
-  /*
+  /**
    * POSIX4 real-time signal number to be used for the
    * operation. {signal_number} ranges from ACE_SIGRTMIN to ACE_SIGRTMAX. By
    * default, ACE_SIGRTMIN is used to issue {aio_} calls. This is a no-op
@@ -186,7 +186,7 @@ protected:
 // Forward declarations
 class ACE_Asynch_Operation_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Operation
  *
  * @brief This is an interface base class for all asynch
@@ -202,7 +202,7 @@ class ACE_Export ACE_Asynch_Operation
 {
 
 public:
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call.  If ({handle} == ACE_INVALID_HANDLE),
    * {ACE_Handler::handle} will be called on the {handler} to get the
@@ -213,7 +213,7 @@ public:
             const void *completion_key,
             ACE_Proactor *proactor);
 
-  /*
+  /**
    * (Attempts to) cancel the asynchronous operation pending against
    * the {handle} registered with this Operation.
    *
@@ -275,7 +275,7 @@ protected:
 class ACE_Asynch_Read_Stream_Result_Impl;
 class ACE_Asynch_Read_Stream_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Read_Stream
  *
  * @brief This class is a factory for starting off asynchronous reads
@@ -298,7 +298,7 @@ public:
   /// Destructor
   virtual ~ACE_Asynch_Read_Stream (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call.
    *
@@ -317,7 +317,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * Initiate an asynchronous read operation.
    *
    * @param message_block      The ACE_Message_Block to receive the data.
@@ -348,7 +348,7 @@ public:
             int signal_number = ACE_SIGRTMIN);
 
 #if defined (ACE_HAS_WIN32_OVERLAPPED_IO)
-  /*
+  /**
   * Same as above but with scatter support, through chaining of composite
   * message blocks using the continuation field.
   */
@@ -368,7 +368,7 @@ protected:
   ACE_Asynch_Read_Stream_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is the class which will be passed back to the
@@ -420,7 +420,7 @@ private:
 class ACE_Asynch_Write_Stream_Impl;
 class ACE_Asynch_Write_Stream_Result_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Write_Stream
  *
  * @brief This class is a factory for initiating asynchronous writes
@@ -442,7 +442,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Write_Stream (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous operation.
    *
@@ -467,7 +467,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * Initiates an asynchronous write on a socket. If the operation completes
    * the ACE_Handler object registered in open() will receive a completion
    * callback via its handle_write_stream() method.
@@ -504,7 +504,7 @@ public:
              int signal_number = ACE_SIGRTMIN);
 
 #if defined (ACE_HAS_WIN32_OVERLAPPED_IO)
-  /*
+  /**
   * Same as above but with gather support, through chaining of composite
   * message blocks using the continuation field.
   */
@@ -524,7 +524,7 @@ protected:
   ACE_Asynch_Write_Stream_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -576,7 +576,7 @@ private:
 class ACE_Asynch_Read_File_Impl;
 class ACE_Asynch_Read_File_Result_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Read_File
  *
  * @brief This class is a factory for starting off asynchronous reads
@@ -601,7 +601,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Read_File (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous operation.
    *
@@ -627,7 +627,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * This starts off an asynchronous read.  Upto {bytes_to_read} will
    * be read and stored in the {message_block}.  The read will start
    * at {offset} from the beginning of the file. Priority of the
@@ -649,7 +649,7 @@ public:
             int signal_number = ACE_SIGRTMIN);
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with scatter support, through chaining of composite
   * message blocks using the continuation field.
   * @note In win32 Each data block payload must be at least the size of a system
@@ -674,7 +674,7 @@ protected:
   ACE_Asynch_Read_File_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -727,7 +727,7 @@ private:
 class ACE_Asynch_Write_File_Impl;
 class ACE_Asynch_Write_File_Result_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Write_File
  *
  * @brief This class is a factory for starting off asynchronous writes
@@ -752,7 +752,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Write_File (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call. If ({handle} == ACE_INVALID_HANDLE),
    * {ACE_Handler::handle} will be called on the {handler} to get the
@@ -763,7 +763,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * This starts off an asynchronous write.  Upto {bytes_to_write}
    * will be written from the {message_block}, starting at the
    * block's {rd_ptr}.  The write will go to the file, starting
@@ -786,7 +786,7 @@ public:
              int signal_number = ACE_SIGRTMIN);
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with gather support, through chaining of composite
   * message blocks using the continuation field.
   * @note In win32 Each data block payload must be at least the size of a system
@@ -810,7 +810,7 @@ protected:
   ACE_Asynch_Write_File_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -863,7 +863,7 @@ private:
 class ACE_Asynch_Accept_Result_Impl;
 class ACE_Asynch_Accept_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Accept
  *
  * @brief This class is a factory for starting off asynchronous accepts
@@ -886,7 +886,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Accept (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call. If ({handle} == ACE_INVALID_HANDLE),
    * {ACE_Handler::handle} will be called on the {handler} to get the
@@ -897,7 +897,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * This starts off an asynchronous accept.  The asynchronous accept
    * call also allows any initial data to be returned to the
    * handler specified to @c open().
@@ -949,7 +949,7 @@ protected:
   ACE_Asynch_Accept_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -1002,7 +1002,7 @@ private:
 class ACE_Asynch_Connect_Result_Impl;
 class ACE_Asynch_Connect_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Connect
  *
  * @brief This class is a factory for starting off asynchronous connects
@@ -1023,7 +1023,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Connect (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call.
    *
@@ -1034,7 +1034,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * This starts off an asynchronous Connect.
    */
   int connect (ACE_HANDLE connect_handle,
@@ -1055,7 +1055,7 @@ protected:
   ACE_Asynch_Connect_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -1100,7 +1100,7 @@ private:
 class ACE_Asynch_Transmit_File_Result_Impl;
 class ACE_Asynch_Transmit_File_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Transmit_File
  *
  * @brief This class is a factory for starting off asynchronous
@@ -1131,7 +1131,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Transmit_File (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call. If ({handle} == ACE_INVALID_HANDLE),
    * {ACE_Handler::handle} will be called on the {handler} to get the
@@ -1142,7 +1142,7 @@ public:
             const void *completion_key = 0,
             ACE_Proactor *proactor = 0);
 
-  /*
+  /**
    * This starts off an asynchronous transmit file.  The {file} is a
    * handle to an open file.  {header_and_trailer} is a pointer to a
    * data structure that contains pointers to data to send before and
@@ -1181,7 +1181,7 @@ protected:
   ACE_Asynch_Transmit_File_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -1234,7 +1234,7 @@ public:
     ACE_Asynch_Transmit_File_Result_Impl *implementation_;
   };
 
-/*
+/**
  * @class Header_And_Trailer
  *
  * @brief The class defines a data structure that contains pointers
@@ -1316,7 +1316,7 @@ class ACE_Asynch_Read_Dgram_Result_Impl;
 class ACE_Asynch_Read_Dgram_Impl;
 class ACE_Addr;
 
-/*
+/**
  * @class ACE_Asynch_Read_Dgram
  *
  * @brief This class is a factory for starting off asynchronous reads
@@ -1339,7 +1339,7 @@ public:
   /// Destructor
   virtual ~ACE_Asynch_Read_Dgram (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call. If ({handle} == ACE_INVALID_HANDLE),
    * {ACE_Handler::handle} will be called on the {handler} to get the
@@ -1393,7 +1393,7 @@ protected:
   ACE_Asynch_Read_Dgram_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is the class which will be passed back to the
@@ -1452,7 +1452,7 @@ private:
 class ACE_Asynch_Write_Dgram_Impl;
 class ACE_Asynch_Write_Dgram_Result_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Write_Dgram
  *
  * @brief This class is a factory for starting off asynchronous writes
@@ -1475,7 +1475,7 @@ public:
   /// Destructor.
   virtual ~ACE_Asynch_Write_Dgram (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call. If ({handle} == ACE_INVALID_HANDLE),
    * {ACE_Handler::handle} will be called on the {handler} to get the
@@ -1529,7 +1529,7 @@ protected:
   ACE_Asynch_Write_Dgram_Impl *implementation_;
 
 public:
-/*
+/**
  * @class Result
  *
  * @brief This is that class which will be passed back to the
@@ -1582,7 +1582,7 @@ private:
 };
 
 
-/*
+/**
  * @class ACE_Handler
  *
  * @brief This base class defines the interface for receiving the
@@ -1641,7 +1641,7 @@ public:
   virtual void handle_time_out (const ACE_Time_Value &tv,
                                 const void *act = 0);
 
-  /*
+  /**
    * This is method works with the {run_event_loop} of the
    * ACE_Proactor. A special {Wake_Up_Completion} is used to wake up
    * all the threads that are blocking for completions.
@@ -1654,7 +1654,7 @@ public:
   /// Set the proactor.
   void proactor (ACE_Proactor *p);
 
-  /*
+  /**
    * Get the I/O handle used by this {handler}. This method will be
    * called by the ACE_Asynch_* classes when an ACE_INVALID_HANDLE is
    * passed to {open}.
@@ -1664,7 +1664,7 @@ public:
   /// Set the ACE_HANDLE value for this Handler.
   virtual void handle (ACE_HANDLE);
 
-  /*
+  /**
    * @class Proxy
    *
    * @brief The Proxy class acts as a proxy for dispatch of completions
@@ -1708,7 +1708,7 @@ class ACE_INET_Addr;
 template <class HANDLER>
 class ACE_Asynch_Acceptor;
 
-/*
+/**
  * @class ACE_Service_Handler
  *
  * @brief This base class defines the interface for the
@@ -1732,7 +1732,7 @@ public:
   /// Virtual destruction.
   virtual ~ACE_Service_Handler (void);
 
-  /*
+  /**
    * {open} is called by ACE_Asynch_Acceptor to initialize a new
    * instance of ACE_Service_Handler that has been created after the
    * new connection is accepted. The handle for the new connection is

dep/ACE_wrappers/ace/Asynch_IO_Impl.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Asynch_IO_Impl.h
  *
  *  $Id: Asynch_IO_Impl.h 80826 2008-03-04 14:51:23Z wotte $
@@ -41,7 +41,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 // Forward declaration.
 class ACE_Proactor_Impl;
 
-/*
+/**
  * @class ACE_Asynch_Result_Impl
  *
  * @brief Abstract base class for the all the classes that provide
@@ -79,7 +79,7 @@ public:
   /// Priority of the operation.
   virtual int priority (void) const = 0;
 
-  /*
+  /**
    * POSIX4 real-time signal number to be used for the
    * operation. <signal_number> ranges from SIGRTMIN to SIGRTMAX. By
    * default, SIGRTMIN is used to issue <aio_> calls. This is a no-op
@@ -105,7 +105,7 @@ protected:
   ACE_Asynch_Result_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Operation_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -117,7 +117,7 @@ class ACE_Export ACE_Asynch_Operation_Impl
 public:
   virtual ~ACE_Asynch_Operation_Impl (void);
 
-  /*
+  /**
    * Initializes the factory with information which will be used with
    * each asynchronous call.  If @a handle == ACE_INVALID_HANDLE,
    * ACE_Handler::handle() will be called on the proxied handler to get the
@@ -128,7 +128,7 @@ public:
                     const void *completion_key,
                     ACE_Proactor *proactor) = 0;
 
-  /*
+  /**
    * This cancels all pending accepts operations that were issued by
    * the calling thread.  The function does not cancel asynchronous
    * operations issued by other threads.
@@ -145,7 +145,7 @@ protected:
   ACE_Asynch_Operation_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Read_Stream_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -167,7 +167,7 @@ public:
                     int signal_number) = 0;
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with scatter support, through chaining of composite
   * message blocks using the continuation field.
   */
@@ -183,7 +183,7 @@ protected:
   ACE_Asynch_Read_Stream_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Read_Stream_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -211,7 +211,7 @@ protected:
   ACE_Asynch_Read_Stream_Result_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Write_Stream_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -233,7 +233,7 @@ public:
                      int signal_number) = 0;
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with gather support, through chaining of composite
   * message blocks using the continuation field.
   */
@@ -249,7 +249,7 @@ protected:
   ACE_Asynch_Write_Stream_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Write_Stream_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -277,7 +277,7 @@ protected:
   ACE_Asynch_Write_Stream_Result_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Read_File_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -290,7 +290,7 @@ class ACE_Export ACE_Asynch_Read_File_Impl : public virtual ACE_Asynch_Read_Stre
 public:
   virtual ~ACE_Asynch_Read_File_Impl (void);
 
-  /*
+  /**
    * This starts off an asynchronous read.  Upto @a bytes_to_read will
    * be read and stored in the @a message_block.  The read will start
    * at @a offset from the beginning of the file.
@@ -304,7 +304,7 @@ public:
                     int signal_number) = 0;
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with scatter support, through chaining of composite
   * message blocks using the continuation field.
   * @note In win32 Each data block payload must be at least the size of a system
@@ -328,7 +328,7 @@ public:
                     int signal_number) = 0;
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with scatter support, through chaining of composite
   * message blocks using the continuation field.
   */
@@ -344,7 +344,7 @@ protected:
   ACE_Asynch_Read_File_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Read_File_Result_Impl
  *
  * @brief This is the abstract base class for all the concrete
@@ -362,7 +362,7 @@ protected:
   ACE_Asynch_Read_File_Result_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Write_File_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -375,7 +375,7 @@ class ACE_Export ACE_Asynch_Write_File_Impl : public virtual ACE_Asynch_Write_St
 public:
   virtual ~ACE_Asynch_Write_File_Impl (void);
 
-  /*
+  /**
    * This starts off an asynchronous write.  Upto @a bytes_to_write
    * will be write and stored in the @a message_block.  The write will
    * start at @a offset from the beginning of the file.
@@ -389,7 +389,7 @@ public:
                      int signal_number) = 0;
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with gather support, through chaining of composite
   * message blocks using the continuation field.
   * @note In win32 Each data block payload must be at least the size of a system
@@ -413,7 +413,7 @@ public:
                      int signal_number) = 0;
 
 #if (defined (ACE_WIN32) && !defined (ACE_HAS_WINCE))
-  /*
+  /**
   * Same as above but with gather support, through chaining of composite
   * message blocks using the continuation field.
   */
@@ -429,7 +429,7 @@ protected:
   ACE_Asynch_Write_File_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Write_File_Result_Impl
  *
  * @brief This is the abstract base class for all the concrete
@@ -447,7 +447,7 @@ protected:
   ACE_Asynch_Write_File_Result_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Accept_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -460,7 +460,7 @@ class ACE_Export ACE_Asynch_Accept_Impl : public virtual ACE_Asynch_Operation_Im
 public:
   virtual ~ACE_Asynch_Accept_Impl (void);
 
-  /*
+  /**
    * This starts off an asynchronous accept.  The asynchronous accept
    * call also allows any initial data to be returned to the
    * <handler>.  Upto @a bytes_to_read will be read and stored in the
@@ -484,7 +484,7 @@ protected:
   ACE_Asynch_Accept_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Accept_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -516,7 +516,7 @@ protected:
 };
 
 
-/*
+/**
  * @class ACE_Asynch_Connect_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -529,7 +529,7 @@ class ACE_Export ACE_Asynch_Connect_Impl : public virtual ACE_Asynch_Operation_I
 public:
   virtual ~ACE_Asynch_Connect_Impl (void);
 
-  /*
+  /**
    * This starts off an asynchronous connect
    */
   virtual int connect (ACE_HANDLE connect_handle,
@@ -545,7 +545,7 @@ protected:
   ACE_Asynch_Connect_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Connect_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -567,7 +567,7 @@ protected:
 };
 
 
-/*
+/**
  * @class ACE_Asynch_Transmit_File_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -597,7 +597,7 @@ protected:
   ACE_Asynch_Transmit_File_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Transmit_File_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -636,7 +636,7 @@ protected:
 };
 
 
-/*
+/**
  * @class ACE_Asynch_Read_Dgram_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -688,7 +688,7 @@ protected:
   ACE_Asynch_Read_Dgram_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Read_Dgram_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -722,7 +722,7 @@ protected:
   ACE_Asynch_Read_Dgram_Result_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Write_Dgram_Impl
  *
  * @brief Abstract base class for all the concrete implementation
@@ -774,7 +774,7 @@ protected:
   ACE_Asynch_Write_Dgram_Impl (void);
 };
 
-/*
+/**
  * @class ACE_Asynch_Write_Dgram_Result_Impl
  *
  * @brief Abstract base class for all the concrete implementation

dep/ACE_wrappers/ace/Asynch_Pseudo_Task.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Asynch_Pseudo_Task.h
  *
  *  $Id: Asynch_Pseudo_Task.h 80826 2008-03-04 14:51:23Z wotte $
@@ -34,7 +34,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  */
 //@@ REACTOR_SPL_INCLUDE_FORWARD_DECL_ADD_HOOK
 
-/*
+/**
  * @class ACE_Asynch_Pseudo_Task
  *
  */

dep/ACE_wrappers/ace/Atomic_Op.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Atomic_Op.h
  *
  *  $Id: Atomic_Op.h 91523 2010-08-27 14:18:02Z johnnyw $
@@ -62,7 +62,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
 #if defined (ACE_HAS_BUILTIN_ATOMIC_OP)
 
-/*
+/**
  * @brief Specialization of ACE_Atomic_Op for platforms that
  *        support atomic integer operations.
  *
@@ -159,7 +159,7 @@ private:
   static long (*exchange_add_fn_) (volatile long *, long);
 };
 
-/*
+/**
  * @brief Specialization of ACE_Atomic_Op for platforms that
  *        support atomic integer operations.
  *

dep/ACE_wrappers/ace/Atomic_Op_GCC_T.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Atomic_Op_GCC_T.h
  *
  *  $Id: Atomic_Op_GCC_T.h 89339 2010-03-05 12:20:47Z johnnyw $
@@ -27,7 +27,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @brief Specialization of ACE_Atomic_Op for platforms that
  *        support atomic integer operations.
  *

dep/ACE_wrappers/ace/Atomic_Op_T.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Atomic_Op_T.h
  *
  *  $Id: Atomic_Op_T.h 92353 2010-10-25 06:34:35Z johnnyw $
@@ -129,7 +129,7 @@ struct ACE_Type_Traits<TYPE*>
   typedef TYPE* parameter_type;
 };
 
-/*
+/**
  * @class ACE_Atomic_Op_Ex
  *
  * @brief Transparently parameterizes synchronization into basic
@@ -219,7 +219,7 @@ public:
   /// Manage copying...
   ACE_Atomic_Op_Ex (ACE_Atomic_Op_Ex<ACE_LOCK, TYPE> const &);
 
-  /*
+  /**
    * Returns a reference to the underlying ACE_LOCK.  This makes it
    * possible to acquire the lock explicitly, which can be useful in
    * some cases if you instantiate the ACE_Atomic_Op_Ex with an
@@ -229,7 +229,7 @@ public:
    */
   ACE_LOCK & mutex (void);
 
-  /*
+  /**
    * Explicitly return @c value_ (by reference).  This gives the user
    * full, unrestricted access to the underlying value.  This method
    * will usually be used in conjunction with explicit access to the
@@ -245,7 +245,7 @@ private:
   TYPE value_;
 };
 
-/*
+/**
  * @class ACE_Atomic_Op
  *
  * @brief Transparently parameterizes synchronization into basic
@@ -324,7 +324,7 @@ public:
   /// Dump the state of an object.
   void dump (void) const;
 
-  /*
+  /**
    * Explicitly return @c value_ (by reference).  This gives the user
    * full, unrestricted access to the underlying value.  This method
    * will usually be used in conjunction with explicit access to the

dep/ACE_wrappers/ace/Auto_Event.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //==========================================================================
-/*
+/**
  *  @file    Auto_Event.h
  *
  *  $Id: Auto_Event.h 91781 2010-09-15 12:49:15Z johnnyw $
@@ -26,7 +26,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Auto_Event
  *
  * @brief Auto Events.

dep/ACE_wrappers/ace/Auto_Functor.h

@@ -1,6 +1,6 @@
 // -*- C++ -*-
 //=============================================================================
-/*
+/**
  * @file Auto_Functor.h
  *
  * $Id: Auto_Functor.h 80826 2008-03-04 14:51:23Z wotte $
@@ -24,7 +24,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
 namespace ACE_Utils
 {
-/*
+/**
  * @class Auto_Functor_Ref
  *
  * @brief Helper class to implement assignment and copy-construction
@@ -39,7 +39,7 @@ struct Auto_Functor_Ref
   Auto_Functor_Ref(X * p, Functor f);
 };
 
-/*
+/**
  * @class Auto_Functor
  *
  * @brief Helper template to implement auto_ptr<>-like classes, but

dep/ACE_wrappers/ace/Auto_IncDec_T.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Auto_IncDec_T.h
  *
  *  $Id: Auto_IncDec_T.h 92353 2010-10-25 06:34:35Z johnnyw $
@@ -26,7 +26,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Auto_IncDec
  *
  * @brief This class automatically increments and decrements a

dep/ACE_wrappers/ace/Auto_Ptr.h

@@ -1,7 +1,7 @@
 /* -*- C++ -*- */
 
 //=============================================================================
-/*
+/**
  *  @file    Auto_Ptr.h
  *
  *  $Id: Auto_Ptr.h 80826 2008-03-04 14:51:23Z wotte $
@@ -35,7 +35,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Auto_Basic_Ptr
  *
  * @brief Implements the draft C++ standard auto_ptr abstraction.
@@ -82,7 +82,7 @@ using std::auto_ptr;
 #endif /* ACE_USES_STD_NAMESPACE_FOR_STDCPP_LIB */
 #else /* ACE_HAS_STANDARD_CPP_LIBRARY */
 
-/*
+/**
  * @class auto_ptr
  *
  * @brief Implements the draft C++ standard auto_ptr abstraction.
@@ -104,7 +104,7 @@ public:
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @brief Implements the draft C++ standard auto_ptr abstraction.
  * This version can be used instead of auto_ptr<T>, and obviates
  * the need for the ACE_AUTO_PTR_RESET macro on platforms like
@@ -122,7 +122,7 @@ public:
   X *operator-> () const;
 };
 
-/*
+/**
  * @class ACE_Auto_Basic_Array_Ptr
  *
  * @brief Implements an extension to the draft C++ standard auto_ptr
@@ -160,7 +160,7 @@ protected:
   X * p_;
 };
 
-/*
+/**
  * @class ACE_Auto_Array_Ptr
  *
  * @brief Implements an extension to the draft C++ standard auto_ptr
@@ -180,7 +180,7 @@ public:
 };
 
 
-/*
+/**
  * @brief Reset given @c auto_ptr element to new element.
  *
  * Some platforms have an older version of auto_ptr support, which

dep/ACE_wrappers/ace/Barrier.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //==========================================================================
-/*
+/**
  *  @file    Barrier.h
  *
  *  $Id: Barrier.h 92069 2010-09-28 11:38:59Z johnnyw $
@@ -31,7 +31,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Barrier
  *
  * @brief This is a no-op to make ACE "syntactically consistent."
@@ -76,7 +76,7 @@ struct ACE_Export ACE_Sub_Barrier
   ACE_ALLOC_HOOK_DECLARE;
 };
 
-/*
+/**
  * @class ACE_Barrier
  *
  * @brief Implements "barrier synchronization".
@@ -138,7 +138,7 @@ protected:
   /// Total number of threads that can be waiting at any one time.
   int count_;
 
-  /*
+  /**
    * We keep two @c sub_barriers, one for the first "generation" of
    * waiters, and one for the next "generation" of waiters.  This
    * efficiently solves the problem of what to do if all the first
@@ -156,7 +156,7 @@ private:
   ACE_Barrier (const ACE_Barrier &);
 };
 
-/*
+/**
  * @class ACE_Thread_Barrier
  *
  * @brief Implements "barrier synchronization" using ACE_Thread_Mutexes!

dep/ACE_wrappers/ace/Base_Thread_Adapter.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Base_Thread_Adapter.h
  *
  *  $Id: Base_Thread_Adapter.h 81239 2008-04-04 22:28:48Z iliyan $
@@ -40,7 +40,7 @@ extern "C" ACE_Export ACE_THR_FUNC_RETURN ACE_THREAD_ADAPTER_NAME (void *args);
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_OS_Thread_Descriptor
  *
  * @brief Parent class of all ACE_Thread_Descriptor classes.
@@ -58,7 +58,7 @@ protected:
   /// For use by ACE_Thread_Descriptor.
   ACE_OS_Thread_Descriptor (long flags = 0);
 
-  /*
+  /**
    * Keeps track of whether this thread was created "detached" or not.
    * If a thread is *not* created detached then if someone calls
    * <ACE_Thread_Manager::wait>, we need to join with that thread (and
@@ -72,7 +72,7 @@ protected:
 class ACE_Service_Gestalt;
 
 
-/*
+/**
  * @class ACE_Base_Thread_Adapter
  *
  * @brief Base class for all the Thread_Adapters.
@@ -160,7 +160,7 @@ protected:
   /// linkage).
   ACE_THR_C_FUNC entry_point_;
 
-  /*
+  /**
    * Optional thread descriptor.  Passing this pointer in will force
    * the spawned thread to cache this location in <Log_Msg> and wait
    * until <Thread_Manager> fills in all information in thread

dep/ACE_wrappers/ace/Based_Pointer_Repository.cpp

@@ -9,7 +9,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Based_Pointer_Repository_Rep
  *
  * @brief Implementation for the ACE_Based_Pointer_Repository.

dep/ACE_wrappers/ace/Based_Pointer_Repository.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Based_Pointer_Repository.h
  *
  *  $Id: Based_Pointer_Repository.h 84837 2009-03-16 13:01:15Z johnnyw $
@@ -32,7 +32,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 // Forward decl., using the "Cheshire Cat" technique.
 class ACE_Based_Pointer_Repository_Rep;
 
-/*
+/**
  * @class ACE_Based_Pointer_Repository
  *
  * @brief Maps pointers to the base address of the region to which each
@@ -48,7 +48,7 @@ public:
   ~ACE_Based_Pointer_Repository (void);
 
   // = Search structure methods.
-  /*
+  /**
    * Return the appropriate @a base_addr region that contains @a addr.
    * Returns 1 on success and 0 if the @a addr isn't contained in any
    * @a base_addr region.

dep/ACE_wrappers/ace/Based_Pointer_T.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Based_Pointer_T.h
  *
  *  $Id: Based_Pointer_T.h 81705 2008-05-15 14:02:02Z johnnyw $
@@ -29,7 +29,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Based_Pointer_Basic
  *
  * @brief A proxy that keeps track of the relative offset of a "pointer"
@@ -44,7 +44,7 @@ template <class CONCRETE>
 class ACE_Based_Pointer_Basic
 {
 public:
-  /*
+  /**
    * This constructor initializes the <base_offset_> by asking the
    * <ACE_BASED_POINTER_REPOSITORY> Singleton for the base address of
    * the memory region within which it is instantiated.  Two results
@@ -63,7 +63,7 @@ public:
    */
   ACE_Based_Pointer_Basic (void);
 
-  /*
+  /**
    * Initialize this object using the @a initial pointer.  This
    * constructor initializes the <base_offset_> by asking the
    * <ACE_BASED_POINTER_REPOSITORY> Singleton for the base address of
@@ -145,7 +145,7 @@ protected:
   ptrdiff_t base_offset_;
 };
 
-/*
+/**
  * @class ACE_Based_Pointer
  *
  * @brief A smart proxy that keeps track of the relative offset of a

dep/ACE_wrappers/ace/Basic_Stats.h

@@ -1,6 +1,6 @@
 
 //=============================================================================
-/*
+/**
  *  @file    Basic_Stats.h
  *
  *  $Id: Basic_Stats.h 80826 2008-03-04 14:51:23Z wotte $
@@ -24,7 +24,7 @@
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
 /// Collect basic stats about a series of samples
-/*
+/**
  * Compute the average and standard deviation (aka jitter) for an
  * arbitrary number of samples, using constant space.
  * Normally used for latency statistics.
@@ -33,7 +33,7 @@ class ACE_Export ACE_Basic_Stats
 {
 public:
   /// Constructor
-  /*
+  /**
    * The number of samples is pre-allocated, and cannot changes once
    * the class is initialized.
    */
@@ -49,7 +49,7 @@ public:
   void accumulate (const ACE_Basic_Stats &rhs);
 
   /// Dump all the samples
-  /*
+  /**
    * Prints out the results, using @a msg as a prefix for each message and
    * scaling all the numbers by @a scale_factor. The latter is useful because
    * high resolution timer samples are acquired in clock ticks, but often

dep/ACE_wrappers/ace/Basic_Types.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Basic_Types.h
  *
  *  $Id: Basic_Types.h 91161 2010-07-21 18:25:12Z schmidt $
@@ -449,7 +449,7 @@ ACE_END_VERSIONED_NAMESPACE_DECL
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_U_LongLong
  *
  * @brief Unsigned long long for platforms that don't have one.
@@ -648,7 +648,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 inline ACE_UINT32
 ACE_U64_TO_U32 (ACE_U_LongLong const & n)
 {
-  /*
+  /**
    * @note We could add a cast operator to ACE_U_LongLong but that may
    *       cause more problems than it solves.  Force users to perform
    *       an explicit cast via ACE_{C}U64_TO_{C}U32.

dep/ACE_wrappers/ace/Bound_Ptr.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Bound_Ptr.h
  *
  *  $Id: Bound_Ptr.h 82723 2008-09-16 09:35:44Z johnnyw $
@@ -26,7 +26,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Bound_Ptr_Counter
  *
  * @brief An ACE_Bound_Ptr_Counter<ACE_LOCK> object encapsulates an
@@ -96,7 +96,7 @@ private:
 // Forward decl.
 template <class X, class ACE_LOCK> class ACE_Weak_Bound_Ptr;
 
-/*
+/**
  * @class ACE_Strong_Bound_Ptr
  *
  * @brief This class implements support for a reference counted
@@ -174,7 +174,7 @@ public:
   /// Equality operator that returns @c true if both
   /// ACE_Strong_Bound_Ptr instances point to the same underlying
   /// object.
-  /*
+  /**
    * @note It also returns @c true if both objects have just been
    *       instantiated and not used yet.
    */
@@ -183,7 +183,7 @@ public:
   /// Equality operator that returns true if the ACE_Strong_Bound_Ptr
   /// and ACE_Weak_Bound_Ptr objects point to the same underlying
   /// object.
-  /*
+  /**
    * @note It also returns @c true if both objects have just been
    *       instantiated and not used yet.
    */
@@ -246,7 +246,7 @@ private:
   X *ptr_;
 };
 
-/*
+/**
  * @class ACE_Weak_Bound_Ptr
  *
  * @brief This class implements support for a weak pointer that complements
@@ -287,7 +287,7 @@ public:
 
   /// Equality operator that returns @c true if both
   /// ACE_Weak_Bound_Ptr objects point to the same underlying object.
-  /*
+  /**
    * @note It also returns @c true if both objects have just been
    *       instantiated and not used yet.
    */
@@ -296,7 +296,7 @@ public:
   /// Equality operator that returns @c true if the ACE_Weak_Bound_Ptr
   /// and ACE_Strong_Bound_Ptr objects point to the same underlying
   /// object.
-  /*
+  /**
    * @note It also returns @c true if both objects have just been
    *       instantiated and not used yet.
    */
@@ -316,7 +316,7 @@ public:
   bool operator != (X *p) const;
 
   /// Redirection operator.
-  /*
+  /**
    * It returns a temporary strong pointer and makes use of the
    * chaining properties of operator-> to ensure that the underlying
    * object does not disappear while you are using it.  If you are
@@ -340,7 +340,7 @@ public:
   void reset (X *p = 0);
 
   /// Increment the reference count on the underlying object.
-  /*
+  /**
    * Returns the new reference count on the object. This function may
    * be used to integrate the bound pointers into an external
    * reference counting mechanism such as those used by COM or CORBA
@@ -350,7 +350,7 @@ public:
 
   /// Decrement the reference count on the underlying object, which is deleted
   /// if the count has reached zero.
-  /*
+  /**
    * Returns the new reference count on the object.  This function may
    * be used to integrate the bound pointers into an external
    * reference counting mechanism such as those used by COM or CORBA

dep/ACE_wrappers/ace/CDR_Base.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file   CDR_Base.h
  *
  *  $Id: CDR_Base.h 91685 2010-09-09 09:35:14Z johnnyw $
@@ -53,7 +53,7 @@ ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
 class ACE_Message_Block;
 
-/*
+/**
  * @class ACE_CDR
  *
  * @brief Keep constants and some routines common to both Output and
@@ -92,7 +92,7 @@ public:
     MAX_ALIGNMENT = 8,
 
     /// The default buffer size.
-    /*
+    /**
      * @todo We want to add options to control this
      *   default value, so this constant should be read as the default
      *   default value ;-)
@@ -109,7 +109,7 @@ public:
     LINEAR_GROWTH_CHUNK = ACE_DEFAULT_CDR_LINEAR_GROWTH_CHUNK
   };
 
-  /*
+  /**
    * @enum Byte_Order
    *
    * Defines values for the byte_order argument to ACE_OutputCDR and
@@ -125,7 +125,7 @@ public:
     BYTE_ORDER_NATIVE = ACE_CDR_BYTE_ORDER
   };
 
-  /*
+  /**
    * Do byte swapping for each basic IDL type size.  There exist only
    * routines to put byte, halfword (2 bytes), word (4 bytes),
    * doubleword (8 bytes) and quadword (16 byte); because those are
@@ -152,7 +152,7 @@ public:
   /// set by the CORBA spec at 8 bytes.
   static void mb_align (ACE_Message_Block *mb);
 
-  /*
+  /**
    * Compute the size of the smallest buffer that can contain at least
    * @a minsize bytes.
    * To understand how a "best fit" is computed look at the
@@ -168,7 +168,7 @@ public:
   /// will fir @a minsize bytes.
   static size_t next_size (size_t minsize);
 
-  /*
+  /**
    * Increase the capacity of mb to contain at least @a minsize bytes.
    * If @a minsize is zero the size is increased by an amount at least
    * large enough to contain any of the basic IDL types.
@@ -177,7 +177,7 @@ public:
    */
   static int grow (ACE_Message_Block *mb, size_t minsize);
 
-  /*
+  /**
    * Copy a message block chain into a single message block,
    * preserving the alignment of the first message block of the
    * original stream, not the following message blocks.
@@ -190,7 +190,7 @@ public:
   static size_t total_length (const ACE_Message_Block *begin,
                               const ACE_Message_Block *end);
 
-  /*
+  /**
    * @name Basic OMG IDL Types
    *
    * These types are for use in the CDR classes.  The cleanest way to
@@ -234,7 +234,7 @@ public:
           ACE_CDR::Long h;
 #     endif /* ! ACE_BIG_ENDIAN */
 
-          /*
+          /**
            * @name Overloaded Relation Operators.
            *
            * The canonical comparison operators.

dep/ACE_wrappers/ace/CDR_Size.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file   CDR_Size.h
  *
  *  $Id: CDR_Size.h 80826 2008-03-04 14:51:23Z wotte $
@@ -38,7 +38,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_SizeCDR
  *
  * @brief A CDR stream for calculating size of the representation.
@@ -140,7 +140,7 @@ private:
   ACE_CDR::Boolean write_8 (const ACE_CDR::ULongLong *x);
   ACE_CDR::Boolean write_16 (const ACE_CDR::LongDouble *x);
 
-  /*
+  /**
    * write an array of @a length elements, each of @a size bytes and the
    * start aligned at a multiple of <align>. The elements are assumed
    * to be packed with the right alignment restrictions.  It is mostly

dep/ACE_wrappers/ace/CDR_Stream.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file   CDR_Stream.h
  *
  *  $Id: CDR_Stream.h 84527 2009-02-19 14:01:42Z johnnyw $
@@ -67,7 +67,7 @@ class ACE_WChar_Codeset_Translator;
 
 class ACE_InputCDR;
 
-/*
+/**
  * @class ACE_OutputCDR
  *
  * @brief A CDR stream for marshalling data, most often for transmission to
@@ -84,7 +84,7 @@ class ACE_InputCDR;
 class ACE_Export ACE_OutputCDR
 {
 public:
-  /*
+  /**
    * The Codeset translators need access to some private members to
    * efficiently marshal arrays
    * For reading from an output CDR stream.
@@ -93,7 +93,7 @@ public:
   friend class ACE_WChar_Codeset_Translator;
   friend class ACE_InputCDR;
 
-  /*
+  /**
    * Default constructor; allows one to set byte ordering, allocators, and
    * tuning information.
    *
@@ -122,7 +122,7 @@ public:
   /// Build a CDR stream with an initial buffer, it will *not* remove
   /// @a data, since it did not allocated it.  It's important to be careful
   /// with the alignment of @a data.
-  /*
+  /**
    * Create an output stream from an arbitrary buffer, care must be
    * exercised with alignment, because this contructor will align if
    * needed.  In this case @a data will not point to the start of the
@@ -143,7 +143,7 @@ public:
   /// Build a CDR stream with an initial data block, it will *not* remove
   /// <data_block>, since it did not allocated it.  It's important to be
   // careful with the alignment of <data_block>.
-  /*
+  /**
    * Create an output stream from an arbitrary data block, care must be
    * exercised with alignment, because this contructor will align if
    * needed.  In this case @a data_block will not point to the
@@ -169,7 +169,7 @@ public:
   /// destructor
   ~ACE_OutputCDR (void);
 
-  /*
+  /**
    * Disambiguate overload when inserting booleans, octets, chars, and
    * bounded strings.
    */
@@ -226,7 +226,7 @@ public:
   };
   //@}
 
-  /*
+  /**
    * @{ @name Write operations
    * Return 0 on failure and 1 on success.
    */
@@ -290,7 +290,7 @@ public:
   ACE_CDR::Boolean write_octet_array_mb (const ACE_Message_Block* mb);
   //@}
 
-  /*
+  /**
    * @{ @name Placeholder/replace operations
    * Facilitates writing a placeholder into a CDR stream to be replaced
    * later with a different value.
@@ -306,7 +306,7 @@ public:
       @endcode
   */
 
-  /*
+  /**
    * Write a placeholder into the stream. The placeholder's pointer
    * is returned so it may later be passed as the @a loc argument to
    * replace ().
@@ -319,7 +319,7 @@ public:
   char* write_long_placeholder (void);
   char* write_short_placeholder (void);
 
-  /*
+  /**
    * Writes a new value into a specific location. This is commonly
    * used to update a prior "placeholder" location in the stream.
    * The specified location is assumed to have proper CDR alignment for the
@@ -339,7 +339,7 @@ public:
   ACE_CDR::Boolean replace (ACE_CDR::Short x, char* loc);
   //@}
 
-  /*
+  /**
    * Return 0 on failure and 1 on success.
    */
   //@{ @name Append contents of own CDR stream to another
@@ -362,7 +362,7 @@ public:
   //@}
 
   /// Returns @c false if an error has ocurred.
-  /*
+  /**
    * @note The only expected error is to run out of memory.
    */
   bool good_bit (void) const;
@@ -373,7 +373,7 @@ public:
   /// Add the length of each message block in the chain.
   size_t total_length (void) const;
 
-  /*
+  /**
    * Return the start of the message block chain for this CDR stream.
    * @note The complete CDR stream is represented by a chain of
    * message blocks.
@@ -387,7 +387,7 @@ public:
   const ACE_Message_Block *current (void) const;
 
   /// Replace the message block chain with a single message block.
-  /*
+  /**
    * Upon successful completion, there will be a single message block
    * containing the data from the complete message block chain.
    *
@@ -395,21 +395,21 @@ public:
    */
   int consolidate (void);
 
-  /*
+  /**
    * Access the underlying buffer (read only).  @note This
    * method only returns a pointer to the first block in the
    * chain.
    */
   const char *buffer (void) const;
 
-  /*
+  /**
    * Return the size of first message block in the block chain. @note This
    * method only returns information about the first block in the
    * chain.
    */
   size_t length (void) const;
 
-  /*
+  /**
    * Utility function to allow the user more flexibility.
    * Pads the stream up to the nearest <alignment>-byte boundary.
    * Argument MUST be a power of 2.
@@ -433,7 +433,7 @@ public:
   /// access the serialized size of wchars.
   static size_t wchar_maxbytes (void);
 
-  /*
+  /**
    * Return alignment of the wr_ptr(), with respect to the start of
    * the CDR stream.  This is not the same as the alignment of
    * current->wr_ptr()!
@@ -442,7 +442,7 @@ public:
 
   void current_alignment (size_t current_alignment);
 
-  /*
+  /**
    * Returns (in @a buf) the next position in the buffer aligned to
    * @a size, it advances the Message_Block wr_ptr past the data
    * (i.e., @a buf + @a size). If necessary it grows the Message_Block
@@ -501,7 +501,7 @@ private:
   ACE_CDR::Boolean write_8 (const ACE_CDR::ULongLong *x);
   ACE_CDR::Boolean write_16 (const ACE_CDR::LongDouble *x);
 
-  /*
+  /**
    * write an array of @a length elements, each of @a size bytes and the
    * start aligned at a multiple of <align>. The elements are assumed
    * to be packed with the right alignment restrictions.  It is mostly
@@ -523,7 +523,7 @@ private:
                                         ACE_CDR::ULong length);
 
 
-  /*
+  /**
    * Grow the CDR stream. When it returns @a buf contains a pointer to
    * memory in the CDR stream, with at least @a size bytes ahead of it
    * and aligned to an <align> boundary. It moved the <wr_ptr> to <buf
@@ -541,7 +541,7 @@ private:
   ACE_Message_Block *current_;
 
 #if !defined (ACE_LACKS_CDR_ALIGNMENT)
-  /*
+  /**
    * The current alignment as measured from the start of the buffer.
    * Usually this coincides with the alignment of the buffer in
    * memory, but, when we chain another buffer this "quasi invariant"
@@ -552,7 +552,7 @@ private:
   size_t current_alignment_;
 #endif /* ACE_LACKS_CDR_ALIGNMENT */
 
-  /*
+  /**
    * Is the current block writable.  When we steal a buffer from the
    * user and just chain it into the message block we are not supposed
    * to write on it, even if it is past the start and end of the
@@ -560,7 +560,7 @@ private:
    */
   bool current_is_writable_;
 
-  /*
+  /**
    * If not zero swap bytes at writing so the created CDR stream byte
    * order does *not* match the machine byte order.  The motivation
    * for such a beast is that in some setting a few (fast) machines
@@ -590,7 +590,7 @@ protected:
   ACE_Char_Codeset_Translator *char_translator_;
   ACE_WChar_Codeset_Translator *wchar_translator_;
 
-  /*
+  /**
    * Some wide char codesets may be defined with a maximum number
    * of bytes that is smaller than the size of a wchar_t. This means
    * that the CDR cannot simply memcpy a block of wchars to and from
@@ -605,7 +605,7 @@ protected:
 
 // ****************************************************************
 
-/*
+/**
  * @class ACE_InputCDR
  *
  * @brief A CDR stream for demarshalling CDR-encoded data.
@@ -628,7 +628,7 @@ public:
   friend class ACE_Char_Codeset_Translator;
   friend class ACE_WChar_Codeset_Translator;
 
-  /*
+  /**
    * Create an input stream from an arbitrary buffer.  The buffer must
    * be properly aligned because this contructor will *not* work if
    * the buffer is aligned unproperly.See ACE_ptr_align_binary() for
@@ -649,7 +649,7 @@ public:
                 ACE_CDR::Octet minor_version = ACE_CDR_GIOP_MINOR_VERSION);
 
   /// Create an input stream from an ACE_Message_Block
-  /*
+  /**
    * The alignment of the @a data block is carried into the new
    * ACE_InputCDR object. This constructor either increments the
    * @a data reference count, or copies the data (if it's a compound
@@ -683,7 +683,7 @@ public:
                 ACE_CDR::Octet major_version = ACE_CDR_GIOP_MAJOR_VERSION,
                 ACE_CDR::Octet minor_version = ACE_CDR_GIOP_MINOR_VERSION);
 
-  /*
+  /**
    * These make a copy of the current stream state, but do not copy
    * the internal buffer, so the same stream can be read multiple
    * times efficiently.
@@ -754,7 +754,7 @@ public:
 
   struct ACE_Export to_string
   {
-    /*
+    /**
      * @deprecated The constructor taking a non-const string is now
      *             deprecated (C++ mapping 00-01-02), but we keep it
      *             around for backward compatibility.
@@ -781,7 +781,7 @@ public:
   };
   //@}
 
-  /*
+  /**
    * Return @c false on failure and @c true on success.
    */
   //@{ @name Read basic IDL types
@@ -804,7 +804,7 @@ public:
   ACE_CDR::Boolean read_wstring (ACE_CDR::WChar*& x);
   //@}
 
-  /*
+  /**
    * The buffer @a x must be large enough to contain @a length
    * elements.
    * Return @c false on failure and @c true on success.
@@ -838,7 +838,7 @@ public:
                                           ACE_CDR::ULong length);
   //@}
 
-  /*
+  /**
    * Return @c false on failure and @c true on success.
    */
   //@{ @name Skip elements
@@ -857,7 +857,7 @@ public:
   ACE_CDR::Boolean skip_longdouble (void);
   //@}
 
-  /*
+  /**
    * The next field must be a string, this method skips it. It is
    * useful in parsing a TypeCode.
    * @return @c false on failure and @c true on success.
@@ -866,7 +866,7 @@ public:
   ACE_CDR::Boolean skip_string (void);
 
   /// Skip @a n bytes in the CDR stream.
-  /*
+  /**
    * @return @c false on failure and @c true on success.
    */
   ACE_CDR::Boolean skip_bytes (size_t n);
@@ -874,7 +874,7 @@ public:
   /// returns @c false if a problem has been detected.
   bool good_bit (void) const;
 
-  /*
+  /**
    * @return The start of the message block chain for this CDR
    *         stream.
    *
@@ -886,14 +886,14 @@ public:
   // = The following functions are useful to read the contents of the
   //   CDR stream from a socket or file.
 
-  /*
+  /**
    * Grow the internal buffer, reset @c rd_ptr to the first byte in
    * the new buffer that is properly aligned, and set @c wr_ptr to @c
    * rd_ptr @c + @c newsize
    */
   int grow (size_t newsize);
 
-  /*
+  /**
    * After reading and partially parsing the contents the user can
    * detect a change in the byte order, this method will let him/her
    * change it.
@@ -914,7 +914,7 @@ public:
 
   /// Exchange data blocks with the caller of this method. The read
   /// and write pointers are also exchanged.
-  /*
+  /**
    * @note We now do only with the start_ message block.
    */
   void exchange_data_blocks (ACE_InputCDR &cdr);
@@ -922,7 +922,7 @@ public:
   /// Copy the data portion from the @a cdr to this cdr and return the
   /// data content (ie. the ACE_Data_Block) from this CDR to the
   /// caller.
-  /*
+  /**
    * @note The caller is responsible for managing the memory of the
    *       returned ACE_Data_Block.
    */
@@ -941,7 +941,7 @@ public:
   /// Return how many bytes are left in the stream.
   size_t length (void) const;
 
-  /*
+  /**
    * Utility function to allow the user more flexibility.
    * Skips up to the nearest @a alignment-byte boundary.
    * Argument MUST be a power of 2.
@@ -966,7 +966,7 @@ public:
   void char_translator (ACE_Char_Codeset_Translator *);
   void wchar_translator (ACE_WChar_Codeset_Translator *);
 
-  /*
+  /**
    * Returns (in @a buf) the next position in the buffer aligned to
    * @a size.  It advances the Message_Block @c rd_ptr past the data
    * (i.e., @c buf @c + @c size).  Sets the good_bit to @c false and
@@ -1033,7 +1033,7 @@ private:
   // alignment requirements of CDR streams and implement the
   // operations using asignment.
 
-  /*
+  /**
    * Read an array of @a length elements, each of @a size bytes and the
    * start aligned at a multiple of <align>. The elements are assumed
    * to be packed with the right alignment restrictions.  It is mostly
@@ -1050,7 +1050,7 @@ private:
                                size_t align,
                                ACE_CDR::ULong length);
 
-  /*
+  /**
    * On those occasions when the native codeset for wchar is smaller than
    * the size of a wchar_t, such as using UTF-16 with a 4-byte wchar_t, a
    * special form of reading the array is needed. Actually, this should be
@@ -1068,7 +1068,7 @@ private:
 
 // ****************************************************************
 
-/*
+/**
  * @class ACE_Char_Codeset_Translator
  *
  * @brief Codeset translation routines common to both Output and Input
@@ -1138,7 +1138,7 @@ protected:
                                size_t align,
                                ACE_CDR::ULong length);
 
-  /*
+  /**
    * Efficiently write @a length elements of size @a size from <x> into
    * <output>. Before inserting the elements enough padding is added
    * to ensure that the elements will be aligned to <align> in the
@@ -1150,7 +1150,7 @@ protected:
                                 size_t align,
                                 ACE_CDR::ULong length);
 
-  /*
+  /**
    * Exposes the stream implementation of <adjust>, this is useful in
    * many cases to minimize memory allocations during marshaling.
    * On success @a buf will contain a contiguous area in the CDR stream
@@ -1174,7 +1174,7 @@ protected:
 
 // ****************************************************************
 
-/*
+/**
  * @class ACE_WChar_Codeset_Translator
  *
  * @brief Codeset translation routines common to both Output and Input
@@ -1231,7 +1231,7 @@ protected:
                                size_t align,
                                ACE_CDR::ULong length);
 
-  /*
+  /**
    * Efficiently write @a length elements of size @a size from <x> into
    * <output>. Before inserting the elements enough padding is added
    * to ensure that the elements will be aligned to <align> in the
@@ -1243,7 +1243,7 @@ protected:
                                 size_t align,
                                 ACE_CDR::ULong length);
 
-  /*
+  /**
    * Exposes the stream implementation of <adjust>, this is useful in
    * many cases to minimize memory allocations during marshaling.
    * On success @a buf will contain a contiguous area in the CDR stream

dep/ACE_wrappers/ace/CE_Screen_Output.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    CE_Screen_Output.h
  *
  *  $Id: CE_Screen_Output.h 80826 2008-03-04 14:51:23Z wotte $
@@ -32,7 +32,7 @@ namespace
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_CE_Screen_Output
  *
  * @brief Replacement of text output for Windows CE.
@@ -64,7 +64,7 @@ public:
   void clear (void);
 
   /// Stream insertion operator that performs actual print out.
-  /*
+  /**
    * @note This is the only one operator that performs output.  All
    *       other perators convert the type and use this operator
    *       underneath.

dep/ACE_wrappers/ace/CORBA_macros.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 // ============================================================================
-/*
+/**
  * @file CORBA_macros.h
  *
  * $Id: CORBA_macros.h 91626 2010-09-07 10:59:20Z johnnyw $

dep/ACE_wrappers/ace/Cache_Map_Manager_T.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Cache_Map_Manager_T.h
  *
  *  $Id: Cache_Map_Manager_T.h 92097 2010-09-30 05:41:49Z msmit $
@@ -42,7 +42,7 @@ class ACE_Cache_Map_Reverse_Iterator;
 // For linkers that cant grok long names.
 #define ACE_Cache_Map_Manager ACMM
 
-/*
+/**
  * @class ACE_Cache_Map_Manager
  *
  * @brief Defines a abstraction that will purge entries from a map.
@@ -86,7 +86,7 @@ public:
   typedef REVERSE_ITERATOR
           reverse_iterator;
 
-  /*
+  /**
    * The actual value mapped to the key in the map. The <attributes>
    * are used by the strategy and is transparent to the user of this
    * class.
@@ -112,7 +112,7 @@ public:
   /// Close down a cache and release dynamically allocated resources.
   int close (void);
 
-  /*
+  /**
    * Associate @a key with @a value.  If @a key is already in the CMAP_TYPE
    * then the ENTRY is not changed.  Returns 0 if a new entry is bound
    * successfully, returns 1 if an attempt is made to bind an existing
@@ -121,7 +121,7 @@ public:
   int bind (const KEY &key,
             const VALUE &value);
 
-  /*
+  /**
    * Lookup entry<key,value> in the cache. If it is not found, returns -1.
    * If the @a key is located in the CMAP_TYPE object, the CACHING_STRATEGY is
    * notified of it via notify_find (int result, ATTRIBUTES &attribute).
@@ -131,7 +131,7 @@ public:
   int find (const KEY &key,
             VALUE &value);
 
-  /*
+  /**
    * Lookup entry<key,value> in the cache. If it is not found, returns -1.
    * If the @a key is located in the CMAP_TYPE object, the CACHING_STRATEGY is
    * notified of it via notify_find (int result, ATTRIBUTES &attribute).
@@ -140,7 +140,7 @@ public:
    */
   int find (const KEY &key);
 
-  /*
+  /**
    * Reassociate the @a key with @a value. If the @a key already exists
    * in the cache then returns 1, on a new bind returns 0 and returns
    * -1 in case of any failures.
@@ -148,7 +148,7 @@ public:
   int rebind (const KEY &key,
               const VALUE &value);
 
-  /*
+  /**
    * Reassociate @a key with @a value, storing the old value into the
    * "out" parameter @a old_value.  The function fails if @a key is not
    * in the cache for caches that do not allow user specified keys.
@@ -159,7 +159,7 @@ public:
               const VALUE &value,
               VALUE &old_value);
 
-  /*
+  /**
    * Reassociate @a key with @a value, storing the old key and value
    * into the "out" parameters @a old_key and @a old_value.  The
    * function fails if @a key is not in the cache for caches that do
@@ -172,7 +172,7 @@ public:
               KEY &old_key,
               VALUE &old_value);
 
-  /*
+  /**
    * Associate @a key with @a value if and only if @a key is not in the
    * cache.  If @a key is already in the cache, then the @a value
    * parameter is overwritten with the existing value in the
@@ -235,7 +235,7 @@ private:
 
 };
 
-/*
+/**
  * @class ACE_Cache_Map_Iterator
  *
  * @brief Defines a iterator for the Cache_Map_Manager.
@@ -312,7 +312,7 @@ protected:
   IMPLEMENTATION iterator_implementation_;
 };
 
-/*
+/**
  * @class ACE_Cache_Map_Reverse_Iterator
  *
  * @brief Defines a reverse iterator for the Cache_Map_Manager.

dep/ACE_wrappers/ace/Cached_Connect_Strategy_T.h

@@ -1,7 +1,7 @@
 // -*- C++ -*-
 
 //=============================================================================
-/*
+/**
  *  @file    Cached_Connect_Strategy_T.h
  *
  *  $Id: Cached_Connect_Strategy_T.h 92097 2010-09-30 05:41:49Z msmit $
@@ -32,7 +32,7 @@
 
 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
 
-/*
+/**
  * @class ACE_Cached_Connect_Strategy_Ex
  *
  * @brief A connection strategy which caches connections to peers
@@ -68,7 +68,7 @@ public:
   /// connections purged.
   virtual int mark_as_closed_i (const void *recycling_act);
 
-  /*
+  /**
    * Since g++ version < 2.8 arent happy with templates, this special
    * method had to be devised to avoid memory leaks and perform
    * cleanup of the <connection_cache_>.
@@ -155,7 +155,7 @@ protected:
                                      int perms,
                                      int &found);
 
-  /*
+  /**
    * Connection of the svc_handler with the remote host.  This method
    * also encapsulates the connection done with auto_purging under the
    * hood. If the connect failed due to the process running out of
@@ -181,7 +181,7 @@ protected:
 // For linkers which cant grok long names...
 #define ACE_Bounded_Cached_Connect_Strategy ABCCS
 
-/*
+/**
  * @class ACE_Bounded_Cached_Connect_Strategy
  *
  * @brief