gnomemm r1409 - in libgdamm/trunk: . libgda/src

[murrayc svn gnome org]

Author: murrayc
Date: Sun Mar 16 16:00:26 2008
New Revision: 1409
URL: http://svn.gnome.org/viewvc/gnomemm?rev=1409&view=rev

Log:
2008-03-16  Murray Cumming  <murrayc murrayc com>

* libgda/src/datahandler.hg: Clarified documentation.

Modified:
   libgdamm/trunk/ChangeLog
   libgdamm/trunk/libgda/src/datahandler.hg
   libgdamm/trunk/libgda/src/datamodel.hg
   libgdamm/trunk/libgda/src/datamodelimport.hg

Modified: libgdamm/trunk/libgda/src/datahandler.hg
==============================================================================
--- libgdamm/trunk/libgda/src/datahandler.hg	(original)
+++ libgdamm/trunk/libgda/src/datahandler.hg	Sun Mar 16 16:00:26 2008
@@ -32,8 +32,6 @@
 namespace Gda
 {
 
-//TODO: In the libgda documentation, if the "STR" format is the human-readable text representation in the current locale, then say so.
-
 /** @defgroup DataHandlers Data Handlers
  */
 
@@ -45,8 +43,9 @@
  * 
  * The DataHandler object can convert a Value to and from both SQL and 'STR'. The SQL representation of a value is the 
  * actual string which would be used in an SQL statement (for example a string's SQL representation is surrounded by 
- * quotes such as 'that\'s a string'). The 'STR' representation is a user friendly representation of a value (and the 
- * previous example would simply be: that's a string).
+ * quotes such as 'that\'s a string'). The 'STR' representation is a human-readable representation of a value appropriate 
+ * for the user's current locale. The 'STR' respresentation of a string is simply the original string without quotes but 
+ * a numerical value or date, for instance, will be formatted according to the user's current locale.
  * 
  * Only one object which implements this interface is needed for any given data type, and it mainly contains some methods 
  * to manage values (as Value structures). The Gnome::Db::DataEntry interface is complementary to this one since it is 

Modified: libgdamm/trunk/libgda/src/datamodel.hg
==============================================================================
--- libgdamm/trunk/libgda/src/datamodel.hg	(original)
+++ libgdamm/trunk/libgda/src/datamodel.hg	Sun Mar 16 16:00:26 2008
@@ -188,6 +188,7 @@
 
   //These are from gda-datamodel-extra.h:
   //TODO: Are these meant to be public API?
+  //See http://bugzilla.gnome.org/show_bug.cgi?id=513543
   /* Let's assume not. It's safer to add them later if necessary:
   _WRAP_METHOD(void signal_emit_changed(), gda_data_model_signal_emit_changed)
   _WRAP_METHOD(void row_inserted(int row), gda_data_model_row_inserted)

Modified: libgdamm/trunk/libgda/src/datamodelimport.hg
==============================================================================
--- libgdamm/trunk/libgda/src/datamodelimport.hg	(original)
+++ libgdamm/trunk/libgda/src/datamodelimport.hg	Sun Mar 16 16:00:26 2008
@@ -31,7 +31,6 @@
 namespace Gda
 {
 
-//TODO: This is presumably an alternative to using a database provider. If so, document it as such. murrayc.
 
 /** Importing data from a string or a file.
  * This data model imports data from a string or a file. The data can either be in a CSV (comma separated values)