Add/fix doxygen comments

1 files changed, 12 insertions, 5 deletions

diff --git a/src/utils/time.h b/src/utils/time.h
index 05fc6c651..bc571120b 100644
--- a/src/utils/time.h
+++ b/src/utils/time.h
@@ -13,6 +13,9 @@
 
 namespace Botan {
 
+/**
+* Struct representing a particular date and time
+*/
 struct BOTAN_DLL calendar_point
    {
    u32bit year;
@@ -26,15 +29,19 @@ struct BOTAN_DLL calendar_point
       year(y), month(mon), day(d), hour(h), minutes(min), seconds(sec) {}
    };
 
-/*
-* Time Access/Conversion Functions
+/**
+* @param time_point a time point from the system clock
+* @returns calendar_point object representing this time point
 */
-BOTAN_DLL u64bit system_time();
+BOTAN_DLL calendar_point calendar_value(u64bit time_point);
 
-BOTAN_DLL calendar_point calendar_value(u64bit a_time_t);
+/**
+* @return seconds resolution timestamp, unknown epoch
+*/
+BOTAN_DLL u64bit system_time();
 
 /**
-@return nanoseconds resolution timestamp, unknown epoch
+* @return nanoseconds resolution timestamp, unknown epoch
 */
 BOTAN_DLL u64bit get_nanoseconds_clock();