head	1.26;
access;
symbols;
locks; strict;
comment	@# @;


1.26
date	2006.11.24.10.21.22;	author foonly;	state Exp;
branches;
next	1.25;

1.25
date	2006.05.16.07.04.39;	author foonly;	state Exp;
branches;
next	1.24;

1.24
date	2005.12.02.03.33.08;	author foonly;	state Exp;
branches;
next	1.23;

1.23
date	2005.07.01.00.45.46;	author foonly;	state Exp;
branches;
next	1.22;

1.22
date	2005.03.13.07.10.17;	author foonly;	state Exp;
branches;
next	1.21;

1.21
date	2004.11.25.02.46.36;	author foonly;	state Exp;
branches;
next	1.20;

1.20
date	2004.11.23.12.13.44;	author foonly;	state Exp;
branches;
next	1.19;

1.19
date	2004.11.23.11.11.23;	author foonly;	state Exp;
branches;
next	1.18;

1.18
date	2004.11.14.20.41.02;	author foonly;	state Exp;
branches;
next	1.17;

1.17
date	2004.11.10.23.41.06;	author foonly;	state Exp;
branches;
next	1.16;

1.16
date	2004.11.10.23.37.01;	author foonly;	state Exp;
branches;
next	1.15;

1.15
date	2004.11.10.23.31.12;	author foonly;	state Exp;
branches;
next	1.14;

1.14
date	2004.11.10.23.22.11;	author foonly;	state Exp;
branches;
next	1.13;

1.13
date	2004.10.21.12.53.48;	author foonly;	state Exp;
branches;
next	1.12;

1.12
date	2004.10.21.12.49.59;	author foonly;	state Exp;
branches;
next	1.11;

1.11
date	2004.10.21.08.46.00;	author foonly;	state Exp;
branches;
next	1.10;

1.10
date	2004.10.21.06.21.14;	author foonly;	state Exp;
branches;
next	1.9;

1.9
date	2004.10.21.06.20.08;	author foonly;	state Exp;
branches;
next	1.8;

1.8
date	2004.09.28.03.37.18;	author foonly;	state Exp;
branches;
next	1.7;

1.7
date	2004.09.27.14.13.09;	author foonly;	state Exp;
branches;
next	1.6;

1.6
date	2004.09.27.14.10.05;	author foonly;	state Exp;
branches;
next	1.5;

1.5
date	2004.09.27.13.52.02;	author foonly;	state Exp;
branches;
next	1.4;

1.4
date	2004.09.27.13.26.01;	author foonly;	state Exp;
branches;
next	1.3;

1.3
date	2004.09.27.13.17.41;	author foonly;	state Exp;
branches;
next	1.2;

1.2
date	2004.09.27.13.17.32;	author foonly;	state Exp;
branches;
next	1.1;

1.1
date	2004.09.27.13.16.39;	author foonly;	state Exp;
branches;
next	;


desc
@Blame home page
@


1.26
log
@Revision 1.3.1
@
text
@**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.25 2006/05/16 07:04:39 foonly Exp mchapman $
@


1.25
log
@CVS host has changed
@
text
@d15 5
a19 3
  - [blame-1.3.tar.gz|http://prdownloads.sourceforge.net/blame/blame-1.3.tar.gz?download]     (gzipped tarball, 429 kB)
  - [blame-1.3-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-1.3-1.i386.rpm?download] (i386 RPM for Fedora, 70 kB)
  - [blame-1.3-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-1.3-1.src.rpm?download]  (source RPM, 433 kB)
a24 3
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__1__3] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/ChangeLog?rev=release__1__3] are available
online.

d98 1
a98 1
$Id: index.txt,v 1.24 2005/12/02 03:33:08 foonly Exp foonly $
@


1.24
log
@Revision 1.3
@
text
@d30 2
a31 2
  $ cvs -d:pserver:anonymous@@cvs.sf.net:/cvsroot/blame login
  %Logging in to :pserver:anonymous@@cvs.sf.net:2401/cvsroot/blame
d34 1
a34 1
  $ cvs -d:pserver:anonymous@@cvs.sf.net:/cvsroot/blame checkout blame
