add intro paragraphs, add number of language translations

git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@2968 57a11ea4-9604-0410-9ed3-97b8803252fd

doc/sgml/C/xacc-about.sgml

@@ -939,8 +939,25 @@ similar transactions.
 
 <PARA> The table below shows some historical lines-of-code and
 number-of-files metrics for the <application>GnuCash</application>
-development project.
+development project.  Note that not all of the code is counted: for
+instance, the Makefiles and configure.in and autogen.sh are not counted. 
+Also, files that are automatically generated are not counted, nor are
+files that have been 'borrowed' from other projects. Also not counted 
+are experimental files, miscellaneous perl scripts, various translators,
+addons and utilities.
+</PARA>
+
+<PARA>
+Note also that KLOC's are not a good metric of programmer productivity,
+nor even that <application>wc</application> is a good way of counting
+KLOC's.  Much better measures are complexity metrics, which, for
+example, count the number and size of if-then-else blocks, or the number
+and size of all blocks, or the number of math operators per each
+statement.  Maybe someday we'll run one of those tools on this code. 
+For now, this is what we have.
+</PARA>
 
+<PARA>
 <TABLE>
 <TITLE> Historical Development Stats </TITLE>
 
@@ -957,6 +974,7 @@ development project.
 <ENTRY>docs</ENTRY>
 <ENTRY>txt</ENTRY>
 <ENTRY>Total</ENTRY>
+<ENTRY>Languages</ENTRY>
 </ROW>
 </THEAD>
 <TBODY>
@@ -976,6 +994,7 @@ development project.
          (0.1)</ENTRY>
 <ENTRY>40 files
          (8.8)</ENTRY>
+<ENTRY>1</ENTRY>
 </ROW>
 <ROW>
 <ENTRY>xacc-0.9w
@@ -993,6 +1012,7 @@ development project.
          (0.1)</ENTRY>
 <ENTRY>61 files
          (16.2)</ENTRY>
+<ENTRY>1</ENTRY>
 </ROW>
 <ROW>
 <ENTRY>xacc-1.0.17
@@ -1010,6 +1030,7 @@ development project.
          (0.3)</ENTRY>
 <ENTRY>68 files
          (18.3)</ENTRY>
+<ENTRY>1</ENTRY>
 </ROW>
 <ROW>
 <ENTRY>gnucash-1.1.15
@@ -1032,6 +1053,7 @@ development project.
          (1.8)</ENTRY>
 <ENTRY>159 files
          (34.7)</ENTRY>
+<ENTRY>1 (0.17)</ENTRY>
 </ROW>
 <ROW>
 <ENTRY>gnucash-1.2.2
@@ -1053,6 +1075,7 @@ development project.
          (1.8)</ENTRY>
 <ENTRY>168 files
          (39.0)</ENTRY>
+<ENTRY>3 (0.54)</ENTRY>
 </ROW>
 <ROW>
 <ENTRY>gnucash-1.3.6
@@ -1067,13 +1090,14 @@ development project.
 <ENTRY>78 files
          (32.2+3.0)</ENTRY>
 <ENTRY>74 files
-         (17.0)</ENTRY>
+         (4.0+0.7+12.3)</ENTRY>
 <ENTRY>33 files
          (7.8)</ENTRY>
 <ENTRY>25 files
          (4.5)</ENTRY>
 <ENTRY>302 files
          (95.1)</ENTRY>
+<ENTRY>5 (4.3) </ENTRY>
 </ROW>
 <ROW>
 <ENTRY>gnucash-1.4.6
@@ -1095,6 +1119,7 @@ development project.
          (4.8)</ENTRY>
 <ENTRY>316 files
          (101.9)</ENTRY>
+<ENTRY>7 (6.0)</ENTRY>
 </ROW>
 <ROW>
 <ENTRY>gnucash-1.5.2
@@ -1116,6 +1141,7 @@ development project.
          (8.2)</ENTRY>
 <ENTRY>341 files
          (114.2)</ENTRY>
+<ENTRY>8 (7.8)</ENTRY>
 </ROW>
 </TBODY>
 </TGROUP>
@@ -1170,6 +1196,12 @@ development project.
               (html or sgml)
       
 
+ </PARA>
+<PARA>Languages -- the number of languages that the application messages
+      have been translated to.  In parenthesis, the number of messages
+      in the message files (grep msgstr *.po |wc), in thousands.
+      
+
  </PARA>
 </LISTITEM>