Out of source build and some documentation tests.

doc/Doxyfile.in

@@ -668,7 +668,7 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = @top_srcdir@/src
+INPUT                  = @top_srcdir@/include @top_srcdir@/src
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is

include/calendar.h

+/**
+ * @addtogroup CBindings libmtime C language bindings
+ *
+ * @file calendar.c
+ * 
+ * @brief Singleton Calendar connecting all supported calendar types.
+ *
+ * @author Luis Kornblueh, Rahul Sinha. MPIM.
+ * @date March 2013
+ *
+ * @note Calendar type, once initialized, should not be changed.
+ */
 #ifndef CALENDAR_H
 #define CALENDAR_H
 
-#include <stdlib.h>
-
 #define MAX_CALENDAR_STR_LEN 32
 
 struct _datetime;
 struct _julianday;
 
+/**
+ * @enum  calendarType
+ * 
+ * @brief calendar selector 
+ */
+
 typedef enum
 {
   CALENDAR_NOT_SET = 0, PROLEPTIC_GREGORIAN = 1, YEAR_OF_365_DAYS = 2, YEAR_OF_360_DAYS = 3

src/calendar.c

 /**
+ * @addtogroup CBindings libmtime C language bindings
+ *
  * @file calendar.c
  * 
  * @brief Singleton Calendar connecting all supported calendar types.
@@ -10,6 +12,7 @@
  */
 
 #include <stdio.h>
+#include <stdlib.h>
 #include <string.h>
 #include <stdbool.h>
 
@@ -29,7 +32,6 @@ struct _datetime *
 (*julian2date)(struct _julianday *julian, struct _datetime *date);
 /*! \endcond */
 
-
 static calendarType _calendar_type = CALENDAR_NOT_SET;
 
 static bool calendar_initialized = false;

src/date.c

 /**
+ * \addtogroup CBindings libmtime C language bindings
+ * 
  * @file date.c
  * 
  * @brief Date and some operations supported on Date.

src/libmtime.f90

@@ -5,8 +5,8 @@
 !! @author  Luis Kornblueh, Max Planck Institute for Meteorology
 !! @author  Rahul Sinha, Max Planck Institute for Meteorology
 !!
-!! defgroup FortranBindings libmtime Fortran language bindings
-!!___________________________________________________________________________________________________________
+!! @defgroup FortranBindings libmtime Fortran language bindings
+!___________________________________________________________________________________________________________
 !>
 !! @brief Provides the calendar to the users, abstracting the different calendars available.
 !!
@@ -23,7 +23,7 @@
 !!
 !! @author  Luis Kornblueh, Max Planck Institute for Meteorology
 !! @author  Rahul Sinha, Max Planck Institute for Meteorology
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_calendar
   !
   use, intrinsic :: iso_c_binding, only: c_int, c_char, c_null_char
@@ -32,6 +32,7 @@ module mtime_calendar
   !
   private
   !
+   
   enum, bind(c)
     enumerator :: calendar_not_set    = 0   !> calendar is not defined yet
     enumerator :: proleptic_gregorian = 1   !> proleptic Gregorian calendar
@@ -85,7 +86,7 @@ contains
 end module mtime_calendar
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_julianday
   !
   use, intrinsic :: iso_c_binding, only: c_int64_t, c_char, c_null_char, c_ptr, c_loc, c_f_pointer
@@ -161,7 +162,7 @@ contains
 end module mtime_julianday
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_date
   !
   use, intrinsic :: iso_c_binding, only: c_int, c_int64_t, c_char, c_ptr, c_null_char, c_loc, c_f_pointer
@@ -238,7 +239,7 @@ contains
 end module mtime_date
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_time
   !
   use, intrinsic :: iso_c_binding, only: c_int, c_char, c_ptr, c_null_char, c_loc, c_f_pointer
@@ -315,7 +316,7 @@ contains
 end module mtime_time
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_datetime
   !
   use, intrinsic :: iso_c_binding, only: c_int, c_int64_t, c_char, c_ptr, c_null_char, c_loc, c_f_pointer
@@ -603,7 +604,7 @@ contains
 end module mtime_datetime
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_timedelta
   !
   use, intrinsic :: iso_c_binding, only: c_int, c_int64_t, c_char, c_ptr, c_null_char, c_loc, c_f_pointer
@@ -717,7 +718,7 @@ contains
 end module mtime_timedelta
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_events
   !
   use, intrinsic :: iso_c_binding, only: c_int64_t, c_char, c_null_char, c_bool, c_ptr, c_loc, c_f_pointer
@@ -818,7 +819,7 @@ contains
 end module mtime_events
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime_eventgroups
   !
   use, intrinsic :: iso_c_binding, only: c_int64_t, c_ptr, c_char, c_null_char, c_bool, c_loc, c_f_pointer
@@ -906,7 +907,7 @@ contains
 end module mtime_eventgroups
 !>
 !!
-!!___________________________________________________________________________________________________________
+!___________________________________________________________________________________________________________
 module mtime
   !
   use, intrinsic :: iso_c_binding, only: c_int, c_int64_t, c_bool, c_ptr, c_char

src/time.c

 /**
+ * @addtogroup CBindings libmtime C language bindings
+ *
  * @file time.c
  * 
  * @brief Time and some operations supported on Time.