[glom] Add translator comments.

From: Murray Cumming <murrayc src gnome org>
To: commits-list gnome org
Cc:
Subject: [glom] Add translator comments.
Date: Mon, 11 Jul 2011 07:52:56 +0000 (UTC)
commit e4559045941595e8613d5cccf8cc19bf2f09b0c0
Author: Murray Cumming <murrayc murrayc com>
Date:   Mon Jul 11 09:52:47 2011 +0200

    Add translator comments.
    
    * glom/libglom/data_structure/field.cc:
    * glom/libglom/data_structure/layout/*.c:
    * glom/mode_data/box_data_list.cc:
    * glom/mode_data/box_data_list.h:
    * glom/mode_data/box_data_manyrecords.cc:
    * glom/mode_data/notebook_data.cc:
    * ui/developer/dialog_script_library.glade: Add translator comments.
    Bug #638996 (Joe Hansen)

 ChangeLog                                          |   13 ++++++++
 glom/libglom/data_structure/field.cc               |   15 ++++++++-
 glom/libglom/data_structure/layout/layoutgroup.cc  |    1 +
 .../data_structure/layout/layoutitem_button.cc     |    1 +
 .../layout/layoutitem_calendarportal.cc            |    1 +
 .../data_structure/layout/layoutitem_field.cc      |    1 +
 .../data_structure/layout/layoutitem_image.cc      |    1 +
 .../data_structure/layout/layoutitem_line.cc       |    3 +-
 .../data_structure/layout/layoutitem_notebook.cc   |    3 +-
 .../layout/layoutitem_placeholder.cc               |    1 +
 .../data_structure/layout/layoutitem_portal.cc     |    4 ++
 .../data_structure/layout/layoutitem_text.cc       |    1 +
 .../layout/report_parts/layoutitem_fieldsummary.cc |    1 +
 .../layout/report_parts/layoutitem_footer.cc       |    1 +
 .../layout/report_parts/layoutitem_groupby.cc      |    1 +
 .../layout/report_parts/layoutitem_header.cc       |    1 +
 .../layout/report_parts/layoutitem_summary.cc      |    1 +
 .../report_parts/layoutitem_verticalgroup.cc       |    1 +
 glom/mode_data/box_data_list.cc                    |   33 --------------------
 glom/mode_data/box_data_list.h                     |    3 --
 glom/mode_data/box_data_manyrecords.cc             |    1 +
 glom/mode_data/notebook_data.cc                    |    4 ++
 ui/developer/dialog_script_library.glade           |    2 +-
 23 files changed, 54 insertions(+), 40 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 8966075..c40efa5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,16 @@
+2011-07-11  Murray Cumming  <murrayc murrayc com>
+
+	Add translator comments.
+
+	* glom/libglom/data_structure/field.cc:
+	* glom/libglom/data_structure/layout/*.c:
+	* glom/mode_data/box_data_list.cc:
+	* glom/mode_data/box_data_list.h:
+	* glom/mode_data/box_data_manyrecords.cc:
+	* glom/mode_data/notebook_data.cc:
+	* ui/developer/dialog_script_library.glade: Add translator comments.
+	Bug #638996 (Joe Hansen)
+
 2011-07-08  Murray Cumming  <murrayc murrayc com>
 
 	Related Records: Show enough records.
diff --git a/glom/libglom/data_structure/field.cc b/glom/libglom/data_structure/field.cc
index 3a52f47..6d4ccb3 100644
--- a/glom/libglom/data_structure/field.cc
+++ b/glom/libglom/data_structure/field.cc
@@ -637,12 +637,25 @@ void Field::init_map()
     m_map_glom_type_to_gda_type[TYPE_BOOLEAN] = G_TYPE_BOOLEAN;
     m_map_glom_type_to_gda_type[TYPE_IMAGE] = GDA_TYPE_BINARY;
 
+    // Translators: This means an unknown or unnacceptable value type in a database.
     m_map_type_names_ui[TYPE_INVALID] = _("Invalid");
+    
+    // Translators: This means a numeric value type in a database.
     m_map_type_names_ui[TYPE_NUMERIC] = _("Number");
+    
+    // Translators: This means a text/string value type in a database.
     m_map_type_names_ui[TYPE_TEXT] = _("Text");
+    
+    // Translators: This means a time value type in a database.
     m_map_type_names_ui[TYPE_TIME] = _("Time");
-    m_map_type_names_ui[TYPE_DATE] = _("Date");    
+    
+    // Translators: This means a time value type in a database.
+    m_map_type_names_ui[TYPE_DATE] = _("Date");
+    
+    // Translators: This means a true/false value type in a database.
     m_map_type_names_ui[TYPE_BOOLEAN] = _("Boolean");
+    
+    // Translators: This means a picture value type in a database.
     m_map_type_names_ui[TYPE_IMAGE] = _("Image");
 
     //Non-translated names used for the document:
diff --git a/glom/libglom/data_structure/layout/layoutgroup.cc b/glom/libglom/data_structure/layout/layoutgroup.cc
index b98c5a0..61b3d9b 100644
--- a/glom/libglom/data_structure/layout/layoutgroup.cc
+++ b/glom/libglom/data_structure/layout/layoutgroup.cc
@@ -412,6 +412,7 @@ void LayoutGroup::change_relationship_name(const Glib::ustring& table_name, cons
 
 Glib::ustring LayoutGroup::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Group");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_button.cc b/glom/libglom/data_structure/layout/layoutitem_button.cc
index 1ca8ad7..3c15897 100644
--- a/glom/libglom/data_structure/layout/layoutitem_button.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_button.cc
@@ -64,6 +64,7 @@ LayoutItem_Button& LayoutItem_Button::operator=(const LayoutItem_Button& src)
 
 Glib::ustring LayoutItem_Button::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Button");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_calendarportal.cc b/glom/libglom/data_structure/layout/layoutitem_calendarportal.cc
index f23b6bf..efaadf7 100644
--- a/glom/libglom/data_structure/layout/layoutitem_calendarportal.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_calendarportal.cc
@@ -54,6 +54,7 @@ LayoutItem_CalendarPortal& LayoutItem_CalendarPortal::operator=(const LayoutItem
 
 Glib::ustring LayoutItem_CalendarPortal::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Calendar Portal");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_field.cc b/glom/libglom/data_structure/layout/layoutitem_field.cc
index 48c33db..3329425 100644
--- a/glom/libglom/data_structure/layout/layoutitem_field.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_field.cc
@@ -190,6 +190,7 @@ void LayoutItem_Field::set_hidden(bool val)
 
 Glib::ustring LayoutItem_Field::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Field");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_image.cc b/glom/libglom/data_structure/layout/layoutitem_image.cc
index 71d55ed..350f439 100644
--- a/glom/libglom/data_structure/layout/layoutitem_image.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_image.cc
@@ -66,6 +66,7 @@ LayoutItem_Image& LayoutItem_Image::operator=(const LayoutItem_Image& src)
 
 Glib::ustring LayoutItem_Image::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Image");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_line.cc b/glom/libglom/data_structure/layout/layoutitem_line.cc
index 7e62090..96baa0f 100644
--- a/glom/libglom/data_structure/layout/layoutitem_line.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_line.cc
@@ -78,7 +78,8 @@ LayoutItem_Line& LayoutItem_Line::operator=(const LayoutItem_Line& src)
 
 Glib::ustring LayoutItem_Line::get_part_type_name() const
 {
-  //Note to translators: This is a straight line, not a database row.
+  //Translators: This is the name of a UI element (a layout part name).
+  //This is a straight line, not a database row.
   return _("Line");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_notebook.cc b/glom/libglom/data_structure/layout/layoutitem_notebook.cc
index b52486d..0a18486 100644
--- a/glom/libglom/data_structure/layout/layoutitem_notebook.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_notebook.cc
@@ -52,7 +52,8 @@ LayoutItem_Notebook& LayoutItem_Notebook::operator=(const LayoutItem_Notebook& s
 
 Glib::ustring LayoutItem_Notebook::get_part_type_name() const
 {
-  //Note to translators: "Notebook" means a GtkNotebook-type widget.
+  //Translators: This is the name of a UI element (a layout part name).
+  //"Notebook" means a GtkNotebook-type widget.
   return _("Notebook");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_placeholder.cc b/glom/libglom/data_structure/layout/layoutitem_placeholder.cc
index 55b0855..c9b58ee 100644
--- a/glom/libglom/data_structure/layout/layoutitem_placeholder.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_placeholder.cc
@@ -56,6 +56,7 @@ bool LayoutItem_Placeholder::operator==(const LayoutItem_Placeholder* src) const
 
 Glib::ustring LayoutItem_Placeholder::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
 	return _("Placeholder");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_portal.cc b/glom/libglom/data_structure/layout/layoutitem_portal.cc
index e33b1cc..fe8a9a2 100644
--- a/glom/libglom/data_structure/layout/layoutitem_portal.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_portal.cc
@@ -65,6 +65,10 @@ LayoutItem_Portal& LayoutItem_Portal::operator=(const LayoutItem_Portal& src)
 
 Glib::ustring LayoutItem_Portal::get_part_type_name() const
 {
+  //TODO: "Portal" probably shouldn't appear in the UI.
+  //We should use "Related Records instead.
+  //Translators: This is the name of a UI element (a layout part name).
+  //It means a list of related records.
   return _("Portal");
 }
 
diff --git a/glom/libglom/data_structure/layout/layoutitem_text.cc b/glom/libglom/data_structure/layout/layoutitem_text.cc
index 0e154cf..c49f1a3 100644
--- a/glom/libglom/data_structure/layout/layoutitem_text.cc
+++ b/glom/libglom/data_structure/layout/layoutitem_text.cc
@@ -69,6 +69,7 @@ LayoutItem_Text& LayoutItem_Text::operator=(const LayoutItem_Text& src)
 
 Glib::ustring LayoutItem_Text::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Text");
 }
 
diff --git a/glom/libglom/data_structure/layout/report_parts/layoutitem_fieldsummary.cc b/glom/libglom/data_structure/layout/report_parts/layoutitem_fieldsummary.cc
index 741efdc..345f791 100644
--- a/glom/libglom/data_structure/layout/report_parts/layoutitem_fieldsummary.cc
+++ b/glom/libglom/data_structure/layout/report_parts/layoutitem_fieldsummary.cc
@@ -68,6 +68,7 @@ Glib::ustring LayoutItem_FieldSummary::get_title_or_name() const
 
 Glib::ustring LayoutItem_FieldSummary::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Field Summary");
 }
 
diff --git a/glom/libglom/data_structure/layout/report_parts/layoutitem_footer.cc b/glom/libglom/data_structure/layout/report_parts/layoutitem_footer.cc
index 05375e1..69b6b3e 100644
--- a/glom/libglom/data_structure/layout/report_parts/layoutitem_footer.cc
+++ b/glom/libglom/data_structure/layout/report_parts/layoutitem_footer.cc
@@ -52,6 +52,7 @@ LayoutItem_Footer& LayoutItem_Footer::operator=(const LayoutItem_Footer& src)
 
 Glib::ustring LayoutItem_Footer::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Footer");
 }
 
diff --git a/glom/libglom/data_structure/layout/report_parts/layoutitem_groupby.cc b/glom/libglom/data_structure/layout/report_parts/layoutitem_groupby.cc
index 6d1adfc..7511cf7 100644
--- a/glom/libglom/data_structure/layout/report_parts/layoutitem_groupby.cc
+++ b/glom/libglom/data_structure/layout/report_parts/layoutitem_groupby.cc
@@ -99,6 +99,7 @@ bool LayoutItem_GroupBy::get_has_fields_sort_by() const
 
 Glib::ustring LayoutItem_GroupBy::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Group By");
 }
 
diff --git a/glom/libglom/data_structure/layout/report_parts/layoutitem_header.cc b/glom/libglom/data_structure/layout/report_parts/layoutitem_header.cc
index edc1005..a7b3339 100644
--- a/glom/libglom/data_structure/layout/report_parts/layoutitem_header.cc
+++ b/glom/libglom/data_structure/layout/report_parts/layoutitem_header.cc
@@ -52,6 +52,7 @@ LayoutItem_Header& LayoutItem_Header::operator=(const LayoutItem_Header& src)
 
 Glib::ustring LayoutItem_Header::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Header");
 }
 
diff --git a/glom/libglom/data_structure/layout/report_parts/layoutitem_summary.cc b/glom/libglom/data_structure/layout/report_parts/layoutitem_summary.cc
index 5e0978f..8be1574 100644
--- a/glom/libglom/data_structure/layout/report_parts/layoutitem_summary.cc
+++ b/glom/libglom/data_structure/layout/report_parts/layoutitem_summary.cc
@@ -58,6 +58,7 @@ LayoutItem_Summary& LayoutItem_Summary::operator=(const LayoutItem_Summary& src)
 
 Glib::ustring LayoutItem_Summary::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Summary");
 }
 
diff --git a/glom/libglom/data_structure/layout/report_parts/layoutitem_verticalgroup.cc b/glom/libglom/data_structure/layout/report_parts/layoutitem_verticalgroup.cc
index 3a76af4..ab21657 100644
--- a/glom/libglom/data_structure/layout/report_parts/layoutitem_verticalgroup.cc
+++ b/glom/libglom/data_structure/layout/report_parts/layoutitem_verticalgroup.cc
@@ -52,6 +52,7 @@ LayoutItem_VerticalGroup& LayoutItem_VerticalGroup::operator=(const LayoutItem_V
 
 Glib::ustring LayoutItem_VerticalGroup::get_part_type_name() const
 {
+  //Translators: This is the name of a UI element (a layout part name).
   return _("Vertical Group");
 }
 
diff --git a/glom/mode_data/box_data_list.cc b/glom/mode_data/box_data_list.cc
index 8917e1a..80dfcb3 100644
--- a/glom/mode_data/box_data_list.cc
+++ b/glom/mode_data/box_data_list.cc
@@ -486,39 +486,6 @@ sharedptr<Field> Box_Data_List::get_field_primary_key() const
   return m_AddDel.get_key_field();
 }
 
-void Box_Data_List::print_layout() //TODO: Is this a duplicate of the one in box_data_manyrecords.cc?
-{
-  const Privileges table_privs = Privs::get_current_privs(m_table_name);
-
-  //Don't try to print tables that the user can't view.
-  if(!table_privs.m_view)
-  {
-    //TODO: Warn the user.
-  }
-  else
-  {
-    //Create a simple report on the fly:
-    sharedptr<Report> report_temp(new Report());
-    report_temp->set_name("list");
-    report_temp->set_title(_("List"));
-
-    //Add all the fields from the layout:
-    for(type_vecConstLayoutFields::const_iterator iter = m_FieldsShown.begin(); iter != m_FieldsShown.end(); ++iter)
-    {
-      sharedptr<const LayoutItem> item = *iter;
-      sharedptr<LayoutItem> unconst = sharedptr<LayoutItem>::cast_const(item); //TODO: Avoid this?
-      report_temp->m_layout_group->add_item(unconst);
-    }
-
-    ReportBuilder report_builder;
-    report_builder.set_document(get_document());
-    report_builder.report_build(m_found_set, report_temp, get_app_window());
-  }
-}
-
-void Box_Data_List::print_layout_group(xmlpp::Element* /* node_parent */, const sharedptr<const LayoutGroup>& /* group */)
-{
-}
 
 void Box_Data_List::set_read_only(bool read_only)
 {
diff --git a/glom/mode_data/box_data_list.h b/glom/mode_data/box_data_list.h
index 6f31fe5..b69aa99 100644
--- a/glom/mode_data/box_data_list.h
+++ b/glom/mode_data/box_data_list.h
@@ -102,9 +102,6 @@ protected:
   void on_adddel_script_button_clicked(const sharedptr<const LayoutItem_Button>& layout_item, const Gtk::TreeModel::iterator& row);
   bool on_script_button_idle(const sharedptr<const LayoutItem_Button>& layout_item, const Gnome::Gda::Value& primary_key);
 
-  virtual void print_layout();
-  virtual void print_layout_group(xmlpp::Element* node_parent, const sharedptr<const LayoutGroup>& group);
-
 #ifndef GLOM_ENABLE_CLIENT_ONLY
   virtual Dialog_Layout* create_layout_dialog() const; // override.
   virtual void prepare_layout_dialog(Dialog_Layout* dialog); // override.
diff --git a/glom/mode_data/box_data_manyrecords.cc b/glom/mode_data/box_data_manyrecords.cc
index 723da78..ddb0972 100644
--- a/glom/mode_data/box_data_manyrecords.cc
+++ b/glom/mode_data/box_data_manyrecords.cc
@@ -80,6 +80,7 @@ void Box_Data_ManyRecords::print_layout()
     //Create a simple report on the fly:
     sharedptr<Report> report_temp(new Report());
     report_temp->set_name("list");
+    //Translators: This is a noun. It is the title of a report.
     report_temp->set_title(_("List"));
 
     //Add all the fields from the layout:
diff --git a/glom/mode_data/notebook_data.cc b/glom/mode_data/notebook_data.cc
index c425ce6..be1dd35 100644
--- a/glom/mode_data/notebook_data.cc
+++ b/glom/mode_data/notebook_data.cc
@@ -64,14 +64,17 @@ Notebook_Data::Notebook_Data()
    
    
   //Add Pages:
+  //Translators: This is a noun. It is a notebook tab title.
   append_page(m_Box_List, _("List"));
   m_iPage_List = 0;
 
   #ifndef GLOM_ENABLE_MAEMO
+  //Translators: This is a noun. It is a notebook tab title.
   append_page(m_Box_Details, _("Details"));
   m_iPage_Details = 1;
   #else
   //On Maemo, we add the box to m_window_maemo_details instead:
+  //Translators: This is a noun. It is a notebook tab title.
   m_window_maemo_details = new Window_BoxHolder(&m_Box_Details, _("Details"));
 
   //Let this window have the main AppMenu:
@@ -90,6 +93,7 @@ Notebook_Data::Notebook_Data()
 
   // Set accessible name for the notebook, to be able to access it via LDTP
 #ifdef GTKMM_ATKMM_ENABLED
+  //Translators: This is a title, not an action.
   get_accessible()->set_name(_("List Or Details View"));
 #endif
 
diff --git a/ui/developer/dialog_script_library.glade b/ui/developer/dialog_script_library.glade
index e3c2e93..d946ca8 100644
--- a/ui/developer/dialog_script_library.glade
+++ b/ui/developer/dialog_script_library.glade
@@ -115,7 +115,7 @@
                 <property name="layout_style">end</property>
                 <child>
                   <object class="GtkButton" id="button_check">
-                    <property name="label" translatable="yes" comments="Translators: This is the verb">_Check</property>
+                    <property name="label" translatable="yes" comments="Translators: This is the verb. It is for checking that a Python script works.">_Check</property>
                     <property name="visible">True</property>
                     <property name="can_focus">True</property>
                     <property name="can_default">True</property>
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]