d99 1
a99 1
$Id: index.txt,v 1.23 2005/07/01 00:45:46 foonly Exp foonly $
@


1.23
log
@Revision 1.2
@
text
@d15 3
a17 3
  - [blame-1.2.tar.gz|http://prdownloads.sourceforge.net/blame/blame-1.2.tar.gz?download]     (gzipped tarball, 412 kB)
  - [blame-1.2-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-1.2-1.i386.rpm?download] (i386 RPM for Fedora, 68 kB)
  - [blame-1.2-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-1.2-1.src.rpm?download]  (source RPM, 415 kB)
d23 1
a23 1
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__1__2] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/ChangeLog?rev=release__1__2] are available
d99 1
a99 1
$Id: index.txt,v 1.22 2005/03/13 07:10:17 foonly Exp foonly $
@


1.22
log
@Add link to sunfreeware.com for Solaris package
@
text
@d15 3
a17 3
  - [blame-1.1.tar.gz|http://prdownloads.sourceforge.net/blame/blame-1.1.tar.gz?download]     (gzipped tarball, 387 kB)
  - [blame-1.1-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-1.1-1.i386.rpm?download] (i386 RPM for Fedora, 69 kB)
  - [blame-1.1-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-1.1-1.src.rpm?download]  (source RPM, 390 kB)
d23 1
a23 1
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__1__1] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/ChangeLog?rev=release__1__1] are available
d99 1
a99 1
$Id: index.txt,v 1.21 2004/11/25 02:46:36 foonly Exp foonly $
@


1.21
log
@Revision 1.1
@
text
@d19 4
d99 1
a99 1
$Id: index.txt,v 1.20 2004/11/23 12:13:44 foonly Exp foonly $
@


1.20
log
@Rebuild RPM because GCC 3.4 has bugs
@
text
@d15 3
a17 3
  - [blame-1.0.tar.gz|http://prdownloads.sourceforge.net/blame/blame-1.0.tar.gz?download]     (gzipped tarball, 387 kB)
  - [blame-1.0-2.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-1.0-2.i386.rpm?download] (i386 RPM for Fedora, 72 kB)
  - [blame-1.0-2.src.rpm|http://prdownloads.sourceforge.net/blame/blame-1.0-2.src.rpm?download]  (source RPM, 390 kB)
d19 1
a19 1
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__1__0] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/ChangeLog?rev=release__1__0] are available
d95 1
a95 1
$Id: index.txt,v 1.19 2004/11/23 11:11:23 foonly Exp foonly $
@


1.19
log
@Release 1.0
@
text
@d16 2
a17 2
  - [blame-1.0-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-1.0-1.i386.rpm?download] (i386 RPM for Fedora, 70 kB)
  - [blame-1.0-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-1.0-1.src.rpm?download]  (source RPM, 389 kB)
d95 1
a95 1
$Id: index.txt,v 1.18 2004/11/14 20:41:02 foonly Exp foonly $
@


1.18
log
@Missing module name
@
text
@d15 3
a17 3
  - [blame-0.3.tar.gz|http://prdownloads.sourceforge.net/blame/blame-0.3.tar.gz?download]     (gzipped tarball, 428 kB)
  - [blame-0.3-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.3-1.i386.rpm?download] (i386 RPM for Fedora, 76 kB)
  - [blame-0.3-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-0.3-1.src.rpm?download]  (source RPM, 430 kB)
d19 1
a19 1
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__0__3] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/ChangeLog?rev=release__0__3] are available
d95 1
a95 1
$Id: index.txt,v 1.17 2004/11/10 23:41:06 foonly Exp foonly $
@


1.17
log
@Fix ChangeLog link
@
text
@d30 1
a30 1
  $ cvs -d:pserver:anonymous@@cvs.sf.net:/cvsroot/blame checkout
d95 1
a95 1
$Id: index.txt,v 1.16 2004/11/10 23:37:01 foonly Exp foonly $
@


1.16
log
@Fix underscores in links
@
text
@d19 1
a19 1
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__0__3] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release__0__3] are available
d95 1
a95 1
$Id: index.txt,v 1.15 2004/11/10 23:31:12 foonly Exp foonly $
@


