From 94fe86b8764d12fdd5a441fc425efdaaaefd3dd8 Mon Sep 17 00:00:00 2001 From: cignoni Date: Wed, 19 Jun 2013 05:36:49 +0000 Subject: [PATCH] Removed doxygen warnings --- docs/Doxygen/adjacency.dxy | 6 ++- docs/Doxygen/style.dxy | 96 ++++++++++++++++++-------------------- 2 files changed, 50 insertions(+), 52 deletions(-) diff --git a/docs/Doxygen/adjacency.dxy b/docs/Doxygen/adjacency.dxy index b4a91301..cd70e27c 100644 --- a/docs/Doxygen/adjacency.dxy +++ b/docs/Doxygen/adjacency.dxy @@ -1,4 +1,4 @@ -/** \page adjacency +/** \page adjacency Adjacency ========= VCG Lib does not have a hard-coded way to encode the adjacencies among simplices. It all depends on which attributes are stored with the simplices and how they are used. I the previous examples the definition of face has always included the attribute vcg::face::VertexRef , which stores 3 pointers to MyVertex accessible with the member function V() (the well known Indexed Data Structure). The reason is that almost all of the algorithms currently implemented in VCG Lib assume its presence. So, if your type MyFace does not include the attribute vcg::face::VertexRef, the definition will be correct but almost no algorithm will work.. @@ -130,7 +130,9 @@ sf/apps/sample/trimesh_pos_demo/trimesh_pos_demo.cpp VF Adjacency ------------ -VCG Lib implements vertex-to-face adjacency, i.e. given a vertex v we can retrieve all the faces incident to v. Let v_star =(f0,f1,f2,...,fk) be the set faces incident to v arranged in a sequence (with no preferred criteria). VCG Lib allows to retrieve v_star in optimal time ( O(#star_v) by using the following attibutes: +VCG Lib implements vertex-to-face adjacency, i.e. given a vertex v we can retrieve all the faces incident to v. +Let v_star =(f0,f1,f2,...,fk) be the set faces incident to v arranged in a sequence (with no preferred criteria). +VCG Lib allows to retrieve v_star in optimal time ( O( star_v) ) by using the following attibutes: vcg::vertex::VFAdj which is a vertex attribute containing a pointer to f0 vcg::face::VFAdj which is a face attribute containing a pointer to the next face in the list v_star for each of its 3 vertices (4 in the case of tetrahedra) diff --git a/docs/Doxygen/style.dxy b/docs/Doxygen/style.dxy index 3919d4fc..750748ce 100644 --- a/docs/Doxygen/style.dxy +++ b/docs/Doxygen/style.dxy @@ -1,36 +1,38 @@ /** \page "VCG Library Coding Guide" -\section style VCG Library Coding Guide +VCG Library Coding Guide +========================= -\subsection naming Naming Rules +Naming Rules +------------ -

Class names with first letter Uppercase and internal +Class names with first letter Uppercase and internal uppercase to separate compound words.\n -

Function members of classes follow the same rule.

+Function members of classes follow the same rule. -

Example:

+Example: \code Point3f { - public: + public: ScalarType &V(const int i); } \endcode -

Public Variable members has the first letter -lowercase and internal uppercase to separate compound words.

+Public Variable members has the first letter +lowercase and internal uppercase to separate compound words. -

Example:

+Example: 

 
-
Private Variable members has an underscore as first char and
+Private Variable members has an underscore as first char and
 the first letter lowercase and internal uppercase to separate compound
-words.
 
+words.
 
-
Example:
 
+Example:
 
 
    Point3f
@@ -40,65 +42,62 @@ words.

    }
 

 
-
Class Template Arguments all capitalized and with names
+Class Template Arguments all capitalized and with names
 remembering where they have been defined.

 Class TypeDefs used for templated Class arguments or for shortness are just like Class Names,
-but ending with “Type”, “Iterator”,  “Pointer”, or “Container”.
 
+but ending with “Type”, “Iterator”,  “Pointer”, or “Container”.
 
-
Example:

+Example:
 
    typedef typename VertexType::CoordType CoordType;
    typedef typename VertContainer::iterator VertexIterator;
- 
+
 

 
-
Header Files
 
-
Header filenames and folders always fully lower case. Compound names
-are separated by '_'.
 
+
Header Files

+Header filenames and folders always fully lower case. Compound names
+are separated by '_'.
 
-
Example:
 
+Example:
 
-
-   #include<vcg/space/point3.h>
-

+    #include;
 
-
Each include file must begin with the standard legal
+Each include file must begin with the standard legal
 disclamier/license intestation and report in the first line of history
-the $LOG$ cvs string.
 
+the $LOG$ cvs string.
 
-
The following automatically generated history can be, from time to
-time, compressed and shortened to save space.
 
+The following automatically generated history can be, from time to
+time, compressed and shortened to save space.
 
-
Each file of the library has to include all the files that it
+Each file of the library has to include all the files that it
 requires. A include file should rely on the files included by its own
-include files. Example: in vcg/space/box3.h:

+include files. Example: in vcg/space/box3.h:
 
-
-   #include<vcg/math/base.h> // not necessary because included by point3.h
 
-   #include<vcg/space/point3.h>  
-

+     #include; // not necessary because included by point3.h
+     #include;
 
-
In Class definitions place all the prototypes all together before
-the inline or templated implementations.
 
 
-
Editing Rules
 
+In Class definitions place all the prototypes all together before
+the inline or templated implementations.
 
-
Tabs are equivalent to two spaces.
 
+
Editing Rules

 
-
There are no strict rules for the placement of '{' or indenting.
 
+Tabs are equivalent to two spaces.
 
-
Constructors and casting
 
+There are no strict rules for the placement of '{' or indenting.
 
-
All basic classes (point3, box3 ecc) must have null
+
Constructors and casting

+
+All basic classes (point3, box3 ecc) must have null
 constructors. Non null constructors can be added in debug
-versions.
 
+versions.
 
-
Implicit casting is disallowed. Write a member Import function for
+Implicit casting is disallowed. Write a member Import function for
 casting from different integral types and a static.

-Construct to build an object from different a integral type.

+Construct to build an object from different a integral type.
 
-
Example:
 
+Example:
 
 
    Point3f pf(1.0f,0.0f,0.0f);
@@ -106,10 +105,7 @@ Construct to build an object from different a integral type.

    pf.Import(pd);
 

 
-
Comment and documenting
 
-
All the classes, algorithms and functions MUST be documented using Doxygen. Please add a short intro before each class explaining design choices and for non trivial classes give some short usage example. For complex classes try to group  similar members under categories. Non trivial algorithms should refer the paper/book where they are explained.
 
-
 Namespaces and files should be also documented trying to explain how the file/namespace partitioning works.
-

-
- 
+
Comment and documenting

+All the classes, algorithms and functions MUST be documented using Doxygen. Please add a short intro before each class explaining design choices and for non trivial classes give some short usage example. For complex classes try to group  similar members under categories. Non trivial algorithms should refer the paper/book where they are explained.
+ Namespaces and files should be also documented trying to explain how the file/namespace partitioning works.
 */