Doc: Fixes in doxygen docs for Draft,Arch, FEM

src/App/PropertyContainer.cpp

@@ -475,6 +475,7 @@ void PropertyData::getPropertyList(OffsetBase offsetBase,std::vector<Property*>
 
 /** \defgroup PropFrame Property framework
     \ingroup APP
+    \brief System to access object properties
 \section Introduction
 The property framework introduces the ability to access attributes (member variables) of a class by name without
 knowing the class type. It's like the reflection mechanism of Java or C#.

src/App/core-app.dox

@@ -1,15 +1,16 @@
 /** \defgroup APP App side
- * \ingroup CORE */
+ * \ingroup CORE 
+ * \brief The part of FreeCAD that works without GUI (console or server mode)
+*/
 
 /** \namespace App
     \ingroup APP
-    \brief The namespace of the FreeCAD Aplication layer library.
+    \brief The FreeCAD Aplication layer
 
     This namespace includes Aplication services of FreeCAD like:
-	- The Application class 
-	- The Document class
+    - The Application class 
+    - The Document class
 
 
-  and so on......
 */
 

src/Base/MemDebug.cpp

@@ -24,6 +24,7 @@
 
 /** \defgroup MemDebug Memory debugging
  *  \ingroup BASE
+ *  \brief Memory debugging tools
  * \section Overview
  * In C++ applications there are a lot of ways to handle memory allocation and deallocation.
  * As many ways to do it wrong or simply forget to free memory. One way to overcome

src/Doc/BuildWebDoc.cfg.in

@@ -493,7 +493,7 @@ SHOW_DIRECTORIES       = YES
 # This will remove the Files entry from the Quick Index and from the
 # Folder Tree View (if specified). The default is YES.
 
-SHOW_FILES             = YES
+SHOW_FILES             = NO
 
 # Set the SHOW_NAMESPACES tag to NO to disable the generation of the
 # Namespaces page.
@@ -962,7 +962,7 @@ TOC_EXPAND             = NO
 # that can be used as input for Qt's qhelpgenerator to generate a
 # Qt Compressed Help (.qch) of the generated HTML documentation.
 
-GENERATE_QHP           = YES
+GENERATE_QHP           = NO
 
 # If the QHG_LOCATION tag is specified, the QCH_FILE tag can
 # be used to specify the file name of the resulting .qch file.

src/Doc/CMakeLists.txt

@@ -43,7 +43,10 @@ if(DOXYGEN_FOUND)
     set(        DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/Tools)
     list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/3rdParty/CxImage)
     list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/3rdParty/salomesmesh)
+    # deprecated modules
     list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/Mod/Assembly)
+    list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/Mod/Cam)
+    list(APPEND DOXYGEN_EXCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/Mod/Complete)
 
     STRING(REGEX REPLACE ";" " " DOXYGEN_EXCLUDE_LIST "${DOXYGEN_EXCLUDE_DIR}")
 

src/Doc/mainpage.dox

@@ -31,7 +31,7 @@
     components of the FreeCAD source code, for both the parts written in C++ and Python. 
     
     For general help and documentation about the FreeCAD application and how to use it, head
-    to the <a href=http//www.freecadweb.org/wiki>Wiki Documentation</a> instead.
+    first to the <a href=http//www.freecadweb.org/wiki>Wiki Documentation</a>.
     
     Refer to the
     <a href=http://www.freecadweb.org/wiki/index.php?title=The_FreeCAD_source_code>general 

src/Doc/primary-groups.dox

@@ -2,7 +2,8 @@
     This is the core functionality of FreeCAD.
 
     It groups the Base classes, and the main components of freecad core,
-    spread over their App and Gui sides
+    spread over their App and Gui sides. Core components are programmed in
+    C++ but provide a broad Python API.
  */
 
 /** \defgroup WORKBENCHES Workbenches

src/Doc/templates/doxy-boot.js

@@ -155,7 +155,6 @@ $( document ).ready(function() {
     return document.getElementById("search-close");
   }
 
-
   /* search results */
   var results_iframe = $('#MSearchResults').detach();
   $('#MSearchResultsWindow')
@@ -269,3 +268,93 @@ $( document ).ready(function() {
 	});
   searchBox.CloseResultsWindow();
 });
+
+// contents of dynsections.js which seems to be missing from std doxygen js files...
+function toggleVisibility(linkObj)
+{
+ var base = $(linkObj).attr('id');
+ var summary = $('#'+base+'-summary');
+ var content = $('#'+base+'-content');
+ var trigger = $('#'+base+'-trigger');
+ var src=$(trigger).attr('src');
+ if (content.is(':visible')===true) {
+   content.hide();
+   summary.show();
+   $(linkObj).addClass('closed').removeClass('opened');
+   $(trigger).attr('src',src.substring(0,src.length-8)+'closed.png');
+ } else {
+   content.show();
+   summary.hide();
+   $(linkObj).removeClass('closed').addClass('opened');
+   $(trigger).attr('src',src.substring(0,src.length-10)+'open.png');
+ } 
+ return false;
+}
+function updateStripes()
+{
+  $('table.directory tr').
+       removeClass('even').filter(':visible:even').addClass('even');
+}
+function toggleLevel(level)
+{
+  $('table.directory tr').each(function(){ 
+    var l = this.id.split('_').length-1;
+    var i = $('#img'+this.id.substring(3));
+    var a = $('#arr'+this.id.substring(3));
+    if (l<level+1) {
+      i.attr('src','ftv2folderopen.png');
+      a.attr('src','ftv2mnode.png');
+      $(this).show();
+    } else if (l==level+1) {
+      i.attr('src','ftv2folderclosed.png');
+      a.attr('src','ftv2pnode.png');
+      $(this).show();
+    } else {
+      $(this).hide();
+    }
+  });
+  updateStripes();
+}
+function toggleFolder(id)
+{
+  //The clicked row
+  var currentRow = $('#row_'+id);
+  var currentRowImages = currentRow.find("img");
+  //All rows after the clicked row
+  var rows = currentRow.nextAll("tr");
+  //Only match elements AFTER this one (can't hide elements before)
+  var childRows = rows.filter(function() {
+    var re = new RegExp('^row_'+id+'\\d+_$', "i"); //only one sub
+    return this.id.match(re);
+  });
+  //First row is visible we are HIDING
+  if (childRows.filter(':first').is(':visible')===true) {
+    currentRowImages.filter("[id^=arr]").attr('src', 'ftv2pnode.png');
+    currentRowImages.filter("[id^=img]").attr('src', 'ftv2folderclosed.png');
+    rows.filter("[id^=row_"+id+"]").hide();
+  } else { //We are SHOWING
+    //All sub images
+    var childImages = childRows.find("img");
+    var childImg = childImages.filter("[id^=img]");
+    var childArr = childImages.filter("[id^=arr]");
+    currentRow.find("[id^=arr]").attr('src', 'ftv2mnode.png'); //open row
+    currentRow.find("[id^=img]").attr('src', 'ftv2folderopen.png'); //open row
+    childImg.attr('src','ftv2folderclosed.png'); //children closed
+    childArr.attr('src','ftv2pnode.png'); //children closed
+    childRows.show(); //show all children
+  }
+  updateStripes();
+}
+function toggleInherit(id)
+{
+  var rows = $('tr.inherit.'+id);
+  var img = $('tr.inherit_header.'+id+' img');
+  var src = $(img).attr('src');
+  if (rows.filter(':first').is(':visible')===true) {
+    rows.css('display','none');
+    $(img).attr('src',src.substring(0,src.length-8)+'closed.png');
+  } else {
+    rows.css('display','table-row'); // using show() causes jump in firefox
+    $(img).attr('src',src.substring(0,src.length-10)+'open.png');
+  }
+}

