doc: reformat group definitions

Author: mshabunin

Diff for: modules/cannops/include/opencv2/cann.hpp

@@ -8,12 +8,12 @@
 #include "opencv2/core.hpp"
 
 /**
-  @defgroup cann Ascend-accelerated Computer Vision
+  @defgroup cannops Ascend-accelerated Computer Vision
   @{
     @defgroup canncore Core part
     @{
       @defgroup cann_struct Data Structures
-      @defgroup cann_init Initializeation and Information
+      @defgroup cann_init Initialization and Information
     @}
   @}
  */

Diff for: modules/cannops/include/opencv2/cann_interface.hpp

@@ -13,9 +13,9 @@ namespace cann
 {
 
 /**
-  @addtogroup cann
+  @addtogroup cannops
   @{
-    @defgroup cannops Operations for Ascend Backend.
+    @defgroup cannops_ops Operations for Ascend Backend.
     @{
         @defgroup cannops_elem Per-element Operations
         @defgroup cannops_core Core Operations on Matrices

Diff for: modules/face/include/opencv2/face/facemark.hpp

@@ -12,19 +12,15 @@ Mentor: Delia Passalacqua
 #ifndef __OPENCV_FACELANDMARK_HPP__
 #define __OPENCV_FACELANDMARK_HPP__
 
-/**
-@defgroup face Face Analysis
-- @ref tutorial_table_of_content_facemark
-- The Facemark API
-*/
-
 #include "opencv2/core.hpp"
 #include <vector>
 
 
 namespace cv {
 namespace face {
 
+//! @addtogroup face
+//! @{
 
 /** @brief Abstract base class for all facemark models
 
@@ -88,6 +84,7 @@ CV_EXPORTS_W Ptr<Facemark> createFacemarkLBF();
 //! construct a Kazemi facemark detector
 CV_EXPORTS_W Ptr<Facemark> createFacemarkKazemi();
 
+//! @}
 
 } // face
 } // cv

Diff for: modules/face/include/opencv2/face/facemark_train.hpp

@@ -12,12 +12,6 @@ Mentor: Delia Passalacqua
 #ifndef __OPENCV_FACELANDMARKTRAIN_HPP__
 #define __OPENCV_FACELANDMARKTRAIN_HPP__
 
-/**
-@defgroup face Face Analysis
-- @ref tutorial_table_of_content_facemark
-- The Facemark API
-*/
-
 #include "opencv2/face/facemark.hpp"
 #include "opencv2/objdetect.hpp"
 #include <vector>

Diff for: modules/fuzzy/include/opencv2/fuzzy.hpp

@@ -52,19 +52,19 @@
 
 Namespace for all functions is `ft`. The module brings implementation of the last image processing algorithms based on fuzzy mathematics. Method are named based on the pattern `FT`_degree_dimension`_`method.
 
-  @{
+@{
     @defgroup f0_math Math with F0-transform support
 
-Fuzzy transform (\f$F^0\f$-transform) of the 0th degree transforms whole image to a matrix of its components. These components are used in latter computation where each of them represents average color of certain subarea.
+    Fuzzy transform (\f$F^0\f$-transform) of the 0th degree transforms whole image to a matrix of its components. These components are used in latter computation where each of them represents average color of certain subarea.
 
     @defgroup f1_math Math with F1-transform support
 
-Fuzzy transform (\f$F^1\f$-transform) of the 1th degree transforms whole image to a matrix of its components. Each component is polynomial of the 1th degree carrying information about average color and average gradient of certain subarea.
+    Fuzzy transform (\f$F^1\f$-transform) of the 1th degree transforms whole image to a matrix of its components. Each component is polynomial of the 1th degree carrying information about average color and average gradient of certain subarea.
 
     @defgroup f_image Fuzzy image processing
 
-Image proceesing based on fuzzy mathematics namely F-transform.
-   @}
+    Image proceesing based on fuzzy mathematics namely F-transform.
+@}
 
 */
 

Diff for: modules/hdf/include/opencv2/hdf.hpp

@@ -41,17 +41,15 @@
 
 This module provides storage routines for Hierarchical Data Format objects.
 
-  @{
+@{
     @defgroup hdf5 Hierarchical Data Format version 5
 
-Hierarchical Data Format version 5
---------------------------------------------------------
+    Hierarchical Data Format version 5
+    --------------------------------------------------------
 
-In order to use it, the hdf5 library has to be installed, which
-means cmake should find it using `find_package(HDF5)` .
-
-
-  @}
+    In order to use it, the hdf5 library has to be installed, which
+    means cmake should find it using `find_package(HDF5)`.
+@}
 */
 
 #endif

Diff for: modules/sfm/include/opencv2/sfm.hpp

@@ -75,7 +75,7 @@ This module has been originally developed as a project for Google Summer of Code
   - Notice that it is compiled only when Eigen, GLog and GFlags are correctly installed.\n
     Check installation instructions in the following tutorial: @ref tutorial_sfm_installation
 
-  @{
+@{
     @defgroup conditioning Conditioning
     @defgroup fundamental Fundamental
     @defgroup io Input/Output
@@ -85,18 +85,17 @@ This module has been originally developed as a project for Google Summer of Code
     @defgroup triangulation Triangulation
 
     @defgroup reconstruction Reconstruction
-      @note
-        - Notice that it is compiled only when Ceres Solver is correctly installed.\n
-          Check installation instructions in the following tutorial: @ref tutorial_sfm_installation
 
+    @note
+    - Notice that it is compiled only when Ceres Solver is correctly installed.\n
+        Check installation instructions in the following tutorial: @ref tutorial_sfm_installation
 
     @defgroup simple_pipeline Simple Pipeline
-      @note
-          - Notice that it is compiled only when Ceres Solver is correctly installed.\n
-            Check installation instructions in the following tutorial: @ref tutorial_sfm_installation
-
-  @}
 
+    @note
+        - Notice that it is compiled only when Ceres Solver is correctly installed.\n
+        Check installation instructions in the following tutorial: @ref tutorial_sfm_installation
+@}
 */
 
 #endif

Diff for: modules/viz/include/opencv2/viz.hpp

@@ -60,25 +60,24 @@ interact with it.
 3D visualization window (see Viz3d) is used to display widgets (see Widget), and it provides several
 methods to interact with scene and widgets.
 
-  @{
+@{
     @defgroup viz_widget Widget
 
-In this section, the widget framework is explained. Widgets represent 2D or 3D objects, varying from
-simple ones such as lines to complex ones such as point clouds and meshes.
+    In this section, the widget framework is explained. Widgets represent 2D or 3D objects, varying from
+    simple ones such as lines to complex ones such as point clouds and meshes.
 
-Widgets are **implicitly shared**. Therefore, one can add a widget to the scene, and modify the
-widget without re-adding the widget.
+    Widgets are **implicitly shared**. Therefore, one can add a widget to the scene, and modify the
+    widget without re-adding the widget.
 
-@code
-// Create a cloud widget
-viz::WCloud cw(cloud, viz::Color::red());
-// Display it in a window
-myWindow.showWidget("CloudWidget1", cw);
-// Modify it, and it will be modified in the window.
-cw.setColor(viz::Color::yellow());
-@endcode
-
-  @}
+    @code
+    // Create a cloud widget
+    viz::WCloud cw(cloud, viz::Color::red());
+    // Display it in a window
+    myWindow.showWidget("CloudWidget1", cw);
+    // Modify it, and it will be modified in the window.
+    cw.setColor(viz::Color::yellow());
+    @endcode
+@}
 */
 
 #endif /* OPENCV_VIZ_HPP */