1.15
log
@Link to NEWS and ChangeLog
@
text
@d19 1
a19 1
Project [news|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release_0_3] and the detailed [ChangeLog|http://cvs.sourceforge.net/viewcvs.py/blame/blame/NEWS?rev=release_0_3] are available
d95 1
a95 1
$Id: index.txt,v 1.14 2004/11/10 23:22:11 foonly Exp foonly $
@


1.14
log
@New release
@
text
@d19 3
d95 1
a95 1
$Id: index.txt,v 1.13 2004/10/21 12:53:48 foonly Exp foonly $
@


1.13
log
@Obfuscate email
@
text
@d15 3
a17 3
  - [blame-0.2.tar.gz|http://prdownloads.sourceforge.net/blame/blame-0.2.tar.gz?download]     (gzipped tarball, 419 kB)
  - [blame-0.2-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.2-1.i386.rpm?download] (i386 RPM for Fedora, 72 kB)
  - [blame-0.2-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-0.2-1.src.rpm?download]  (source RPM, 421 kB)
d46 1
a46 1
Alternatively, you can specify the RCS file:
d92 1
a92 1
$Id: index.txt,v 1.12 2004/10/21 12:49:59 foonly Exp foonly $
@


1.12
log
@It's not really alpha any more
@
text
@d84 1
a84 1
[foonly@@users.sourceforge.net|mailto:foonly@@users.sourceforge.net].
d92 1
a92 1
$Id: index.txt,v 1.11 2004/10/21 08:46:00 foonly Exp foonly $
@


1.11
log
@Binary RPM is for Fedora
@
text
@d67 1
a67 1
**5. It doesn't work. Where can I get help?**
d69 16
a84 20
This version of *Blame* is ALPHA only. I have compiled and
run it on a variety of different systems (multiple
architectures and platforms), but I expect it still has
some undiscovered bugs.

The *Blame* tarball comes with an integrated test suite.
After compiling it, simply run _make check_.

I would appreciate reports of any bugs you encounter. If
possible, try to reproduce the problem on a version of
*Blame* with debugging enabled (pass the _--enable-debug_
option to _configure_ when compiling). Debug builds have
assertions enabled, and this can better indicate the
location of the bug.

Please mail bug reports to [foonly@@users.sourceforge.net|mailto:foonly@@users.sourceforge.net].
If you are having trouble compiling *Blame* I will mostly
likely need the _config.log_ file generated by _configure_.
If *Blame* dumps a core file, please include a stack backtrace
also.
d92 1
a92 1
$Id: index.txt,v 1.10 2004/10/21 06:21:14 foonly Exp foonly $
@


1.10
log
@Add ?download query string to download links
@
text
@d16 1
a16 1
  - [blame-0.2-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.2-1.i386.rpm?download] (i386 RPM, 72 kB)
d96 1
a96 1
$Id: index.txt,v 1.9 2004/10/21 06:20:08 foonly Exp foonly $
@


1.9
log
@New release
@
text
@d15 3
a17 3
  - [blame-0.2.tar.gz|http://prdownloads.sourceforge.net/blame/blame-0.2.tar.gz]     (gzipped tarball, 419 kB)
  - [blame-0.2-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.2-1.i386.rpm] (i386 RPM, 72 kB)
  - [blame-0.2-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-0.2-1.src.rpm]  (source RPM, 421 kB)
d96 1
a96 1
$Id: index.txt,v 1.8 2004/09/28 03:37:18 foonly Exp foonly $
@


1.8
log
@Fix prompt next to --help option.
Indicate that CVS is the latest snapshot.
Move the output part into a new section.
Point out the test suite.
@
text
@d15 3
a17 3
  - [blame-0.1.tar.gz|http://prdownloads.sourceforge.net/blame/blame-0.1.tar.gz]     (gzipped tarball, 394 kB)
  - [blame-0.1-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.1-1.i386.rpm] (i386 RPM, 57 kB)
  - [blame-0.1-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-0.1-1.src.rpm]  (source RPM, 396 kB)
d96 1
a96 1
$Id: index.txt,v 1.7 2004/09/27 14:13:09 foonly Exp foonly $
@


1.7
log
@s/HTML webpage//
@
text
@a10 11
As an example, the source file for this web page is itself
stored in RCS. So I was first annotated it:

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

Then I passed *Blame*'s output through a [simple pretty-printer|/example/pretty.pl]
to generate the HTML.

d19 3
a21 3
Alternatively, you can checkout *Blame* from CVS. If you
choose this option you will need the GNU Autotools, Flex and
GNU Bison.
d37 5
d53 10
a62 2
A variety of command-line options are available. To see
the full list, use _--help_:
d64 2
a65 1
  * blame --help
d67 1
a67 1
**4. It doesn't work. Where can I get help?**
d74 3
d90 1
a90 1
**5. What license is *Blame* released under?**
d96 1
a96 1
$Id: index.txt,v 1.6 2004/09/27 14:10:05 foonly Exp foonly $
@


1.6
log
@Clarify how webpage was generated.
Add Id line.
@
text
@d20 1
a20 1
to generate the HTML webpage.
d90 1
a90 1
$Id$
@


1.5
log
@Fix filename
@
text
@d12 1
a12 2
stored in RCS. It was generated by running *Blame* on the
source file:
d19 1
a19 1
The output was passed through a [simple pretty-printer|/example/pretty.pl]
d89 2
@


1.4
log
@Remove extraneous >.
@
text
@d28 1
a28 1
  - [blame-0.1-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.1-1.i386-rpm] (i386 RPM, 57 kB)
@


1.3
log
@Enter file sizes.
@
text
@d79 1
a79 1
Please mail bug reports to [foonly@@users.sourceforge.net|mailto:foonly@@users.sourceforge.net]>.
@


1.2
log
@Mark up text.
@
text
@d27 3
a29 3
  - [blame-0.1.tar.gz|http://prdownloads.sourceforge.net/blame/blame-0.1.tar.gz]     (gzipped tarball, XXX kB)
  - [blame-0.1-1.i386.rpm|http://prdownloads.sourceforge.net/blame/blame-0.1-1.i386-rpm] (i386 RPM, XXX kB)
  - [blame-0.1-1.src.rpm|http://prdownloads.sourceforge.net/blame/blame-0.1-1.src.rpm]  (source RPM, XXX kB)
@


1.1
log
@Initial revision
@
text
@d1 1
a1 1
1. What is it?
d3 2
a4 2
Blame displays the last modification for each line in an
RCS file. It is the RCS equivalent of CVS's annotate
d16 1
a16 1
  index.txt  index.txt,v
d18 1
a18 1
  ...
d20 1
a20 1
The output was passed through a simple pretty-printer
d23 1
a23 1
2. Where can I get it?
d25 1
a25 1
You can download Blame here:
d27 3
a29 3
  - blame-0.1.tar.gz
  - blame-0.1-1.i386.rpm
  - blame-0.1-1.src.rpm
d31 1
a31 1
Alternatively, you can checkout Blame from CVS. If you
d36 2
a37 2
  Logging in to :pserver:anonymous@@cvs.sf.net:2401/cvsroot/blame
  CVS password:
d40 4
a43 4
  cvs checkout: Updating blame
  .
  . etc
  .
d47 1
a47 1
3. How do I use it?
d49 1
a49 1
To view annotations for a particular filename:
d51 1
a51 1
  $ blame filename
d55 1
a55 1
  $ blame filename,v
d57 1
a57 1
Multiple filenames can be specified, and Blame will
d61 1
a61 1
the full list, use --help:
d65 1
a65 1
4. It doesn't work. Where can I get help?
d67 1
a67 1
This version of Blame is ALPHA only. I have compiled and
d74 1
a74 1
Blame with debugging enabled (pass the --enable-debug
d79 3
a81 3
Please mail bug reports to foonly@@users.sourceforge.net.
If you are having trouble compiling Blame I will mostly
likely need the config.log file generated by configure.
d85 1
a85 1
5. What license is Blame released under?
d87 1
a87 1
Blame is released under the terms and conditions of the
@