src/Doc/templates/header.html

@@ -9,7 +9,7 @@
         <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
         <meta name="generator" content="Doxygen $doxygenversion"/>
         
-        <script type="text/javascript" src="https://www.freecadweb.org/js/jquery-2.1.4.min.js"></script>
+        <script type="text/javascript" src="http://www.freecadweb.org/js/jquery-2.1.4.min.js"></script>
 
         <!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
         <!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
@@ -45,7 +45,7 @@
                         <li><a href="/api/index.html" title="Welcome page">API Home</a></li>
                         <li><a href="modules.html" title="List of FreeCAD Modules">Modules</a></li>
                         <!-- <li><a href="namespaces.html" title="Namespaces">Namespaces</a></li> -->
-                        <li><a href="annotated.html" title="List of namespaces and classes">Namespaces and Classes</a></li>
+                        <li><a href="annotated.html" title="List of namespaces and classes">Class list</a></li>
                         <li><a href="https://github.com/FreeCAD/FreeCAD" title="Browse the source code on GitHub">Source code</a></li>
                     </ul>
                     <ul class="nav navbar-nav navbar-right">

src/Gui/Command.cpp

@@ -68,6 +68,7 @@ using namespace Gui::DockWnd;
 
 /** \defgroup commands Command Framework
     \ingroup GUI
+    \brief Structure for registering commands to the FreeCAD system
  * \section Overview
  * In GUI applications many commands can be invoked via a menu item, a toolbar button or an accelerator key. The answer of Qt to master this
  * challenge is the class \a QAction. A QAction object can be added to a popup menu or a toolbar and keep the state of the menu item and

src/Gui/core-gui.dox

@@ -1,8 +1,10 @@
 /** \defgroup GUI Gui side
- * \ingroup CORE */
+ * \ingroup CORE 
+ * \brief The Graphical User Interface of FreeCAD and the 3D View
+ */
 
 /** \namespace Gui
-    \brief The namespace of the FreeCAD Graphical interface layer library.
+    \brief The FreeCAD Graphical interface layer
 
     This namespace includes the grafical interface of FreeCAD like:
 	- The main window

src/Main/core-main.dox

@@ -1,2 +1,4 @@
 /** \defgroup MAIN Global application level 
- * \ingroup CORE */
+ * \ingroup CORE 
+ * \brief The Main classes define general application settings
+ */

src/Mod/Arch/Arch.py

@@ -26,11 +26,12 @@ __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
 
 ## \defgroup ARCH Arch
-#  \ingroup WORKBENCHES
-#
-#  Architecture and BIM module
+#  \ingroup PYTHONWORKBENCHES
+#  \brief Architecture and BIM tools
 #
 #  This module provides tools specialized in Building Information Modeling (BIM).
+#  such as convenience tools to build walls, windows or structures, and 
+#  IFC import/export capabilities.
 
 '''The Arch module provides tools specialized in BIM modeling.'''
 

src/Mod/Arch/ArchAxis.py

@@ -30,15 +30,24 @@ if FreeCAD.GuiUp:
     from pivy import coin
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
 
 __title__="FreeCAD Axis System"
 __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
 
+## @package ArchAxis
+#  \ingroup ARCH
+#  \brief Axis system for the Arch workbench
+#
+#  This module provides tools to build axis systems
+#  An axis system is a collection of planar axes with a number/tag
+
 def makeAxis(num=5,size=1000,name="Axes"):
     '''makeAxis(num,size): makes an Axis System
     based on the given number of axes and interval distances'''

src/Mod/Arch/ArchBuilding.py

@@ -30,15 +30,24 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
 
 __title__="FreeCAD Building"
 __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
 
