glibmm r666 - in trunk: . glib/src

[murrayc svn gnome org]

Author: murrayc
Date: Fri Jun 13 09:55:03 2008
New Revision: 666
URL: http://svn.gnome.org/viewvc/glibmm?rev=666&view=rev

Log:
2008-06-13  Murray Cumming  <murrayc murrayc com>

* glib/src/date.hg: Used @newin2p18 on the new API and made some 
slight corrections to the new reference documentation comments.

Modified:
   trunk/ChangeLog
   trunk/glib/src/date.hg

Modified: trunk/glib/src/date.hg
==============================================================================
--- trunk/glib/src/date.hg	(original)
+++ trunk/glib/src/date.hg	Fri Jun 13 09:55:03 2008
@@ -55,7 +55,7 @@
    */
   Date();
 
-  /** Construct a date with given day, month and year.
+  /** Construct a date with the given day, month and year.
    * @param day The day.
    * @param month The month.
    * @param year The year.
@@ -67,14 +67,17 @@
    */
   explicit Date(guint32 julian_day);
 
-  /** Construct a Glib::Date from a GDate. The GDate is kept by Glib::Date and
-   * then destroyed when Glib::Date is destroyed.
+  /** Construct a Glib::Date by copying the contents of a GDate.
    * @param castitem The GDate.
+   *
+   * @newin2p18
    */
   explicit Date(const GDate& castitem);
 
   /** Construct a Glib::Date from another.
    * @param other the other Glib::Date.
+   *
+   * @newin2p18
    */
   Date(const Date& other);
 
@@ -84,7 +87,10 @@
    * Glib::Date my_date;
    * my_date = other_date;
    * @endcode
+   *
    * @param other The other Glib::Date.
+   *
+   * @newin2p18
    */
   Date& operator=(const Date& other);
 
@@ -149,7 +155,7 @@
    */
   void set_time(const GTimeVal& timeval);
 
-  /** Set Glib::Date to current time.
+  /** Set this Glib::Date to the current time.
    */
   void set_time_current();
 
@@ -182,7 +188,6 @@
 
   //TODO: Why return Date& (which is always *this) from these methods?
   //Isn't it enough to also change the current instance?
-  //Maybe we need a copy constructor too.
   //murrayc
   
   /** Add a number of days to a Date.