From 4bed016f017f1577ff995886f940a5d712e6abeb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mario=20H=C3=BCttel?= <mario.huettel@gmx.net>
Date: Tue, 26 Mar 2019 21:00:05 +0100
Subject: [PATCH] Update documentation: Add compilation page, fix additional
 mistake in cell-geometrics.h

---
 README.MD                                     |  2 +-
 doxygen/compilation.dox                       | 60 +++++++++++++++++++
 doxygen/main-page.dox                         |  2 +-
 .../gds-render/geometric/cell-geometrics.h    | 12 ++--
 4 files changed, 68 insertions(+), 8 deletions(-)
 create mode 100644 doxygen/compilation.dox

diff --git a/README.MD b/README.MD
index 2e0e9b9..008d39e 100644
--- a/README.MD
+++ b/README.MD
@@ -1,4 +1,4 @@
-# GDS-Render
+# GDS-Render Readme
 
 This software is a rendering programm for GDS2 layout files.
 The GDS2 format is mainly used in integrated circuit development.
diff --git a/doxygen/compilation.dox b/doxygen/compilation.dox
new file mode 100644
index 0000000..761aba5
--- /dev/null
+++ b/doxygen/compilation.dox
@@ -0,0 +1,60 @@
+/**
+
+@page compilation Compilation
+
+@section Preface
+
+GDS-Render is designed for UNIX-like, especially GNU/Linux based systems.
+It was developed under a Linux system. Therefore, best performance is expected using a Linux operating system.
+
+@section depencencies Dependencies
+The dependencies of GDS-Render are:
+
+@subsection run-deps Program Dependencies
+
+ - GLib2
+ - GTK3
+ - Cairographics
+
+@subsection comp-deps Compilation Dependencies
+These dependencies are not needed for running the program; just for compilation.
+
+ - Build System (GCC + binutils, make, etc...). Most distributions supply a "development" meta-package containing this stuff.
+ - cmake >= 2.8
+ - More or less optional: git. Used for extraction of the precise version number. It is strongly recommended to provide git!
+ - Optional: doxygen for this nice documentation.
+
+The dependency list of GTK3 already includes Cairographics and GLib2. You should be on the safe side with a recent GTK3 version.
+
+Development is done with the following library versions:
+
+| Cairographics | GLib2      | GTK3   |
+| ------------- | ---------- | ------ |
+| 1.16.0-2      | 2.60.0-1   | 3.24.7 |
+
+@section comp-instr Compilation Instructions
+@subsection linux-build General Linux Build Instruction
+Go to the build directory you want to compile in. This may be the gds-render project root.
+Execute
+@code
+ cmake <Path to gds-render root>
+@endcode
+
+Cmake will check the dependencies. Once cmake has finished. Type
+
+@code
+ make
+@endcode
+
+in order to build the program and 
+
+@code
+ make documentation
+@endcode
+ to build the doxygen documentation.
+
+@subsection arch-makepkg Archlinux Package
+
+The subfolder 'AUR' contains a PKGBUILD file to build an Archlinux/Pacman package.
+
+*/
diff --git a/doxygen/main-page.dox b/doxygen/main-page.dox
index 16cb4ed..3956732 100644
--- a/doxygen/main-page.dox
+++ b/doxygen/main-page.dox
@@ -6,7 +6,7 @@ This programm converts GDS layout files to
 - PDF Files using the @ref Cairo-Renderer
 - Latex code (TikZ) using the @ref LaTeX-Renderer
 
-See the @subpage usage page for details 
+See the @subpage usage page for details and @subpage compilation for building instructions.
 
 
 
diff --git a/include/gds-render/geometric/cell-geometrics.h b/include/gds-render/geometric/cell-geometrics.h
index 9b49903..6226bf8 100644
--- a/include/gds-render/geometric/cell-geometrics.h
+++ b/include/gds-render/geometric/cell-geometrics.h
@@ -18,8 +18,8 @@
  */
 
 /**
- * @file cell-trigonometrics.h
- * @brief Calculation of gds_cell trigonometrics
+ * @file cell-geometrics.h
+ * @brief Calculation of gds_cell geometrics
  * @author Mario Hüttel <mario.huettel@gmx.net>
  */
 
@@ -28,8 +28,8 @@
  * @{
  */
 
-#ifndef _CELL_TRIGONOMETRICS_H_
-#define _CELL_TRIGONOMETRICS_H_
+#ifndef _CELL_GEOMETRICS_H_
+#define _CELL_GEOMETRICS_H_
 
 #include <gds-render/geometric/bounding-box.h>
 #include <gds-render/gds-utils/gds-types.h>
@@ -37,11 +37,11 @@
 /**
  * @brief calculate_cell_bounding_box Calculate bounding box of gds cell
  * @param box Resulting boundig box. Will be uüdated and not overwritten
- * @param cell toplevel cell
+ * @param cell Toplevel cell
  * @warning Path handling not yet implemented correctly.
  */
 void calculate_cell_bounding_box(union bounding_box *box, struct gds_cell *cell);
 
-#endif /* _CELL_TRIGONOMETRICS_H_ */
+#endif /* _CELL_GEOMETRICS_H_ */
 
 /** @} */