[latexila] Fix some translatable strings and add comments

[SÃbastien Wilmet <swilmet src gnome org>]

commit 6043973fa99fa5307ffc4613e0ddc8464a949495
Author: SÃbastien Wilmet <swilmet src gnome org>
Date:   Thu Aug 4 00:54:37 2011 +0200

    Fix some translatable strings and add comments

 data/build_tools/C/build_tools.xml |    4 ++--
 data/build_tools/build_tools.pot   |    6 +++---
 data/templates/C/article.xml       |    2 +-
 data/templates/C/letter.xml        |    2 +-
 data/templates/templates.pot       |    4 +++-
 src/main_window.vala               |    1 +
 src/structure.vala                 |    5 +++++
 7 files changed, 16 insertions(+), 8 deletions(-)
---
diff --git a/data/build_tools/C/build_tools.xml b/data/build_tools/C/build_tools.xml
index 8dc22be..d7abaa7 100644
--- a/data/build_tools/C/build_tools.xml
+++ b/data/build_tools/C/build_tools.xml
@@ -81,13 +81,13 @@
 
   <tool show="false" extensions=".tex" icon="compile_pdf">
     <label its:translate="no">LaTeX â PDF (pdflatex)</label>
-    <description>Create a PDF file from LaTeX sources with the 'pdflatex' command</description>
+    <description>Create a PDF file from LaTeX sources with the "pdflatex" command</description>
     <job mustSucceed="true" postProcessor="latex">pdflatex -interaction=nonstopmode $filename</job>
   </tool>
 
   <tool show="false" extensions=".tex" icon="compile_dvi">
     <label its:translate="no">LaTeX â DVI (latex)</label>
-    <description>Create a DVI file from LaTeX sources with the 'latex' command</description>
+    <description>Create a DVI file from LaTeX sources with the "latex" command</description>
     <job mustSucceed="true" postProcessor="latex">latex -interaction=nonstopmode $filename</job>
   </tool>
 
diff --git a/data/build_tools/build_tools.pot b/data/build_tools/build_tools.pot
index 28e77fb..40298b5 100644
--- a/data/build_tools/build_tools.pot
+++ b/data/build_tools/build_tools.pot
@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2011-07-18 01:01+0200\n"
+"POT-Creation-Date: 2011-08-04 00:52+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL ADDRESS>\n"
 "Language-Team: LANGUAGE <LL li org>\n"
@@ -34,11 +34,11 @@ msgid "View the PostScript file"
 msgstr ""
 
 #: C/build_tools.xml:84(tool/description)
-msgid "Create a PDF file from LaTeX sources with the 'pdflatex' command"
+msgid "Create a PDF file from LaTeX sources with the \"pdflatex\" command"
 msgstr ""
 
 #: C/build_tools.xml:90(tool/description)
-msgid "Create a DVI file from LaTeX sources with the 'latex' command"
+msgid "Create a DVI file from LaTeX sources with the \"latex\" command"
 msgstr ""
 
 #: C/build_tools.xml:98(tool/description)
diff --git a/data/templates/C/article.xml b/data/templates/C/article.xml
index fc11ea1..9c2f81b 100644
--- a/data/templates/C/article.xml
+++ b/data/templates/C/article.xml
@@ -5,7 +5,7 @@
 \usepackage[utf8]{inputenc}
 \usepackage{lmodern}
 </chunk>
-<chunk>
+<chunk its:locNote="This must be translated by a usepackage LaTeX command.">
 % babel package or equivalent
 </chunk>
 <chunk its:translate="no">
diff --git a/data/templates/C/letter.xml b/data/templates/C/letter.xml
index f6adc66..23fd8b2 100644
--- a/data/templates/C/letter.xml
+++ b/data/templates/C/letter.xml
@@ -1,5 +1,5 @@
 <template xmlns:its="http://www.w3.org/2005/11/its";>
-<chunk>
+<chunk its:locNote="There is a helper script in data/templates/tex2po.sh">
 \documentclass[a4paper,11pt]{letter}
 \usepackage[T1]{fontenc}
 \usepackage[utf8]{inputenc}
diff --git a/data/templates/templates.pot b/data/templates/templates.pot
index d9a1542..b5f0cab 100644
--- a/data/templates/templates.pot
+++ b/data/templates/templates.pot
@@ -1,7 +1,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2011-07-19 00:49+0200\n"
+"POT-Creation-Date: 2011-08-04 00:52+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL ADDRESS>\n"
 "Language-Team: LANGUAGE <LL li org>\n"
@@ -9,6 +9,7 @@ msgstr ""
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 
+#. This must be translated by a usepackage LaTeX command.
 #: C/article.xml:8(template/chunk)
 #: C/beamer.xml:8(template/chunk)
 #: C/book.xml:8(template/chunk)
@@ -20,6 +21,7 @@ msgid ""
 ""
 msgstr ""
 
+#. There is a helper script in data/templates/tex2po.sh
 #: C/letter.xml:2(template/chunk)
 #, no-wrap
 msgid ""
diff --git a/src/main_window.vala b/src/main_window.vala
index 94e16b5..7bc6d75 100644
--- a/src/main_window.vala
+++ b/src/main_window.vala
@@ -167,6 +167,7 @@ public class MainWindow : Window
     {
         { "ViewMainToolbar", null, N_("_Main Toolbar"), null,
             N_("Show or hide the main toolbar"), on_show_main_toolbar },
+        // Translators: "Edit" here is an adjective.
         { "ViewEditToolbar", null, N_("_Edit Toolbar"), null,
             N_("Show or hide the edit toolbar"), on_show_edit_toolbar },
         { "ViewSidePanel", null, N_("_Side panel"), null,
diff --git a/src/structure.vala b/src/structure.vala
index f219476..42099fa 100644
--- a/src/structure.vala
+++ b/src/structure.vala
@@ -613,12 +613,17 @@ public class Structure : VBox
         if (_action_names == null)
         {
             _action_names = new string[StructAction.NB_ACTIONS];
+            // Translators: it's a verb
             _action_names[StructAction.CUT]         = _("cut");
+            // Translators: it's a verb
             _action_names[StructAction.COPY]        = _("copy");
             _action_names[StructAction.DELETE]      = _("delete");
             _action_names[StructAction.SELECT]      = _("select");
+            // Translators: it's a verb
             _action_names[StructAction.COMMENT]     = _("comment");
+            // Translators: it's a verb
             _action_names[StructAction.SHIFT_LEFT]  = _("shift left");
+            // Translators: it's a verb
             _action_names[StructAction.SHIFT_RIGHT] = _("shift right");
         }