php man page for xdiff_file_diff

XDIFF_FILE_DIFF(3)							 1							XDIFF_FILE_DIFF(3)

xdiff_file_diff - Make unified diff of two files

SYNOPSIS
       bool xdiff_file_diff (string  $old_file, string	$new_file, string  $dest, [int	$context = 3], [bool  $minimal = false])

DESCRIPTION
	Makes  an  unified  diff  containing differences between $old_file and $new_file and stores it in $dest file. The resulting file is human-
       readable. An optional $context parameter specifies how many lines of context should be added around each change. Setting $minimal parameter
       to true will result in outputting the shortest patch file possible (can take a long time).

PARAMETERS
	      o $old_file
		- Path to the first file. This file acts as "old" file.

	      o $new_file
		- Path to the second file. This file acts as "new" file.

	      o $dest
		- Path of the resulting patch file.

	      o $context
		- Indicates how many lines of context you want to include in diff result.

	      o $minimal
		- Set this parameter to TRUE if you want to minimalize size of the result (can take a long time).

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

EXAMPLES
       Example #1

	      xdiff_file_diff(3) example

	       The following code makes unified diff of two php files with context length of 2.

	      <?php
	      $old_version = 'my_script.php';
	      $new_version = 'my_new_script.php';

	      xdiff_file_diff($old_version, $new_version, 'my_script.diff', 2);
	      ?>

NOTES
       Note

	       This function doesn't work well with binary files. To make diff of binary files use xdiff_file_bdiff(3)/xdiff_file_rabdiff(3) func-
	      tion.

SEE ALSO
       xdiff_file_patch(3).

PHP Documentation Group 													XDIFF_FILE_DIFF(3)