unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



diffmk(1)							    diffmk(1)



NAME

  diffmk - Marks differences between files

SYNOPSIS

  diffmk [-b] [-ab'mark'] [-ae'mark'] [-cb'mark'] [-ce'mark'] [-db'mark']
  [-de'mark'] file1 file2

  The diffmk command compares two versions of a	file and creates a new file
  that marks the differences.

OPTIONS

  -ab'mark'
      Uses mark	to mark	where added lines begin.

  -ae'mark'
      Uses mark	to mark	where added lines end.

  -b  Ignores differences that are only	changes	in tabs	or spaces on a line.

  -cb'mark'
      Uses mark	to mark	where changed lines begin.

  -ce'mark'
      Uses mark	to mark	where changed lines end.

  -db'mark'
      Uses mark	to mark	where deleted lines begin.

  -de'mark'
      Uses mark	to mark	where deleted lines end.

DESCRIPTION

  The file1 and	file2 variables	are the	old and	new versions of	the file,
  respectively.	 The diffmk command compares them and writes a new version to
  standard output, which can be	redirected to a	file. This output contains
  the lines of file2 marked with nroff change mark requests (.mc), or with
  the marks you	specify	with the -ab, -ae, -cb,	-ce, -db, and -de options.

  When output containing .mc requests is formatted with	nroff, changed or
  inserted lines are marked by a | (vertical bar) at the right margin of each
  line.	An * (asterisk)	indicates that a line was deleted.

  If the DIFFMARK environment variable is defined, it names a command string
  that diffmk uses to compare the files.  (Normally, diffmk uses the diff
  command.)  For example, you might set	DIFFMARK to diff -h in order to
  better handle	extremely large	files.




EXAMPLES

   1.  To mark the differences between two versions of a text file, enter:
	    diffmk -ab'>&gt;I:' -ae'<&lt;I' -cb'>&gt;C' -ce'<&lt;C' -db'>&gt;D' -de'<&lt;D' \
		    chap1.old chap1 >&gt;chap1.diffs

       This causes diffmk to create a copy of chap1 called chap1.diffs,	show-
       ing differences between chap1.old and chap1.  Additions of one or more
       lines are marked	with >&gt;I	and <&lt;I,	changed	lines are marked with >&gt;C and
       <&lt;C, and deletions are marked with >&gt;D and	<&lt;D.

   2.  To mark differences with	nroff requests,	enter:
	    diffmk chap1.old chap1 >&gt; chap1.nroff

       This produces a copy of chap1 called chap1.nroff	containing nroff
       change mark requests to identify	text that was added to,	changed, or
       deleted from chap1.old.

   3.  To use different	nroff marking requests and ignore changes in white
       space, enter:
	    diffmk  -b	-cb'.mc	 %'  chap1.old	chap1  >&gt; chap1.nroff

       This imbeds commands that mark changes with % (percent sign), addi-
       tions with | (the default, because no -a	option is specified), and
       deletions with *	(the default).	It does	not mark changes that only
       involve a different number of spaces or tabs between words (-b).

SEE ALSO

  Commands:  diff(1), nroff(1)