translation-quick-start-guide/en_US rpm-info.xml, 1.12, 1.13 translation-quick-start.xml, 1.20, 1.21

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/translation-quick-start-guide/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv4833/en_US

Modified Files:
	rpm-info.xml translation-quick-start.xml 
Log Message:
- Bump to 0.3.7.5:
  * Add information about po/LINGUAS file
  * Remove unnecessary admonitions




Index: rpm-info.xml
===================================================================
RCS file: /cvs/docs/translation-quick-start-guide/en_US/rpm-info.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- rpm-info.xml	28 Jul 2007 21:27:33 -0000	1.12
+++ rpm-info.xml	29 Jul 2007 23:41:08 -0000	1.13
@@ -44,6 +44,10 @@
   <title>Translation Quick Start Guide</title>
   <desc>Quick start guide to providing translations on the Fedora Project.</desc>
   <changelog order="newest-first">
+    <revision date="2007-07-29" number="0.3.7.5">
+      <author worker="PaulWFrields"/>
+      <details>Add information about LINGUAS and remove unnecessary admonitions</details>
+    </revision>
     <revision date="2007-07-28" number="0.3.7.4">
       <author worker="PaulWFrields"/>
       <details>Add information on branch modules and testing changes</details>


Index: translation-quick-start.xml
===================================================================
RCS file: /cvs/docs/translation-quick-start-guide/en_US/translation-quick-start.xml,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- translation-quick-start.xml	28 Jul 2007 21:27:33 -0000	1.20
+++ translation-quick-start.xml	29 Jul 2007 23:41:08 -0000	1.21
@@ -590,14 +590,11 @@
 
     <section id="sn-translating-with-apps">
       <title>Using Translation Applications</title>
-      <note>
-	<title>Creating the <filename class="directory">po/</filename>
-	Directory</title>
-	<para>
-	  If the <filename class="directory">po/</filename> directory
-	  does not exist, you can create it and the translation
-	  template file with the following commands:
-	</para>
+      <para>
+	If the <filename class="directory">po/</filename> directory does
+	not exist, you can create it and the translation template file
+	with the following commands:
+      </para>
 
 <screen>
 <command>mkdir po</command>
@@ -605,7 +602,6 @@
 <command>make pot</command>
 </screen>
 
-      </note>
       <para>
 	To work with a <filename class="extension">.po</filename> editor
 	like <application>KBabel</application> or
@@ -625,25 +621,16 @@
 
 	</step>
 	<step>
-	  <para>
-	    In the <filename>Makefile</filename>, add your translation
-	    language code to the <varname>OTHERS</varname> variable:
-	  </para>
-
-<screen>
-<computeroutput>OTHERS = it <userinput><replaceable>pt_BR</replaceable></userinput></computeroutput>
-</screen>
-
-	  <note>
-	    <title>Disabled Translations</title>
-	    <para>
-	      Often, if a translation is not complete, document editors
-	      disable it by putting it behind a comment sign (#) in
-	      the <varname>OTHERS</varname> variable.  To enable a
-	      translation, make sure it <emphasis>precedes</emphasis>
-	      any comment sign.
-	    </para>
-	  </note>
+	  <para>To add your locale, you must locate and change the
+	    appropriate locale list.  Some documents are using the
+	    <filename>po/LINGUAS</filename> file, as standardized in the
+	    GNOME project, to track locales.  Some documents have not
+	    been updated to this standard yet.  If you find the module
+	    you are translating has not been updated, notify the &FDP;
+	    or file a bug using &BZ;.</para>
+	  <para>In the <filename>po/LINGUAS</filename>, add your
+	    translation language code to the list.  <emphasis>Keep the
+	      list in alphabetical order.</emphasis></para>
 	</step>
 	<step>
 	  <para>
@@ -696,19 +683,16 @@
 <command>cvs ci -m <replaceable>'Message about commit'</replaceable> po/<replaceable>pt_BR</replaceable>.po</command>
 </screen>
 
-	  <important>
-	    <title>Committing the <filename>Makefile</filename></title>
-	    <para>
-	      <emphasis>Do not commit the <filename>Makefile</filename>
+	  <para>
+	    <emphasis>Do not commit the <filename>Makefile</filename>
 	      until your translation is finished.</emphasis>  To do so,
-	      run this command:
-	    </para>
+	    run this command:
+	  </para>
 
 <screen>
 <command>cvs ci -m 'Translation to <replaceable>pt_BR</replaceable> finished' Makefile</command>
 </screen>
 
-	  </important>
 	  <caution>
 	    <title>Do Not Make Manual POT Changes</title>
 	    <para>Authors and editors generate the POT file from the