Home | History | Annotate | Download | only in html
      1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
      2 
      3 <html>
      4 <head>
      5 	<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
      6 	<title>Builds view</title>
      7 </head>
      8 
      9 <body>
     10 <h1>Builds view</h1>
     11 <p>
     12 This view shows the list of all the builds contained in the connected database
     13 or in the local data files if no database is connected.
     14 </p>
     15 
     16 <h2>Information status</h2>
     17 <p>
     18 When starting the tool for the first time, this view is empty as no data has been
     19 populated, neither from the <a href="local_data.html">local data</a> files
     20 nor from the performance results database.
     21 </p><p>
     22 The typical usage of the performance tools is to read local data files copied
     23 from the server (see <a href="local_data.html">local data</a>). When this has
     24 been done, build names are displayed in this view using normal black color.
     25 </p>
     26 Some or all build names of the list may be displayed in a different font when
     27 a performance results database is connected:
     28 <ul>
     29 <li>
     30 <i><font color="#888888">gray and italic</font></i>: no local data files
     31 were read
     32 <p><img src="images/builds-nolocaldata.png" alt="Builds view with no local data"/></p>
     33 </li>
     34 <li>
     35 <font color="#888888">gray</font></i>: the local data files were read but contain
     36 no information about this build (typically new performance tests ran but the local
     37 data files were not copied since then):
     38 <p><img src="images/builds-missinglocaldata.png" alt="Builds view with missing local data"/></p>
     39 In this case it's possible to update those builds using the popup-menu:
     40 <p><img src="images/builds-update.png" alt="Update local data builds"/></p>
     41 It's also possible to rewrite the local data files from the database contents
     42 in one shot using the toolbar pull-up menu:
     43 <p><img src="images/builds-updateall.png" alt="Update all local data"/></p>
     44 </li>
     45 </ul>
     46 
     47 <h2>Generate</h2>
     48 <p>
     49 From this view, it is also possible to generate HTML pages using the generate
     50 command accessible from the popup-menu:
     51 <p><img src="images/builds-generate-menu.png" alt="Generate results: menu item"/></p>
     52 <p>
     53 After having selected the directory where to put the generated files, it's possible
     54 to choose the baseline to compare with:
     55 <p><img src="images/builds-generate-baseline.png" alt="Generate results: baseline selection"/></p>
     56 <p>
     57 And also whether you only want to generate the fingerprints or all the data:
     58 <p><img src="images/builds-generate-fingerprints.png" alt="Generate results: fingerprints"/></p>
     59 <p>
     60 After the generation ends, there should be in the specified directory similar
     61 files than the one generated on eclipsebuildserv.
     62 </p><p>
     63 <i>Note that a PHP server is neeeded to be able to read these files as it's done on
     64 eclipsebuildserv or fullmoon...</i>
     65 </p>
     66 
     67 <h2>Filters</h2>
     68 <p>
     69 There are several possible filters in this view.
     70  
     71 <h3>Builds filters</h3>
     72 <ul>
     73 <li>Baseline: hide the baselines (starting with R-3.x)</li>
     74 <li>Nightly: hide the nightly builds (starting with 'N')</li>
     75 <li>Old: hide all builds before last milestone except earlier milestones</li>
     76 </ul>
     77 <p>
     78 In this view baselines filter is not activated by default. It's because it may
     79 be interesting to know which baselines have results in the DB.
     80 Note that this filter is not synchronized with the one in Components view.
     81 </p>
     82 
     83 </body>
     84 </html>