diffstat - make histogram from diff-output


USAGE

       diffstat [options] [file-specifications]


SYNOPSIS

       This  program reads the output of diff and displays a his­
       togram of the  insertions,  deletions,  and  modifications
       per-file.


DESCRIPTION

       Diffstat  is a program that is useful for reviewing large,
       complex patch files.  It reads  from  one  or  more  input
       files  which  contain  output  from diff, producing a his­
       togram of the total lines changed  for  each  file  refer­
       enced.   If the input filename ends with .Z or .gz, diffs­
       tat will read the uncompressed data via a pipe.

       Diffstat recognizes the most popular types of output  from
       diff:

              unified
                     preferred by the patch utility.

              context
                     best  for readability, but not very compact.

              default
                     not good for much, but simple to generate.

       Diffstat detects the lines that are output by diff to tell
       which  files  are compared, and then counts the markers in
       the first column that denote the type  of  change  (inser­
       tion,  deletion  or modification).  These are shown in the
       histogram as "+", "-" and "!" characters.

       If no filename is given  on  the  command  line,  diffstat
       reads the differences from the standard input.


OPTIONS

       -c     prefix  each  line  of output with "#", making it a
              comment-line for shell scripts.

       -f format
              specify 0 for concise, 1 for normal output.

       -n number
              specify the minimum width used for  filenames.   If
              you don't specify this, diffstat uses the length of
              the longest filename, after stripping  common  pre­
              fixes.

              override  the  logic  that strips common pathnames,
              simulating the patch "-p" option.

       -V     prints the current version number

       -w number
              specify the maximum width of  the  histogram.   The
              plot will never be shorter than 10 columns, just in
              case the filenames get too large.


ENVIRONMENT

       Diffstat runs in a portable UNIX® environment.


FILES

       Diffstat is a single binary module, which uses  no  auxil­
       iary files.


BUGS

       Diffstat  makes a lot of assumptions about the format of a
       diff file.

       There's no easy way to determine  the  degree  of  overlap
       between  the  "before"  and  "after"  displays of modified
       lines.


SEE ALSO

       diff (1).


AUTHOR

       Thomas Dickey (dickey@clark.net).


Man(1) output converted with man2html