+## @package ArchBuilding
+#  \ingroup ARCH
+#  \brief Building object and tools
+#
+#  This module provides tools to build building objects.
+#  Buildings are primarily containers for Arch objects
+
 BuildingTypes = ['Undefined',
 'Agricultural - Barn',
 'Agricultural - Chicken coop or chickenhouse',

src/Mod/Arch/ArchCommands.py

@@ -30,13 +30,22 @@ if FreeCAD.GuiUp:
     from PySide import QtGui,QtCore
     from DraftTools import translate
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
+    # \endcond
 
 __title__="FreeCAD Arch Commands"
 __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
 
+## @package ArchCommands
+#  \ingroup ARCH
+#  \brief Utility functions for theArch Workbench
+#
+#  This module provides general functions used by Arch tools
+#  and utility commands
+
 # module functions ###############################################
 
 def getStringList(objects):

src/Mod/Arch/ArchComponent.py

@@ -39,11 +39,19 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
 
+## @package ArchComponent
+#  \ingroup ARCH
+#  \brief The base class of all Arch objects
+#
+#  This module provides the base Arch component class, that
+#  is shared by all of the Arch BIM objects
 
 def addToComponent(compobject,addobject,mod=None):
     '''addToComponent(compobject,addobject,mod): adds addobject

src/Mod/Arch/ArchCutPlane.py

@@ -28,13 +28,21 @@ if FreeCAD.GuiUp:
     from PySide import QtCore, QtGui
     from DraftTools import translate
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
+    # \endcond
 
 __title__="FreeCAD CutPlane"
 __author__ = "Jonathan Wiedemann"
 __url__ = "http://www.freecadweb.org"
 
+## @package ArchCutPlane
+#  \ingroup ARCH
+#  \brief The Cut plane object and tools
+#
+#  This module handles the Cut Plane object
+
 def cutComponentwithPlane(archObject, cutPlane, sideFace):
     """cut object from a plan define by a face, Behind = 0 , front = 1"""
     cutVolume = ArchCommands.getCutVolume(cutPlane, archObject.Object.Shape)

src/Mod/Arch/ArchEquipment.py

@@ -35,10 +35,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+
+## @package ArchEquipment
+#  \ingroup ARCH
+#  \brief The Equipment object and tools
+#
+#  This module provides tools to build equipment objects.
+#  Equipments are used to represent furniture and all kinds of electrical
+#  or hydraulic appliances in a building
 
 # presets
 Roles = ["Furniture", "Hydro Equipment", "Electric Equipment"]

src/Mod/Arch/ArchFloor.py

@@ -30,10 +30,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchFloor
+#  \ingroup ARCH
+#  \brief The Floor object and tools
+#
+#  This module provides tools to build Floor objects.
+#  Floors are used to group different Arch objects situated
+#  at a same level
 
 __title__="FreeCAD Arch Floor"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchFrame.py

@@ -29,10 +29,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchFrame
+#  \ingroup ARCH
+#  \brief The Frame object and tools
+#
+#  This module provides tools to build Frame objects.
+#  Frames are objects made of a profile and an object with
+#  edges along which the profile gets extruded
 
 __title__="FreeCAD Arch Frame"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchMaterial.py

@@ -29,7 +29,13 @@ if FreeCAD.GuiUp:
 __title__ = "Arch Material Managment"
 __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
-
+    
+## @package ArchMaterial
+#  \ingroup ARCH
+#  \brief The Material object and tools
+#
+#  This module provides tools to add materials to
+#  Arch objects
 
 def makeMaterial(name="Material"):
     '''makeMaterial(name): makes an Material object'''

src/Mod/Arch/ArchPanel.py

@@ -29,10 +29,21 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchPanel
+#  \ingroup ARCH
+#  \brief The Panel object and tools
+#
+#  This module provides tools to build Panel objects.
+#  Panels consist of a closed shape that gets extruded to
+#  produce a flat object.
+
 
 __title__="FreeCAD Panel"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchPipe.py

@@ -29,10 +29,19 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchPipe
+#  \ingroup ARCH
+#  \brief The Pipe object and tools
+#
+#  This module provides tools to build Pipe and Pipe conector objects.
+#  Pipes are tubular objects extruded along a base line.
 
 __title__ = "Arch Pipe tools"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchPrecast.py

@@ -35,11 +35,19 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
-
+    # \endcond
+    
+## @package ArchPrecast
+#  \ingroup ARCH
+#  \brief Precast options for ArchStructure
+#
+#  This module provides additional presets for the Arch Structure
+#  tool, to build a series of precast concrete elements
 
 class _Precast(ArchComponent.Component):
 

src/Mod/Arch/ArchProfile.py

@@ -31,10 +31,19 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+
+## @package ArchProfile
+#  \ingroup ARCH
+#  \brief Profile tools for ArchStructure
+#
+#  This module provides tools to build base profiles
+#  for Arch Strucutre elements
 
 __title__="FreeCAD Profile"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchRebar.py

@@ -29,10 +29,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchRebar
+#  \ingroup ARCH
+#  \brief The Rebar object and tools
+#
+#  This module provides tools to build Rebar objects.
+#  Rebars (or Reinforcing Bars) are metallic bars placed
+#  inside concrete strutures to reinforce them.
 
 __title__="FreeCAD Rebar"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchRoof.py

@@ -29,10 +29,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchRoof
+#  \ingroup ARCH
+#  \brief The Roof object and tools
+#
+#  This module provides tools to build Roof objects.
+#  Roofs are build from a closed contour and a series of
+#  slopes.
 
 __title__="FreeCAD Roof"
 __author__ = "Yorik van Havre", "Jonathan Wiedemann"

src/Mod/Arch/ArchSchedule.py

@@ -29,10 +29,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchSchedule
+#  \ingroup ARCH
+#  \brief The Schedule object and tools
+#
+#  This module provides tools to build Schedule objects.
+#  Schedules are objects that can count and gather information
+#  about objects in the document, and fill a spreadsheet with the result
 
 __title__ = "Arch Schedule"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchSectionPlane.py

@@ -30,11 +30,20 @@ if FreeCAD.GuiUp:
     from pivy import coin
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
-
+    # \endcond
+    
+## @package ArchSectionPlane
+#  \ingroup ARCH
+#  \brief The Section plane object and tools
+#
+#  This module provides tools to build Section plane objects.
+#  It also contains functionality to produce SVG rendering of
+#  section planes, to be used in TechDraw and Drawing modules
 
 def makeSectionPlane(objectslist=None,name="Section"):
     """makeSectionPlane([objectslist]) : Creates a Section plane objects including the

src/Mod/Arch/ArchServer.py

@@ -29,10 +29,19 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchServer
+#  \ingroup ARCH
+#  \brief The Server object and tools
+#
+#  This module provides utility functions to connect with
+#  online or local servers like BimServer or GIT
 
 __title__="FreeCAD Arch Server commands"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchSite.py

@@ -30,10 +30,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchSite
+#  \ingroup ARCH
+#  \brief The Site object and tools
+#
+#  This module provides tools to build Site objects.
+#  Sites are containers for Arch objects, and also define a
+#  terrain surface
 
 __title__="FreeCAD Site"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchSpace.py

@@ -157,10 +157,20 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchSpace
+#  \ingroup ARCH
+#  \brief The Space object and tools
+#
+#  This module provides tools to build Space objects.
+#  Spaces define an open volume inside or outside a
+#  building, ie. a room.
 
 def makeSpace(objects=None,baseobj=None,name="Space"):
     """makeSpace([objects]): Creates a space object from the given objects. Objects can be one

src/Mod/Arch/ArchStairs.py

@@ -33,11 +33,18 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
-
+    # \endcond
+    
+## @package ArchStairs
+#  \ingroup ARCH
+#  \brief The Stairs object and tools
+#
+#  This module provides tools to build Stairs objects.
 
 def makeStairs(baseobj=None,length=None,width=None,height=None,steps=None,name="Stairs"):
     """makeStairs([baseobj,length,width,height,steps]): creates a Stairs

src/Mod/Arch/ArchStructure.py

@@ -32,10 +32,21 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchStructure
+#  \ingroup ARCH
+#  \brief The Structure object and tools
+#
+#  This module provides tools to build Structure objects.
+#  Structure elements are beams, columns, slabs, and other
+#  elements that have a structural function, that is, that
+#  support other parts of the building.
 
 __title__="FreeCAD Structure"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchVRM.py

@@ -25,6 +25,15 @@
 
 import FreeCAD,math,Part,ArchCommands,DraftVecUtils,DraftGeomUtils
 
+## @package ArchVRM
+#  \ingroup ARCH
+#  \brief The Arch Vector Rendering Module
+#
+#  This module provides the Renderer Class, that allows to
+#  produce SVG renderings of projected shapes, with filled faces.
+#  It is used by the "Solid" mode of Arch views in TechDraw and Drawing,
+#  and is called from ArchSectionPlane code.
+
 MAXLOOP = 10 # the max number of loop before abort
 
 # WARNING: in this module, faces are lists whose first item is the actual OCC face, the

src/Mod/Arch/ArchWall.py

@@ -29,10 +29,21 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchWall
+#  \ingroup ARCH
+#  \brief The Wall object and tools
+#
+#  This module provides tools to build Wall objects.
+#  Walls are simple objects, usually vertical, obtained
+#  by giving a thickness to a base line, then extruding it
+#  vertically.
 
 __title__="FreeCAD Wall"
 __author__ = "Yorik van Havre"

src/Mod/Arch/ArchWindow.py

@@ -29,10 +29,21 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
     from PySide.QtCore import QT_TRANSLATE_NOOP
 else:
+    # \cond
     def translate(ctxt,txt):
         return txt
     def QT_TRANSLATE_NOOP(ctxt,txt):
         return txt
+    # \endcond
+    
+## @package ArchWindow
+#  \ingroup ARCH
+#  \brief The Window object and tools
+#
+#  This module provides tools to build Window objects.
+#  Windows are Arch objects obtained by extruding a series
+#  of wires, and that can be inserted into other Arch objects,
+#  by defining a volume that gets subtracted from them.
 
 __title__="FreeCAD Window"
 __author__ = "Yorik van Havre"

src/Mod/Arch/arch.dox

@@ -1,3 +1,3 @@
 /** \defgroup ARCH Arch
- *  \ingroup WORKBENCHES */
+ *  \ingroup PYTHONWORKBENCHES */
 

src/Mod/Arch/import3DS.py

@@ -28,6 +28,11 @@ __url__ = "http://www.freecadweb.org"
 
 DEBUG = True
 
+## @package import3DS
+#  \ingroup ARCH
+#  \brief 3DS file format importer
+#
+#  This module provides tools to import 3DS files.
 
 def check3DS():
     "checks if collada if available"

src/Mod/Arch/importDAE.py

@@ -25,8 +25,16 @@ import FreeCAD, Mesh, os, numpy, MeshPart, Arch, Draft
 if FreeCAD.GuiUp:
     from DraftTools import translate
 else:
+    # \cond
     def translate(context,text):
         return text
+    # \endcond
+
+## @package importDAE
+#  \ingroup ARCH
+#  \brief DAE (Collada) file format importer and exporter
+#
+#  This module provides tools to import and export Collada (.dae) files.
 
 __title__="FreeCAD Collada importer"
 __author__ = "Yorik van Havre"

src/Mod/Arch/importGBXML.py

@@ -30,9 +30,16 @@ import os,FreeCAD,Draft
 if FreeCAD.GuiUp:
     from DraftTools import translate
 else:
+    # \cond
     def translate(ctx,txt):
         return txt
-
+    # \endcond
+        
+## @package importGBXML
+#  \ingroup ARCH
+#  \brief GBXML file format exporter
+#
+#  This module provides tools to export GBXML files.
     
 def export(objectslist,filename):
     

src/Mod/Arch/importIFC.py

@@ -27,6 +27,12 @@ __url__ =    "http://www.freecadweb.org"
 
 import os,time,tempfile,uuid,FreeCAD,Part,Draft,Arch,math,DraftVecUtils
 
+## @package importIFC
+#  \ingroup ARCH
+#  \brief IFC file format importer and exporter
+#
+#  This module provides tools to import and export IFC files.
+
 DEBUG = False
 
 if open.__module__ == '__builtin__':

src/Mod/Arch/importOBJ.py

@@ -25,8 +25,18 @@ import FreeCAD, DraftGeomUtils, Part, Draft, Arch
 if FreeCAD.GuiUp:
     from DraftTools import translate
 else:
+    # \cond
     def translate(context,text):
         return text
+    # \endcond
+
+## @package importOBJ
+#  \ingroup ARCH
+#  \brief OBJ file format importer and exporter
+#
+#  This module provides tools to import and export OBJ files.
+#  It is an alternative tothe standard Mesh OBJ importer/exporter
+#  and supports exporting faces with more than 3 vertices.
 
 p = Draft.precision()
 

src/Mod/Arch/importSH3D.py

@@ -26,6 +26,12 @@ __url__ =    "http://www.freecadweb.org"
 
 import os,zipfile,xml.sax,FreeCAD,Part,Draft,Arch,Mesh,tempfile,math,Sketcher
 
+## @package importSH3D
+#  \ingroup ARCH
+#  \brief SH3D (SweetHome3D) file format importer
+#
+#  This module provides tools to import SH3D files created from Sweet Home 3D.
+
 DEBUG = True
 
 if open.__module__ == '__builtin__':

src/Mod/Arch/importWebGL.py

@@ -35,8 +35,17 @@ if FreeCAD.GuiUp:
     from DraftTools import translate
 else:
     FreeCADGui = None
+    # \cond
     def translate(ctxt,txt):
         return txt
+    # \endcond
+
+## @package importWebGL
+#  \ingroup ARCH
+#  \brief WebGL file format exporter
+#
+#  This module provides tools to export HTML files containing the 
+#  exported objects in WebGL format and a simple three.js-based viewer.
 
 tab = "                " # the tab size
 wireframeStyle = "faceloop" # this can be "faceloop", "multimaterial" or None

src/Mod/Draft/Draft.py

@@ -42,6 +42,7 @@ __url__ = "http://www.freecadweb.org"
 #  FreeCAD interface, and corresponding python functions, that can perform the same
 #  operation programmatically.
 #
+#  @{
 
 '''The Draft module offers a range of tools to create and manipulate basic 2D objects'''
 
@@ -5864,3 +5865,5 @@ class _ViewProviderVisGroup:
                                     # touch the page if something was changed
                                     if vobj.Object.InList[0].isDerivedFrom("Drawing::FeaturePage"):
                                         vobj.Object.InList[0].touch()
+
+# @}

src/Mod/Draft/DraftGeomUtils.py

@@ -30,6 +30,9 @@ __url__ = ["http://www.freecadweb.org"]
 #
 # Shapes manipulation utilities
 
+## \addtogroup DRAFTGEOMUTILS
+#  @{
+
 "this file contains generic geometry functions for manipulating Part shapes"
 
 import FreeCAD, Part, DraftVecUtils, math, cmath
@@ -2792,3 +2795,4 @@ def circleInversion(circle, circle2):
         FreeCAD.Console.PrintMessage("debug: circleInversion bad parameters!\n")
         return None
 
+#  @}

src/Mod/Draft/DraftGui.py

@@ -26,10 +26,13 @@ __title__="FreeCAD Draft Workbench - GUI part"
 __author__ = "Yorik van Havre <yorik@uncreated.net>"
 __url__ = ["http://www.freecadweb.org"]
 
-## \defgroup DRAFTGUI DraftGui
+## @package DraftGui
 #  \ingroup DRAFT
+#  \brief GUI elements and utilities of the Draft workbench
 #
-# GUI elements and utilities of the Draft workbench
+#  This module provides GUI tools for the Draft workbench, such as
+#  toolbars and task panels, and Qt-dependent utilities such as 
+#  a delayed (todo) commit system
 
 '''
 This is the GUI part of the Draft module.

src/Mod/Draft/DraftSnap.py

@@ -25,6 +25,12 @@ __title__="FreeCAD Draft Snap tools"
 __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
 
+## @package DraftSnap
+#  \ingroup DRAFT
+#  \brief Snapping system used by Draft & Arch workbenches
+#
+#  This module provides tools to handle point snapping and
+#  everything that goes with it (toolbar buttons, cursor icons, etc)
 
 import FreeCAD, FreeCADGui, math, Draft, DraftGui, DraftTrackers, DraftVecUtils
 from FreeCAD import Vector

src/Mod/Draft/DraftTools.py

@@ -27,10 +27,12 @@ __title__="FreeCAD Draft Workbench GUI Tools"
 __author__ = "Yorik van Havre, Werner Mayer, Martin Burbaum, Ken Cline, Dmitry Chigrin"
 __url__ = "http://www.freecadweb.org"
 
-## \defgroup DRAFTTOOLS DraftTools
+## @package DraftTools
 #  \ingroup DRAFT
+#  \brief GUI Commands of the Draft workbench
 #
-# GUI Commands of the Draft workbench
+#  This module contains all the FreeCAD commands
+#  of the Draft module
 
 #---------------------------------------------------------------------------
 # Generic stuff

src/Mod/Draft/DraftTrackers.py

@@ -25,10 +25,9 @@ __title__="FreeCAD Draft Trackers"
 __author__ = "Yorik van Havre"
 __url__ = "http://www.freecadweb.org"
 
-## \defgroup DRAFTTRACKERS DraftTrackers
+## @package DraftTrackers
 #  \ingroup DRAFT
-#
-# Custom Pivy-based objects used by the Draft workbench
+#  \brief Custom Pivy-based objects used by the Draft workbench
 #
 # This module contains a collection of Coin3D (pivy)-based objects
 # that are used by the Draft workbench to draw temporary geometry

src/Mod/Draft/DraftVecUtils.py

@@ -32,6 +32,9 @@ __url__ = ["http://www.freecadweb.org"]
 #
 # Vector math utilities
 
+## \addtogroup DRAFTVECUTILS
+#  @{
+
 import math,FreeCAD
 from FreeCAD import Vector, Matrix
 
@@ -247,3 +250,5 @@ def removeDoubles(vlist):
             nlist.append(vlist[i])
     nlist.append(vlist[-1])
     return nlist
+
+#  @}

src/Mod/Draft/WorkingPlane.py

@@ -29,6 +29,13 @@ __title__="FreeCAD Working Plane utility"
 __author__ = "Ken Cline"
 __url__ = "http://www.freecadweb.org"
 
+## @package WorkingPlane
+#  \ingroup DRAFT
+#  \brief This module handles the Working Plane and grid of the Draft module.
+#
+#  This module contains the plane class which provides a virtual plane in FreeCAD
+#  and a couple of utility functions
+
 '''
 This module provides a class called plane to assist in selecting and maintaining a working plane.
 '''

src/Mod/Draft/draft.dox

@@ -1,3 +1,5 @@
 /** \defgroup DRAFT Draft
- *  \ingroup WORKBENCHES */
+ *  \ingroup PYTHONWORKBENCHES 
+ *  \brief Basic 2D drawing tools and other generic tools 
+ */
 

src/Mod/Draft/importAirfoilDAT.py

@@ -24,6 +24,12 @@
 __title__="FreeCAD Draft Workbench - Airfoil data importer"
 __author__ = "Heiko Jakob <heiko.jakob@gediegos.de>"
 
+## @package importAirfoilDAT
+#  \ingroup DRAFT
+#  \brief Airfoil (.dat) file importer
+#
+# This module provides support for importing airfoil .dat files
+
 import re, FreeCAD, FreeCADGui, Part, cProfile, os, string
 from FreeCAD import Vector, Base
 from Draft import makeWire

src/Mod/Draft/importDWG.py

@@ -24,6 +24,14 @@
 
 "FreeCAD Draft Workbench - DWG importer/exporter"
 
+## @package importDWG
+#  \ingroup DRAFT
+#  \brief DWG file importer & exporter
+#
+#  This module provides support for importing and exporting Autodesk DWG files.
+#  This module is only a thin layer that uses the Teigha Converter application
+#  to convert to/from DXF. Then the real work is done by importDXF
+
 if open.__module__ == '__builtin__':
     pythonopen = open # to distinguish python built-in open function from the one declared here
 

src/Mod/Draft/importDXF.py

@@ -26,6 +26,12 @@ __title__="FreeCAD Draft Workbench - DXF importer/exporter"
 __author__ = "Yorik van Havre <yorik@uncreated.net>"
 __url__ = ["http://www.freecadweb.org"]
 
+## @package importDXF
+#  \ingroup DRAFT
+#  \brief DXF file importer & exporter
+#
+# This module provides support for importing and exporting Autodesk DXF files
+
 '''
 This script uses a DXF-parsing library created by Stani,
 Kitsu and Migius for Blender

src/Mod/Draft/importOCA.py

@@ -26,6 +26,14 @@ __title__="FreeCAD Draft Workbench - OCA importer/exporter"
 __author__ = "Yorik van Havre <yorik@uncreated.net>"
 __url__ = ["http://www.freecadweb.org"]
 
+## @package importOCA
+#  \ingroup DRAFT
+#  \brief OCA (Open CAD Format) file import & export
+#
+#  This module provides support for importing and exporting to the OCA format fron GCAD3D.
+#  Warning, this file format is today practically obsolete and this module is not
+#  maintained anymore.
+
 '''
 This script imports OCA/gcad files into FreeCAD.
 '''

src/Mod/Draft/importSVG.py

@@ -25,6 +25,14 @@ __title__="FreeCAD Draft Workbench - SVG importer/exporter"
 __author__ = "Yorik van Havre, Sebastian Hoogen"
 __url__ = ["http://www.freecadweb.org"]
 
+## @package importSVG
+#  \ingroup DRAFT
+#  \brief SVG file importer & exporter
+#
+#  This module provides support for importing and exporting SVG files. It
+#  enables importing/exporting objects directly to/from the 3D document, but
+#  doesn't handle the SVG output from the Drawng and TechDraw modules.
+
 '''
 This script imports SVG files in FreeCAD. Currently only reads the following entities:
 paths, lines, circular arcs ,rects, circles, ellipses, polygons, polylines.

src/Mod/Drawing/drawing.dox

@@ -1,3 +1,5 @@
 /** \defgroup DRAWING Drawing
- *  \ingroup WORKBENCHES */
+ *  \ingroup CWORKBENCHES 
+ *  \brief Manages output of 2D sheets from FreeCAD documents
+ */
 

src/Mod/Fem/FemAnalysis.py

@@ -26,8 +26,12 @@ __title__ = "FEM Analysis managment"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## \addtogroup FEM
+#  @{
 
 def makeFemAnalysis(name):
     '''makeFemAnalysis(name): makes a Fem Analysis object'''
     obj = FreeCAD.ActiveDocument.addObject("Fem::FemAnalysisPython", name)
     return obj
+
+# @}

src/Mod/Fem/FemBeamSection.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import _FemBeamSection
 
+## \addtogroup FEM
+#  @{
 
 def makeFemBeamSection(width=20.0, height=20.0, name="BeamSection"):
     '''makeFemBeamSection([width], [height], [name]): creates an beamsection object to define a cross section'''
@@ -39,3 +41,5 @@ def makeFemBeamSection(width=20.0, height=20.0, name="BeamSection"):
         import _ViewProviderFemBeamSection
         _ViewProviderFemBeamSection._ViewProviderFemBeamSection(obj.ViewObject)
     return obj
+
+#  @}

src/Mod/Fem/FemCommands.py

@@ -32,6 +32,8 @@ if FreeCAD.GuiUp:
     import FemGui
     from PySide import QtCore
 
+## \addtogroup FEM
+#  @{
 
 class FemCommands(object):
         def __init__(self):
@@ -135,3 +137,5 @@ class FemCommands(object):
                             if aparttoshow == apart.Name:
                                 apart.ViewObject.Visibility = True
                         acnstrmesh.ViewObject.Visibility = False  # OvG: Hide meshes and show constraints and meshed part e.g. on purging results
+
+#  @}

src/Mod/Fem/FemConstraintSelfWeight.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import _FemConstraintSelfWeight
 
+## \addtogroup FEM
+#  @{
 
 def makeFemConstraintSelfWeight(name="FemConstraintSelfWeight"):
     '''makeFemFemConstraintSelfWeight([name]): creates an self weight object to define a gravity load'''
@@ -37,3 +39,5 @@ def makeFemConstraintSelfWeight(name="FemConstraintSelfWeight"):
         import _ViewProviderFemConstraintSelfWeight
         _ViewProviderFemConstraintSelfWeight._ViewProviderFemConstraintSelfWeight(obj.ViewObject)
     return obj
+
+#  @}

src/Mod/Fem/FemInputWriter.py

@@ -39,6 +39,8 @@ import FreeCAD
 import FemMeshTools
 import os
 
+## \addtogroup FEM
+#  @{
 
 class FemInputWriter():
     def __init__(self,
@@ -161,3 +163,5 @@ class FemInputWriter():
         for femobj in self.pressure_objects:  # femobj --> dict, FreeCAD document object is femobj['Object']
             femobj['PressureFaces'] = FemMeshTools.get_pressure_obj_faces(self.femmesh, femobj)
             # print femobj['PressureFaces']
+
+#  @}

src/Mod/Fem/FemInputWriterCcx.py

@@ -34,6 +34,8 @@ import time
 import FemMeshTools
 import FemInputWriter
 
+## \addtogroup FEM
+#  @{
 
 class FemInputWriterCcx(FemInputWriter.FemInputWriter):
     def __init__(self,
@@ -1057,3 +1059,5 @@ def get_ccx_elset_solid_name(mat_name, solid_name=None, mat_short_name=None):
         return mat_short_name + solid_name
     else:
         return mat_name + solid_name
+
+#  @}

src/Mod/Fem/FemInputWriterZ88.py

@@ -31,6 +31,8 @@ import FemMeshTools
 import importZ88Mesh
 import FemInputWriter
 
+## \addtogroup FEM
+#  @{
 
 class FemInputWriterZ88(FemInputWriter.FemInputWriter):
     def __init__(self,
@@ -317,3 +319,5 @@ Entries for Cuthill-McKee Z88H         Daten fuer Cuthill- McKee Programm
 
 DYNAMIC END
 '''
+
+#  @}

src/Mod/Fem/FemMaterialMechanicalNonlinear.py

@@ -29,6 +29,8 @@ import FreeCAD
 import FemGui
 import _FemMaterialMechanicalNonlinear
 
+## \addtogroup FEM
+#  @{
 
 def makeFemMaterialMechanicalNonlinear(base_material, name="MechanicalMaterialNonlinear"):
     '''makeFemMaterialMechanicalNonlinear(base_material, [name]): creates an nonlinear material object'''
@@ -39,3 +41,5 @@ def makeFemMaterialMechanicalNonlinear(base_material, name="MechanicalMaterialNo
         import _ViewProviderFemMaterialMechanicalNonlinear
         _ViewProviderFemMaterialMechanicalNonlinear._ViewProviderFemMaterialMechanicalNonlinear(obj.ViewObject)
     return obj
+
+# @}

src/Mod/Fem/FemMeshTools.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 
 import FreeCAD
 
+## \addtogroup FEM
+#  @{
 
 def get_femnodes_by_femobj_with_references(femmesh, femobj):
     node_set = []
@@ -1260,3 +1262,5 @@ def make_femmesh(mesh_data):
     else:
         FreeCAD.Console.PrintError("No Nodes found!\n")
     return mesh
+
+#  @}

src/Mod/Fem/FemSelectionObserver.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import FreeCADGui
 
+## \addtogroup FEM
+#  @{
 
 class FemSelectionObserver:
     '''FemSelectionObserver'''
@@ -41,3 +43,5 @@ class FemSelectionObserver:
         self.added_obj = (selected_object, sub)
         # on double click on a vertex of a solid sub is None and obj is the solid
         self.parseSelectionFunction(self.added_obj)
+
+#  @}

src/Mod/Fem/FemShellThickness.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import _FemShellThickness
 
+## \addtogroup FEM
+#  @{
 
 def makeFemShellThickness(thickness=20.0, name="ShellThickness"):
     '''makeFemShellThickness([thickness], [name]): creates an shellthickness object to define a plate thickness'''
@@ -38,3 +40,5 @@ def makeFemShellThickness(thickness=20.0, name="ShellThickness"):
         import _ViewProviderFemShellThickness
         _ViewProviderFemShellThickness._ViewProviderFemShellThickness(obj.ViewObject)
     return obj
+
+#  @}

src/Mod/Fem/FemSolverCalculix.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import _FemSolverCalculix
 
+## \addtogroup FEM
+#  @{
 
 def makeFemSolverCalculix(name="CalculiX"):
     '''makeSolverCalculix(name): makes a Calculix solver object'''
@@ -37,3 +39,5 @@ def makeFemSolverCalculix(name="CalculiX"):
         import _ViewProviderFemSolverCalculix
         _ViewProviderFemSolverCalculix._ViewProviderFemSolverCalculix(obj.ViewObject)
     return obj
+
+#  @}

src/Mod/Fem/FemSolverZ88.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import _FemSolverZ88
 
+## \addtogroup FEM
+#  @{
 
 def makeFemSolverZ88(name="Z88"):
     '''makeSolverZ88(name): makes a Z88 solver object'''
@@ -37,3 +39,5 @@ def makeFemSolverZ88(name="Z88"):
         import _ViewProviderFemSolverZ88
         _ViewProviderFemSolverZ88._ViewProviderFemSolverZ88(obj.ViewObject)
     return obj
+
+#  @}

src/Mod/Fem/FemTools.py

@@ -30,6 +30,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 from PySide import QtCore
 
+## \addtogroup FEM
+#  @{
 
 class FemTools(QtCore.QRunnable, QtCore.QObject):
     ## The constructor
@@ -538,3 +540,5 @@ class FemTools(QtCore.QRunnable, QtCore.QObject):
                          "None": (0.0, 0.0, 0.0)}
                 stats = match[result_type]
         return stats
+
+#  @}

src/Mod/Fem/FemToolsCcx.py

@@ -33,6 +33,8 @@ from PySide import QtCore
 if FreeCAD.GuiUp:
     from PySide import QtGui
 
+## \addtogroup FEM
+#  @{
 
 class FemToolsCcx(FemTools.FemTools):
 
@@ -260,3 +262,5 @@ class FemToolsCcx(FemTools.FemTools):
                     for mf in mode_frequencies:
                         if m.Eigenmode == mf['eigenmode']:
                             m.EigenmodeFrequency = mf['frequency']
+
+#  @}

src/Mod/Fem/FemToolsZ88.py

@@ -31,6 +31,8 @@ import FemTools
 from PySide import QtCore
 from PySide.QtGui import QApplication
 
+## \addtogroup FEM
+#  @{
 
 class FemToolsZ88(FemTools.FemTools):
 
@@ -200,3 +202,5 @@ class FemToolsZ88(FemTools.FemTools):
                     self.results_present = True
         else:
             raise Exception('FEM: No results found at {}!'.format(disp_result_file))
+
+#  @}

src/Mod/Fem/MechanicalMaterial.py

@@ -28,6 +28,8 @@ __url__ = "http://www.freecadweb.org"
 import FreeCAD
 import _MechanicalMaterial
 
+## \addtogroup FEM
+#  @{
 
 def makeMechanicalMaterial(name):
     '''makeMaterial(name): makes an Material
@@ -39,3 +41,5 @@ def makeMechanicalMaterial(name):
         _ViewProviderMechanicalMaterial._ViewProviderMechanicalMaterial(obj.ViewObject)
     # FreeCAD.ActiveDocument.recompute()
     return obj
+
+# @}

src/Mod/Fem/_CommandAnalysis.py

@@ -24,6 +24,9 @@ __title__ = "Command New Analysis"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandAnalysis
+#  \ingroup FEM
+
 import FreeCAD
 from FemCommands import FemCommands
 

src/Mod/Fem/_CommandBeamSection.py

@@ -24,6 +24,8 @@ __title__ = "_CommandBeamSection"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandBeamSection
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_CommandConstraintSelfWeight.py

@@ -24,6 +24,8 @@ __title__ = "Command constraint self weight"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandConstraintSelfWeight
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_CommandControlSolver.py

@@ -24,6 +24,9 @@ __title__ = "Command Control Solver"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandControlSolver
+#  \ingroup FEM
+
 import FreeCAD
 from FemCommands import FemCommands
 

src/Mod/Fem/_CommandMaterialMechanicalNonlinear.py

@@ -24,6 +24,8 @@ __title__ = "Command nonlinear mechanical material"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandMaterialMechanicalNonLinear
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_CommandMechanicalMaterial.py

@@ -24,6 +24,8 @@ __title__ = "_CommandMechanicalMaterial"
 __author__ = "Juergen Riegel, Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandMechanicalMaterial
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_CommandMeshFromShape.py

@@ -24,6 +24,9 @@ __title__ = "Command Mesh From Shape"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandMeshFromShape
+#  \ingroup FEM
+
 import FreeCAD
 from FemCommands import FemCommands
 

src/Mod/Fem/_CommandPurgeResults.py

@@ -24,6 +24,9 @@ __title__ = "Command Purge Fem Results"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandPurgeResults
+#  \ingroup FEM
+
 import FreeCAD
 from FemCommands import FemCommands
 import FemTools

src/Mod/Fem/_CommandRunSolver.py

@@ -24,6 +24,9 @@ __title__ = "Command Run Solver"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandRunSolver
+#  \ingroup FEM
+
 import FreeCAD
 from FemCommands import FemCommands
 

src/Mod/Fem/_CommandShellThickness.py

@@ -24,6 +24,8 @@ __title__ = "_CommandShellThickness"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandShellThickness
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_CommandShowResult.py

@@ -24,6 +24,9 @@ __title__ = "Command Show Result"
 __author__ = "Juergen Riegel"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandShowResult
+#  \ingroup FEM
+
 import FreeCAD
 from FemCommands import FemCommands
 

src/Mod/Fem/_CommandSolverCalculix.py

@@ -24,6 +24,8 @@ __title__ = "_CommandSolverCalculix"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandSolverCalculix
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_CommandSolverZ88.py

@@ -24,6 +24,8 @@ __title__ = "_CommandSolverZ88"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package CommandSolverZ88
+#  \ingroup FEM
 
 import FreeCAD
 from FemCommands import FemCommands

src/Mod/Fem/_FemBeamSection.py

@@ -24,6 +24,8 @@ __title__ = "_FemBeamSection"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package FemBeamSection
+#  \ingroup FEM
 
 class _FemBeamSection:
     "The FemBeamSection object"

src/Mod/Fem/_FemConstraintSelfWeight.py

@@ -24,6 +24,8 @@ __title__ = "the constraint self weight object"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package FemConstraintSelfWeight
+#  \ingroup FEM
 
 class _FemConstraintSelfWeight:
     "The FemConstraintSelfWeight object"

src/Mod/Fem/_FemMaterialMechanicalNonlinear.py

@@ -24,6 +24,8 @@ __title__ = "the fem nonlinear mechanical material object"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package FemMaterialMechanicalNonLinear
+#  \ingroup FEM
 
 class _FemMaterialMechanicalNonlinear:
     "The FemMaterialMechanicalNonlinear object"

src/Mod/Fem/_FemShellThickness.py

@@ -24,6 +24,8 @@ __title__ = "_FemShellThickness"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package FemShellThickness
+#  \ingroup FEM
 
 class _FemShellThickness:
     "The FemShellThickness object"

src/Mod/Fem/_FemSolverCalculix.py

@@ -24,6 +24,8 @@ __title__ = "_FemSolverCalculix"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package FemSolverCalculix
+#  \ingroup FEM
 
 import FreeCAD
 import FemToolsCcx

src/Mod/Fem/_FemSolverZ88.py

@@ -24,6 +24,8 @@ __title__ = "_FemSolverZ88"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package FemSolverZ88
+#  \ingroup FEM
 
 import FreeCAD
 import FemToolsZ88

src/Mod/Fem/_MechanicalMaterial.py

@@ -24,6 +24,8 @@ __title__ = "_MechanicalMaterial"
 __author__ = "Juergen Riegel, Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package MechanicalMaterial
+#  \ingroup FEM
 
 class _MechanicalMaterial:
     "The Material object"

src/Mod/Fem/_TaskPanelFemBeamSection.py

@@ -24,6 +24,8 @@ __title__ = "_TaskPanelFemBeamSection"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package TaskPanelFemBeamSection
+#  \ingroup FEM
 
 import FreeCAD
 import FreeCADGui

src/Mod/Fem/_TaskPanelFemShellThickness.py

@@ -24,6 +24,8 @@ __title__ = "_TaskPanelFemShellThickness"
 __author__ = "Bernd Hahnebach"
 __url__ = "http://www.freecadweb.org"
 
+## @package TaskPanelFemShellThickness
+#  \ingroup FEM
 
 import FreeCAD
 import FreeCADGui