r20971 - htdocs/branches/beta - Tweak the sizing page.

Cristian Marchi cmarchi at code.gnucash.org
Fri Jul 29 10:49:03 EDT 2011


Author: cmarchi
Date: 2011-07-29 10:49:02 -0400 (Fri, 29 Jul 2011)
New Revision: 20971
Trac: http://svn.gnucash.org/trac/changeset/20971

Modified:
   htdocs/branches/beta/externals/gnucash.css
   htdocs/branches/beta/sizing.phtml
Log:
Tweak the sizing page.

Modified: htdocs/branches/beta/externals/gnucash.css
===================================================================
--- htdocs/branches/beta/externals/gnucash.css	2011-07-29 14:26:19 UTC (rev 20970)
+++ htdocs/branches/beta/externals/gnucash.css	2011-07-29 14:49:02 UTC (rev 20971)
@@ -91,9 +91,9 @@
 }
 
 TABLE {
-   border-width: 2px;
-   border-style: ridge;
-   border-color: silver;
+   font-size:40%;
+   width:100%;
+   border:1px solid silver;
 } 
 
 TR {

Modified: htdocs/branches/beta/sizing.phtml
===================================================================
--- htdocs/branches/beta/sizing.phtml	2011-07-29 14:26:19 UTC (rev 20970)
+++ htdocs/branches/beta/sizing.phtml	2011-07-29 14:49:02 UTC (rev 20971)
@@ -12,28 +12,28 @@
 
 <h1><?php echo T_($title);?></h1>
 
-<p>
+<p class="justify">
 <?php echo T_("It can often be quite interesting to study the source code metrics behind a software development project.   Not a surprising interest: its accounting afterall.  GnuCash has grown, over the years, from a small handy electronic checkbook to a rather large and multi-featured desktop app.");?>
 </p>
-<p>
+<p class="justify">
 <?php echo T_("GnuCash currently consists of over a third of a million lines of code spread over more than a thousand files.  It has been translated into twenty-three languages and credits over 139 authors and contributors.");?>
 </p>
-<p>
+<p class="center">
 <img alt="[code size graph]" src="<?=$top_dir?>/images/sizing-graph.png" width="640" height="480" />
 </p>
-<p>
+<p class="justify">
 <?php echo T_("If you've had trouble swimming through that mass of source code, think of it this way: printed out on paper, and bound into volumes, it would amount to several dozen copies of Tolstoy's \"War and Peace\", roughly a bookshelf-width's worth of source code.");?>
 </p>
-<p>
+<p class="justify">
 <?php echo T_("Mind you, this is source code (and docs) crafted and debugged by actual humans, this is *not* autogenerated code.  Tools (such as glade or g-wrap) can generate gaziilions of lines of code automatically; I'm not counting those.  Every last line counted here was typed in, edited, indented, tweaked, multiple times, by human hands.");?>
 </p>
-<p>
+<p class="justify">
 <?php echo T_("Given that we have about 400 outstanding bugs in bugzilla, that works out to about one bug per thousand lines of code, or one bug per 50 pages of printout.  This bug count is actually not atypical for software projects; its near the norm.");?>
 </p>
-<p>
+<p class="justify">
 <?php echo T_("The table below shows some historical lines-of-code and number-of-files metrics for the GnuCash 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 converters, addons and utilities.  Finally, <tt>glade</tt> files are not counted, although large parts of the overall GUI are described in <tt>glade</tt> files.");?>
 </P>
-<P>
+<p class="justify">
 <?php echo T_("Note also that KLOC's are not a good metric of programmer productivity, nor even that <code>wc</code> 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 statement.  Maybe someday we'll run one of those tools on this code. For now, this is what we have.  On the other hand, we've attempted to count only those files that contain human-edited code, that is, files that are directly edited by humans.  The point of doing this is to avoid artificially inflating the KLOC counts by counting automatically generated code (which is why the glade files are not counted: they are large and automatically generated).");?>
 </P>
 <P>
@@ -317,15 +317,16 @@
 </tr>
 </TBODY ></TABLE ></DIV >
 
- <P>
+<p class="justify">
 <?php echo T_("Each cell displays the following:");
     
 echo T_("number of *c and *.h and *.scm files (KLOCS in *.c + KLOCS in *.h + KLOCS in *.scm).  If there are no *.scm files in the directory, then only (KLOCS in *.c + KLOCS in *.h) are displayed.  If there is only one number in the parenthesis, it is the approriate KLOC count for that statistic.");?>
 
- </P><P>
+</p>
+<p class="justify">
 <?php echo T_("where KLOC == kilo-lines-of-code, as reported by <code>wc</code>. As noted above, wc is not a terribly good code metric, but its what we have handy.");?>
+</p>
 
- </P>
 <b><?php echo T_("Table Column Legend");?></b><br><br>
     <P></P>
  <DL>



More information about the gnucash-changes mailing list