This repository has been archived by the owner on Dec 5, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME_Developer
72 lines (52 loc) · 2.16 KB
/
README_Developer
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
*********************************
Developpers information - ECOGEN
*********************************
Variable and Classe names:
--------------------------
A) Variable name should began with lowercase letter and be self-understandable. Each new word began with a uppercase letter.
Exemples : int myInteger; vector<double *> vectorOfDoublePointer; etc.
B) Class attribute should began by "m_".
Exemples : int m_myInteger; double * m_doublePointer; etc.
C) Class name should began with an uppercase Letter.
Exemples : class MyClass;
Standart Doxygen comments
-------------------------
To automatise code documentation, comments should be insert as follow in header files.
A)At the head of files
//! \file file name
//! \author authors names
//! \version 1.0
//! \date 12 Novembre 2009
//! \brief brief description
B)Before class definition
//! \class class name
//! \brief brief descritption
//! \details Detailed description
//! continue description
C)Before function and method prototypes
//! \brief brief description
//! \details Detailed description
//! continue description
//! \param parameter name description
//! \param parameter name description
//! \return return description
D)class member descrption
type m_variable; //!< member description
Developper personnal comments - flags
-------------------------------------
//Developper//KeyWord// comments, ex: "//FP//DEV// comment, description"
Key word list : //DEV// in developpement
//Q// question to dig
//TODO// should be done in the future
//VS2015// problem on Visual Studio 2015
//ERR// error : to correct ASAP
//ID// idea
//ICI// Stop developement position
//VERIF// to verify : is it needed ?
//TEST// test : To delete ASAP
-----For each modification, a comment should be prepared to be included to the commit message for Git.
To do to improve ECOGEN
-----------------------
A) Addition of physics of Eos, etc.
1) Create corresponding classes for additions (.h and .cpp)
2) Modify entries.cpp