diff.c File Reference

#include <inttypes.h>
#include <stdbool.h>
#include "nvim/ascii.h"
#include "nvim/buffer.h"
#include "nvim/change.h"
#include "nvim/charset.h"
#include "nvim/cursor.h"
#include "nvim/diff.h"
#include "nvim/eval.h"
#include "nvim/ex_cmds.h"
#include "nvim/ex_docmd.h"
#include "nvim/fileio.h"
#include "nvim/fold.h"
#include "nvim/mark.h"
#include "nvim/mbyte.h"
#include "nvim/memline.h"
#include "nvim/memory.h"
#include "nvim/message.h"
#include "nvim/move.h"
#include "nvim/normal.h"
#include "nvim/option.h"
#include "nvim/os/os.h"
#include "nvim/os/shell.h"
#include "nvim/path.h"
#include "nvim/screen.h"
#include "nvim/strings.h"
#include "nvim/ui.h"
#include "nvim/undo.h"
#include "nvim/vim.h"
#include "nvim/window.h"
#include "xdiff/xdiff.h"

Data Structures
struct	diffin_T
struct	diffout_T
struct	diffhunk_T
struct	diffio_T

Macros
#define	DIFF_FILLER   0x001
#define	DIFF_IBLANK   0x002
#define	DIFF_ICASE   0x004
#define	DIFF_IWHITE   0x008
#define	DIFF_IWHITEALL   0x010
#define	DIFF_IWHITEEOL   0x020
#define	DIFF_HORIZONTAL   0x040
#define	DIFF_VERTICAL   0x080
#define	DIFF_HIDDEN_OFF   0x100
#define	DIFF_INTERNAL   0x200
#define	DIFF_CLOSE_OFF   0x400
#define	DIFF_FOLLOWWRAP   0x800
#define	ALL_WHITE_DIFF   (DIFF_IWHITE | DIFF_IWHITEALL | DIFF_IWHITEEOL)
#define	LBUFLEN   50

Functions
void	diff_buf_delete (buf_T *buf)
void	diff_buf_adjust (win_T *win)
void	diff_buf_add (buf_T *buf)
void	diff_invalidate (buf_T *buf)
void	diff_mark_adjust (linenr_T line1, linenr_T line2, long amount, long amount_after)
void	diff_redraw (bool dofold)
int	diff_internal (void)
void	ex_diffupdate (exarg_T *eap)
void	ex_diffpatch (exarg_T *eap)
void	ex_diffsplit (exarg_T *eap)
void	ex_diffthis (exarg_T *eap)
void	diff_win_options (win_T *wp, int addbuf)
void	ex_diffoff (exarg_T *eap)
void	diff_clear (tabpage_T *tp) FUNC_ATTR_NONNULL_ALL
int	diff_check (win_T *wp, linenr_T lnum)
void	diff_set_topline (win_T *fromwin, win_T *towin)
int	diffopt_changed (void)
bool	diffopt_horizontal (void)
	Check that "diffopt" contains "horizontal". More...
bool	diffopt_hiddenoff (void)
bool	diffopt_closeoff (void)
bool	diffopt_filler (void)
bool	diff_find_change (win_T *wp, linenr_T lnum, int *startp, int *endp) FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ALL
bool	diff_infold (win_T *wp, linenr_T lnum) FUNC_ATTR_PURE FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ARG(1)
void	nv_diffgetput (bool put, size_t count)
	"dp" and "do" commands. More...
void	ex_diffgetput (exarg_T *eap)
bool	diff_mode_buf (buf_T *buf) FUNC_ATTR_PURE FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ARG(1)
int	diff_move_to (int dir, long count)
linenr_T	diff_get_corresponding_line (buf_T *buf1, linenr_T lnum1)
linenr_T	diff_lnum_win (linenr_T lnum, win_T *wp)

Detailed Description

Code for diff'ing two, three or four buffers.

There are three ways to diff:

• Shell out to an external diff program, using files.
• Use the compiled-in xdiff library.
• Let 'diffexpr' do the work, using files.

Macro Definition Documentation

ALL_WHITE_DIFF

#define ALL_WHITE_DIFF   (DIFF_IWHITE | DIFF_IWHITEALL | DIFF_IWHITEEOL)

DIFF_CLOSE_OFF

#define DIFF_CLOSE_OFF   0x400

DIFF_FILLER

#define DIFF_FILLER   0x001

DIFF_FOLLOWWRAP

#define DIFF_FOLLOWWRAP   0x800

DIFF_HIDDEN_OFF

#define DIFF_HIDDEN_OFF   0x100

DIFF_HORIZONTAL

#define DIFF_HORIZONTAL   0x040

DIFF_IBLANK

#define DIFF_IBLANK   0x002

DIFF_ICASE

#define DIFF_ICASE   0x004

DIFF_INTERNAL

#define DIFF_INTERNAL   0x200

DIFF_IWHITE

#define DIFF_IWHITE   0x008

DIFF_IWHITEALL

#define DIFF_IWHITEALL   0x010

DIFF_IWHITEEOL

#define DIFF_IWHITEEOL   0x020

DIFF_VERTICAL

#define DIFF_VERTICAL   0x080

LBUFLEN

#define LBUFLEN   50

Function Documentation

diff_buf_add()

void diff_buf_add

(

buf_T *

buf

)

Add a buffer to make diffs for.

Call this when a new buffer is being edited in the current window where 'diff' is set. Marks the current buffer as being part of the diff and requiring updating. This must be done before any autocmd, because a command may use info about the screen contents.

