0README

nrchbar
|-- 0-README
|-- Makefile
|-- nrchbar
|-- nrchbar.1
`-- nrchbar.c


NAME
       nrchbar - insert n/troff-style change bars in a file
SYNOPSIS
       nrchbar [ -a ] [ -b ] [ -d ] [ oldfile ] newfile
DESCRIPTION
       Nrchbar  inserts commands suitable for nroff(1) or troff(1) (hereafter,
       "*roff") to produce "change bars" denoting differences between  oldfile
       and newfile.  It sends the result to standard output.

       If  oldfile  is defaulted, nrchbar assumes that its standard input will
       contain differences between oldfile and newfile in diff(1) format.

       By default, nrchbar ignores changes to sections containing nothing  but
       *roff commands, which it takes to be any lines beginning with ".".  You
       can override this with the -a option.

       Nrchbar inserts *roff ".mc" commands to provide the change bars.   This
       will  place a character to the far right of each changed section.  This
       character is a "+" for added sections, a "|" for modified sections, and
       a "-" for deleted sections.

       By  default,  the  text of deleted sections does not appear, but the -d
       option will cause it to be inserted, surrounded by "[[" and "]]".

       Also by default, nrchbar  puts  a  break  (".br")  command  after  each
       changed  section.  This is the only way to guarantee that deletions and
       small changes get flagged.  The -b option directs the  program  not  to
       insert these breaks.  It makes the text look more like *roffed newfile,
       but means that some change bars won't appear where they should.
SEE ALSO
       nroff(1), troff(1)
AUTHOR
	Bob Lewis
	Test Systems Strategies, Inc.
	8205 SW Creekside Pl.
	Beaverton, OR  97005
	(503) 643-9281
	...!tektronix!tessi!bobl   or   bobl@tessi.UUCP


John Rupley
 rupley@u.arizona.edu -or- jar@rupley.com
 30 Calle Belleza, Tucson AZ 85716 - (520) 325-4533; fax - (520) 325-4991
 Dept. Biochemistry & Molecular Biophysics, Univ. Arizona, Tucson AZ 85721