From e78b6b50adb956f5b6e0e3a94835397192495375 Mon Sep 17 00:00:00 2001
From: Thomas Witkowski <thomas.witkowski@gmx.de>
Date: Thu, 27 May 2010 08:44:37 +0000
Subject: [PATCH] Added code style directive.

---
 doc/codeStyle.pdf | Bin 0 -> 47297 bytes
 doc/codeStyle.tex | 231 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 231 insertions(+)
 create mode 100644 doc/codeStyle.pdf
 create mode 100644 doc/codeStyle.tex

diff --git a/doc/codeStyle.pdf b/doc/codeStyle.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..269678587d8547417b6be5be165862d1049937dd
GIT binary patch
literal 47297
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
b9f@vXsbOyU{T%^gfk43M<m3X9g6RJTQoEoi

literal 0
HcmV?d00001

diff --git a/doc/codeStyle.tex b/doc/codeStyle.tex
new file mode 100644
index 00000000..36ac4b66
--- /dev/null
+++ b/doc/codeStyle.tex
@@ -0,0 +1,231 @@
+\documentclass[a4paper]{article}
+
+\usepackage{amsmath}
+\usepackage{amssymb}
+\usepackage{amsfonts}
+\usepackage{listings}
+
+
+\title{AMDiS C++ code style directive}
+\author{Thomas Witkowski}
+
+\begin{document}
+\maketitle
+
+\section{General recommendations}
+\begin{enumerate}
+\item The main goal of this document is to assure a unique code style
+  in AMDiS. This should make the code more readable and easier to maintain.
+
+\item The code should be readable independently of any text editor and
+  IDE.
+
+\item Any violation to the guide is allowed if it enhances readability.
+
+\item Not all source files of AMDiS are already converted to this
+  style. If you are bored, you are free to do it.
+\end{enumerate}
+
+\section{Naming conventions}
+\begin{enumerate}
+\item All names should be written in English.
+
+\item Names representing types must be in mixed case string with upper case.
+  \begin{lstlisting}{}
+FiniteElemSpace, ProblemInstat
+  \end{lstlisting}
+
+\item Variable names must be in mixed case starting with lower case. 
+  \begin{lstlisting}{}
+refinementManager, fileWriter
+  \end{lstlisting}
+
+\item Named constants (including enumeration values) must be all
+  uppercase using underscore to separate words.
+  \begin{lstlisting}{}
+CALL_LEAF_EL, GRD_PHI
+  \end{lstlisting}
+
+\item Names representing methods or functions must written in mixed
+  case starting with lower case.
+  \begin{lstlisting}{}
+refineMesh(), getTimestep()
+  \end{lstlisting}
+
+\item Abbreviations and acronyms must not be uppercase when used as
+  name.
+  \begin{lstlisting}{}
+getFeSpace()     // NOT: getFESpace()
+listDof          // NOT: listDOF
+  \end{lstlisting}
+
+\item Do not use underscores to indicate variable scopes.
+
+\item The prefix n should be used for variables representing a number
+  of objects.
+  \begin{lstlisting}{}
+nPoints, nBasisFcts
+  \end{lstlisting}
+
+\item Naming pointers specifically should be avoided.
+  \begin{lstlisting}{}
+Line *line       // NOT: Line *pLine
+Element *el      // NOT: Element *ptrEl
+  \end{lstlisting}
+
+\end{enumerate}
+
+
+\section{Files}
+
+\begin{enumerate}
+\item C++ header files should have the extension .h.  Source files should
+  have the extension .cc.
+
+\item A class should be declared in a header file and defined in a
+  source file where the name of the files match the name of the class.
+
+\item All definitions should reside in source files. Usually, get- and
+  set-function can be excluded from this rule.
+
+\item File content must be kept within 85 columns. 
+
+\item Include statements must be located at the top of a file only.
+\end{enumerate}  
+
+
+\section{Statements}
+
+\begin{enumerate}
+\item Type conversions must always be done explicitly. Never rely on
+  implicit type conversion. Do not use C-style type conversion.
+  \begin{lstlisting}{}
+floatValue = static_cast<float>(intValue); 
+// NOT: floatValue = intValue; 
+// NOT: floatValue = (float)intValue;
+  \end{lstlisting}
+
+\item Variables should be declared where they are used for the first time.
+
+\item Variables should be initialized where they are declared.
+
+\item Use of global variables should be minimized.
+
+\item Class variables should never be declared public. 
+
+\item Control variables in for() loops should be declared within the for-construction.
+  \begin{lstlisting}{}
+for (int i = 0; i < 10; i++)
+
+// NOT:  
+int i; 
+for (i = 0; i < 10; i++)
+  \end{lstlisting}
+
+\item Complex conditional expressions must be avoided. Introduce
+  temporary boolean variables instead.
+
+\item The conditional should be put on a separate line. 
+  \begin{lstlisting}{}
+if (isOkay)   // NOT: if (isOkay) doIt();
+  doIt();  
+  \end{lstlisting}
+
+\item Executable statements in conditionals must be avoided.
+
+\item Floating point constants should always be written with decimal
+  point and at least one decimal.
+  \begin{lstlisting}{}
+double total = 0.0;   // NOT: double total = 0; 
+double speed = 3.0e8; // NOT: double speed = 3e8; 
+  \end{lstlisting}
+\end{enumerate}
+
+
+\section{Layout}
+
+\begin{enumerate}
+\item Block layout should be as follows
+  \begin{lstlisting}{}
+if (isOkay) {
+  doSomething();
+  ...
+} else {
+  doSomethingElse();
+  ...
+}
+
+for () {
+  runCode();
+  ...
+}
+  \end{lstlisting}
+    
+\item Single statement if-else, for or while statements can be written
+  without brackets.
+  \begin{lstlisting}{}
+for (int i = 0; i < 5; i++)
+  doSomething();
+
+// NOT:
+for (int i = 0; i < 5; i++) {
+  doSomething();
+}
+  \end{lstlisting}
+
+\item The class declarations should have the following form: 
+  \begin{lstlisting}{}
+class SomeClass : public BaseClass 
+{ 
+public: 
+  ... 
+protected: 
+  ... 
+private: 
+  ... 
+} 
+  \end{lstlisting}
+
+\item Method definitions should have the following form: 
+  \begin{lstlisting}{}
+void someMethod() 
+{ 
+  ... 
+} 
+  \end{lstlisting}
+    
+\item General white spaces:
+  \begin{itemize}
+  \item Conventional operators should be surrounded by a space character.
+  \item C++ reserved words should be followed by a white space.
+  \item Commas should be followed by a white space.
+  \item Colons should be surrounded by white space.
+  \item Semicolons in for statements should be followed by a space character. 
+  \end{itemize}
+
+  \begin{lstlisting}{}
+a = (b + c) * d;   // NOT: a=(b+c)*d 
+while (true)       // NOT: while(true)
+doSomething(a, b, c, d);        // NOT: doSomething(a,b,c,d); 
+for (int i = 0; i < 10; i++) {  // NOT: for(int i=0;i<10;i++){
+  \end{lstlisting}
+
+\item Methods should be separated by two blank lines. 
+
+\end{enumerate}
+
+
+\section{Comments}
+
+\begin{enumerate}
+\item Tricky code should not be commented but rewritten!
+  
+\item All comments should be written in English.
+
+\item Class and method header comments should follow the JavaDoc
+  conventions.
+\end{enumerate}
+
+
+
+\end{document}
\ No newline at end of file
-- 
GitLab