**1. What is it?**

*Blame* displays the last modification for each line in an
RCS file. It is the RCS equivalent of CVS's _annotate_
command.

An annotated RCS file describes the revision and date in
which each line was added to the file, and the author of
each line.

**2. Where can I get it?**

You can download *Blame* here:

  - [blame-1.3.1.tar.gz|http://prdownloads.sourceforge.net/blame/blame-1.3.1.tar.gz?download]         (gzipped tarball, 483 kB)
  - [blame-1.3.1-1.fc6.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-1.3.1-1.fc6.i386.rpm?download] (i386 RPM for Fedora Core 6, 75 kB)
  - [blame-1.3.1-1.fc6.src.rpm|http://prdownloads.sourceforge.net/blame/blame-1.3.1-1.fc6.src.rpm?download]  (source RPM for Fedora Core 6, 487 kB)

Packages for FC4 and FC5 can be found [here|http://sourceforge.net/project/showfiles.php?group__id=118555&package__id=129127&release__id=466137#files].

A precompiled Solaris package is available from
[sunfreeware.com|http://sunfreeware.com/]. Thanks to Steven Christensen for building
this.

Alternatively, you can checkout the latest snapshot of
*Blame* from CVS. If you choose this option you will need
the GNU Autotools, Flex and GNU Bison.

  $ cvs -d:pserver:anonymous@blame.cvs.sourceforge.net:/cvsroot/blame login
  %Logging in to :pserver:anonymous@blame.cvs.sourceforge.net:2401/cvsroot/blame
  %CVS password:
    (no password; just press Enter)
  $ cvs -d:pserver:anonymous@blame.cvs.sourceforge.net:/cvsroot/blame checkout blame
  %cvs checkout: Updating blame
  %.
  %. etc
  %.
  $ cd blame
  $ autoreconf

**3. How do I use it?**

A variety of command-line options are available. To see
the full list, use _--help_:

  $ blame --help

To view annotations for _filename_:

  $ blame _filename_

Or for a specific RCS file:

  $ blame _filename_,v

Multiple filenames can be specified, and *Blame* will
annotate them all.

**4. What sort of output does it produce?**

The design of this web page imitates the output of *Blame*.
In fact, the source file for this web page is maintained
with RCS:

  $ ls
  %[index.txt|/example/index.txt]  [index.txt,v|/example/index.txt,v]
  $ blame index.txt
  %%

The output from *Blame* was passed through a [pretty-printer|/example/pretty.pl]
to generate the HTML.

**5. It doesn't work. How do I fix it?**

If *Blame* doesn't compile on your system please send me
the _config.log_ file generated by _configure_, and a
description of which bits don't compile.

If you're having trouble running *Blame* on certain files
you might want to try the test suite in the tarball. Simply
run _make check_ after compilation.

If *Blame* segfaults and you're feeling adventurous, you
can enable full debugging by using the _--enable-debug_
option in _configure_. This turns on a bunch of assertions
-- hopefully this will turn the segfault into an
identifiable assertion failure.

If you're still stuck, feel free to mail bug reports to
[foonly (AT) users (DOT) sourceforge (DOT) net|mailto:foonly@users.sourceforge.net].

**6. What license is *Blame* released under?**

*Blame* is released under the terms and conditions of the
GNU General Public License version 2. Please read the
_COPYING_ file carefully.

$Id: index.txt,v 1.26 2006/11/24 10:21:22 foonly Exp $