doc: add Doxygen build system

- add Doxygen build configuration file template and CMake list file.
- add option for building documentation.
- the content of documentation should be filled in future.

.gitattributes

@@ -0,0 +1 @@
+Doxyfile.in eol=lf

CMakeLists.txt

@@ -6,12 +6,16 @@ project(YYCC
 
 # Provide options
 option(YYCC_BUILD_TESTBENCH "Build testbench of YYCCommonplace." OFF)
+option(YYCC_BUILD_DOC "Build document of YYCCommonplace." OFF)
 
 # Import 2 build targets
 add_subdirectory(src)
 if (YYCC_BUILD_TESTBENCH)
     add_subdirectory(testbench)
 endif ()
+if (YYCC_BUILD_DOC)
+    add_subdirectory(doc)
+endif ()
 
 # Install project package infos
 # Package target

doc/CMakeLists.txt

@@ -0,0 +1,6 @@
+# Configure Doxygen config file
+configure_file(
+    ${CMAKE_CURRENT_LIST_DIR}/Doxyfile.in
+    ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
+    @ONLY
+)

doc/src/index.dox

@@ -0,0 +1,10 @@
+/**
+
+\mainpage YYCCommonplace Library Manual
+
+This manual is organized into the following chapters and appendices:
+
+\subpage intro
+
+
+*/

doc/src/intro.dox

@@ -0,0 +1,11 @@
+/**
+
+\page intro Introduction to YYCCommonplace
+
+work in progress
+
+\section work in progress
+
+work in progress
+
+*/