r22609 - gnucash/trunk/src/libqof/qof - Clean up some comments

[John Ralls]

Author: jralls
Date: 2012-12-01 17:42:59 -0500 (Sat, 01 Dec 2012)
New Revision: 22609
Trac: http://svn.gnucash.org/trac/changeset/22609

Modified:
   gnucash/trunk/src/libqof/qof/gnc-date.h
   gnucash/trunk/src/libqof/qof/test/test-gnc-date.c
Log:
Clean up some comments

Modified: gnucash/trunk/src/libqof/qof/gnc-date.h
===================================================================
--- gnucash/trunk/src/libqof/qof/gnc-date.h	2012-12-01 22:42:50 UTC (rev 22608)
+++ gnucash/trunk/src/libqof/qof/gnc-date.h	2012-12-01 22:42:59 UTC (rev 22609)
@@ -354,20 +354,14 @@
  */
 gchar * gnc_timespec_to_iso8601_buff (Timespec ts, gchar * buff);
 
-/** DOCUMENT ME! FIXME: Probably similar to xaccDMYToSec() this date
- * routine might return incorrect values for dates before 1970.  */
+/** Set the proleptic Gregorian day, month, and year from a Timespec
+ * \param ts: input timespec
+ * \param day: output day, 1 - 31
+ * \param month: output month, 1 - 12
+ * \param year: output year, 0001 - 9999 CE
+ */
 void gnc_timespec2dmy (Timespec ts, gint *day, gint *month, gint *year);
 
-/* \warning hack alert XXX FIXME -- these date routines return incorrect
- * values for dates before 1970.  Most of them are good only up
- * till 2038.  This needs fixing ...
- *
- * XXX  This routine should be modified to assume that the
- * the user wanted the time at noon, localtime.  The returned
- * time_t should be seconds (at GMT) of the local noon-time.
-*/
-/* time_t xaccDMYToSec (gint day, gint month, gint year); */
-
 /** The gnc_timezone function returns the number of seconds *west*
  * of UTC represented by the tm argument, adjusted for daylight
  * savings time.

Modified: gnucash/trunk/src/libqof/qof/test/test-gnc-date.c
===================================================================
--- gnucash/trunk/src/libqof/qof/test/test-gnc-date.c	2012-12-01 22:42:50 UTC (rev 22608)
+++ gnucash/trunk/src/libqof/qof/test/test-gnc-date.c	2012-12-01 22:42:59 UTC (rev 22609)
@@ -674,8 +674,8 @@
     g_assert_cmpint (nc.tv_sec, ==, rc.tv_sec);
  }
 
-/* gnc_date_my_last_mday
-int gnc_date_my_last_mday (int month, int year)// C: 1  Local: 1:0:0
+/* gnc_date_get_last_mday
+int gnc_date_get_last_mday (int month, int year)// C: 1  Local: 1:0:0
 */
 static void
 test_gnc_date_get_last_mday (void)
@@ -1505,7 +1505,8 @@
 }
 /* dateSeparator
 return date character
-char dateSeparator (void)// C: 2 in 2  Local: 0:0:0
+char dateSeparator (void)// C: 1  Local: 0:0:0
+src/register/register-gnome/datecell-gnome.h
 */
 /* static void
 test_dateSeparator (void)
@@ -1745,14 +1746,6 @@
     g_time_zone_unref (tz05);
     g_time_zone_unref (tz0840);
 }
-/* gnc_timespec_last_mday
-int
-gnc_timespec_last_mday (Timespec t)// C: 1  Local: 0:0:0
-*/
-/* static void
-test_gnc_timespec_last_mday (void)
-{
-}*/
 /* gnc_timespec2dmy
 void
 gnc_timespec2dmy (Timespec t, int *day, int *month, int *year)// C: 1  Local: 0:0:0