Report:  Work File Differentials
Option:  -W
Compatible Options: a, b, c, e, f, F, H, k, l, m, n, O, o, r, R, s, T, v
Usage:
rsm -H -W *.h *.cpp > report.htm
rsm -H -W .java > report.htm
Source:  C, C++ and Java
RSM can perform baseline source differentials for source code metrics.   The differential report generate from the -W option requires that a work file has been previously generated.  A work file contains files by name, time and metrics.   When -W is run, the specified files are compared against the metrics data stored into the workfile.dat file.  Metrics differentials are typically processed against a constant set of source code directories.

The metrics differential report indicates those files which are new, removed, modified or equal.  Each file is rated by the percent difference in eLOC.  Typically, if a file changes by more than 10% in eLOC, the file will be re-inspected in a peer review.  The work file differential report is based upon the time between the metrics processing.  The time differential and the addition LOC metrics can yield a productivity rate for the processed files.

Work metrics are stored in date named files.  The file name begin with the prefix "rm" followed by month, day, century and year.  The -x option can be used to extract metric differentials between two different work files.

                     ~~ Source Code Work Analysis ~~

  Ancestor File: workfile.dat                     Fri Jun 25 06:24:56 1999
  Latest File  : rm091919.99                      Sun Sep 19 00:30:55 1999

  Time Differential Between Files
      490.02 Hr(8/Day)    61.25 Day(5/Wk)    12.25 Week(4/M)     3.06 Month

  State   LOC    eLOC    lLOC   Cyclo Comment  Blanks   Lines    eLOC% File
  ------------------------------------------------------------------------

  New     127      84      49      19      13      28     167   100.00 cell.cpp
  Mod       4       3       1       0       2       1       5    14.29 cell.h
  New      88      53      32      16       4      17     107   100.00 game.cpp
  New      23      19       9       0       1       7      31   100.00 game.h
  New     217     144      83      32       7      29     252   100.00 ocean.cpp
  Mod      12      10       9       0       0       1      13    50.00 ocean.h
  New     100      71      38      14       3      24     126   100.00 player.cpp
  New      32      28      17       0       1       8      41   100.00 player.h
  New      12      10       4       1       1       5      18   100.00 seahunt.cpp
  New      72      53      28       9       3      18      91   100.00 sub.cpp
  New      21      18       7       1       2       7      29   100.00 sub.h
  New      98      69      33      11       4      19     119   100.00 target.cpp
  Mod      19      15       6       2       9       8      35    62.50 target.h
  New      84      56      33      13       4      11      98   100.00 utility.cpp
  New      20      16       8       0       3       7      30   100.00 utility.h
  ------------------------------------------------------------------------

  Tot     929     649     357     118      57     190    1162    Sum Total

  Tot     1.9     1.3     0.7     0.2     0.1     0.4     2.4    Per Hour
  Tot      15      11       6       2       1       3      19    Per Day
  Tot      76      53      29      10       5      16      95    Per Week
  Tot     303     212     117      39      19      62     379    Per Month

  Total Metrics Historical Source Files
  LOC           72  eLOC          65  lLOC          38  CycloCmp         0
  Comments      24  Blanks        25  Lines        113

  Total Metrics Present Source Files
  LOC         1001  eLOC         714  lLOC         395  CycloCmp       118
  Comments      81  Blanks       215  Lines       1275

  Total Metrics Differential From Historic Basis in Percent %
  LOC      1290.28  eLOC      998.46  lLOC      939.47  CycloCmp      0.00
  Comments  237.50  Blanks    760.00  Lines    1028.32
  ________________________________________________________________________