Parameters

buf	The buffer to add.

diff_buf_adjust()

void diff_buf_adjust

(

win_T *

win

)

Check if the current buffer should be added to or removed from the list of diff buffers.

Parameters

win

diff_buf_delete()

void diff_buf_delete

(

buf_T *

buf

)

Called when deleting or unloading a buffer: No longer make a diff with it.

Parameters

buf

diff_check()

int diff_check	(	win_T *	wp,
		linenr_T	lnum
	)

Check diff status for line "lnum" in buffer "buf":

Returns 0 for nothing special Returns -1 for a line that should be highlighted as changed. Returns -2 for a line that should be highlighted as added/deleted. Returns > 0 for inserting that many filler lines above it (never happens when 'diffopt' doesn't contain "filler"). This should only be used for windows where 'diff' is set.

Parameters

wp
lnum

Returns

diff status.

diff_clear()

void diff_clear

(

tabpage_T *

tp

)

Clear the list of diffblocks for tab page "tp".

Parameters

tp

diff_find_change()

bool diff_find_change	(	win_T *	wp,
		linenr_T	lnum,
		int *	startp,
		int *	endp
	)

Find the difference within a changed line.

Parameters

wp	window whose current buffer to check
lnum	line number to check within the buffer
startp	first char of the change
endp	last char of the change

Returns

true if the line was added, no other buffer has it.

diff_get_corresponding_line()

linenr_T diff_get_corresponding_line	(	buf_T *	buf1,
		linenr_T	lnum1
	)

Finds the corresponding line in a diff.

Parameters

buf1
lnum1

Returns

The corresponding line.

diff_infold()

bool diff_infold	(	win_T *	wp,
		linenr_T	lnum
	)

Check that line "lnum" is not close to a diff block, this line should be in a fold.

Parameters

wp	window containing the buffer to check
lnum	line number to check within the buffer

Returns

false if there are no diff blocks at all in this window.

diff_internal()

int diff_internal

(

void

)

Return true if the options are set to use the internal diff library. Note that if the internal diff failed for one of the buffers, the external diff will be used anyway.

diff_invalidate()

void diff_invalidate

(

buf_T *

buf

)

Mark the diff info involving buffer "buf" as invalid, it will be updated when info is requested.

Parameters

buf

diff_lnum_win()

linenr_T diff_lnum_win	(	linenr_T	lnum,
		win_T *	wp
	)

For line "lnum" in the current window find the equivalent lnum in window "wp", compensating for inserted/deleted lines.

diff_mark_adjust()

void diff_mark_adjust	(	linenr_T	line1,
		linenr_T	line2,
		long	amount,
		long	amount_after
	)

Called by mark_adjust(): update line numbers in "curbuf".

Parameters

line1
line2
amount
amount_after

diff_mode_buf()

bool diff_mode_buf

(

buf_T *

buf

)

Checks that the buffer is in diff-mode.

Parameters

buf	buffer to check.

diff_move_to()

int diff_move_to	(	int	dir,
		long	count
	)

Move "count" times in direction "dir" to the next diff block.

Parameters

dir
count

Returns

FAIL if there isn't such a diff block.

diff_redraw()

void diff_redraw

(

bool

dofold

)

Mark all diff buffers in the current tab page for redraw.

Parameters

dofold

Also recompute the folds

diff_set_topline()

void diff_set_topline	(	win_T *	fromwin,
		win_T *	towin
	)

Set the topline of "towin" to match the position in "fromwin", so that they show the same diff'ed lines.

Parameters

fromwin
towin

diff_win_options()

void diff_win_options	(	win_T *	wp,
		int	addbuf
	)

Set options in window "wp" for diff mode.

Parameters

addbuf

Add buffer to diff.

diffopt_changed()

int diffopt_changed

(

void

)

This is called when 'diffopt' is changed.

Returns

diffopt_closeoff()

bool diffopt_closeoff

(

void

)

diffopt_filler()

bool diffopt_filler

(

void

)

diffopt_hiddenoff()

bool diffopt_hiddenoff

(

void

)

diffopt_horizontal()

bool diffopt_horizontal

(

void

)

Check that "diffopt" contains "horizontal".

ex_diffgetput()

void ex_diffgetput

(

exarg_T *

eap

)

":diffget" and ":diffput"

Parameters

eap

ex_diffoff()

void ex_diffoff

(

exarg_T *

eap

)

Set options not to show diffs. For the current window or all windows. Only in the current tab page.

Parameters

eap

ex_diffpatch()

void ex_diffpatch

(

exarg_T *

eap

)

Create a new version of a file from the current buffer and a diff file.

The buffer is written to a file, also for unmodified buffers (the file could have been produced by autocommands, e.g. the netrw plugin).

Parameters

eap

ex_diffsplit()

void ex_diffsplit

(

exarg_T *

eap

)

Split the window and edit another file, setting options to show the diffs.

Parameters

eap

ex_diffthis()

void ex_diffthis

(

exarg_T *

eap

)

ex_diffupdate()

void ex_diffupdate

(

exarg_T *

eap

)

Completely update the diffs for the buffers involved.

When using the external "diff" command the buffers are written to a file, also for unmodified buffers (the file could have been produced by autocommands, e.g. the netrw plugin).

Parameters

eap	can be NULL

nv_diffgetput()

void nv_diffgetput	(	bool	put,
		size_t	count
	)

"dp" and "do" commands.