unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

diffmk(1)                        User Commands                       diffmk(1)



NAME
       diffmk - mark differences between versions of a troff input file

SYNOPSIS
       diffmk oldfile newfile markedfile

DESCRIPTION
       diffmk compares two versions of a file and creates a third version that
       includes "change mark" (.mc) commands for nroff(1) and  troff(1).  old-
       file  and newfile are the old and new versions of the file. diffmk gen-
       erates markedfile, which, contains the text from newfile with  troff(1)
       "change mark" requests (.mc) inserted where  newfile differs from  old-
       file. When markedfile is formatted, changed or inserted text  is  shown
       by  | at the right margin of each line. The position of deleted text is
       shown by a single *.

USAGE
       See largefile(5) for the description of the  behavior  of  diffmk  when
       encountering files greater than or equal to 2 Gbyte ( 2**31 bytes).

EXAMPLES
       Example 1: An example of the diffmk command.

       diffmk  can also be used in conjunction with the proper  troff requests
       to produce program listings with marked changes. In the following  com-
       mand line:

       example% diffmk old.c new.c marked.c ; nroff reqs marked.c | pr

       the file reqs contains the following troff requests:

       .pl 1
       .ll 77
       .nf
       .eo
       .nh

       which  eliminate page breaks, adjust the line length, set no-fill mode,
       ignore escape characters, and turn off hyphenation, respectively.

       If the characters  | and * are inappropriate, you might run  markedfile
       through  sed(1) to globally change them.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWdoc


SEE ALSO
       diff(1), nroff(1), sed(1), troff(1), attributes(5), largefile(5)

BUGS
       Aesthetic considerations may dictate manual adjustment of some  output.
       File  differences  involving only formatting requests may produce unde-
       sirable output, that is, replacing .sp by .sp 2 will produce a  "change
       mark" on the preceding or following line of output.



SunOS 5.10                        14 Sep 1992                        diffmk(1)