Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PATCHVIEW(1)			   Man pages			  PATCHVIEW(1)

NAME
       patchview - Without options, show numbered files	modified by the	patch.
       With options, behave as filterdiff.

SYNOPSIS
       patchview [[-n] | [--line-number]] [[-p n] | [--strip-match=n]]
		 [--strip=n] [--addprefix=PREFIX] [[-s]	| [--status]] [[-E] |
		 [--empty-files-as-removed]] [[-i PATTERN] |
		 [--include=PATTERN]] [[-x PATTERN] | [--exclude=PATTERN]]
		 [[-z] | [--decompress]] [[-# RANGE] | [--hunks=RANGE]]
		 [--lines=RANGE] [[-FRANGE] | [--files=RANGE]] [[-H] |
		 [--with-filename]] [[-h] | [--no-filename]] [[-v] |
		 [--verbose]...] [file...]

       patchview {[--help] | [--version] | [--filter ...] | [--grep ...]}

DESCRIPTION
       So what is patchview? It	is a wrapper of	filterdiff for use with
       numbered	files.

	   patchview

       (without	args) is equivalent to:	lsdiff --number

	   patchview -F2-

       (or with	any other args)	is equivalent to: filterdiff -F2- (or whatever
       arguments are supplied)

       There are two scripts for working with git (gitdiff and gitdiffview)
       and two for svn (svndiff	and svndiffview).

	   svndiff

	   gitdiff

       (without	args) will give	the list of files modified

	   svndiff -F1

	   gitdiff -F1

       will show the patch of file #1

	   svndiffview

	   gitdiffview

       pipe all	patches	through	filterdiff to vim - -R (in read-only mode,
       easy to quit), showing complete patch with color.

	   svndiffview -F2

	   gitdiffview -F2

       (or any other args) will	pipe patch of file #2 to vim - -R

OPTIONS
       -n, --line-number
	   Display the line number that	each patch begins at. If verbose
	   output is requested (using -nv), each hunk of each patch is listed
	   as well.

	   For each file that is modified, a line is generated containing the
	   line	number of the beginning	of the patch, followed by a Tab
	   character, followed by the name of the file that is modified. If -v
	   is given once, following each of these lines	will be	one line for
	   each	hunk, consisting of a Tab character, the line number that the
	   hunk	begins at, another Tab character, the string "Hunk #", and the
	   hunk	number (starting at 1).

	   If the -v is	given twice in conjunction with	-n (i.e.  -nvv), the
	   format is slightly different: hunk-level descriptive	text is	shown
	   after each hunk number, and the --number-files option is enabled.

       -N, --number-files
	   File	numbers	are listed, beginning at 1, before each	filename.

       -# RANGE, --hunks=RANGE
	   Only	list hunks within the specified	RANGE. Hunks are numbered from
	   1, and the range is a comma-separated list of numbers or
	   "first-last"	spans, optionally preceded by a	modifier 'x' which
	   inverts the entire range; either the	first or the last in the span
	   may be omitted to indicate no limit in that direction.

       --lines=RANGE
	   Only	list hunks that	contain	lines from the original	file that lie
	   within the specified	RANGE. Lines are numbered from 1, and the
	   range is a comma-separated list of numbers or "first-last" spans,
	   optionally preceded by a modifier 'x' which inverts the entire
	   range; either the first or the last in the span may be omitted to
	   indicate no limit in	that direction.

       -F=RANGE, --files=RANGE
	   Only	list files indicated by	the specified RANGE. Files are
	   numbered from 1 in the order	they appear in the patch input,	and
	   the range is	a comma-separated list of numbers or "first-last"
	   spans, optionally preceded by a modifier 'x'	which inverts the
	   entire range; either	the first or the last in the span may be
	   omitted to indicate no limit	in that	direction.

       -p n, --strip-match=n
	   When	matching, ignore the first n components	of the pathname.

       --strip=n
	   Remove the first n components of the	pathname before	displaying it.

       --addprefix=PREFIX
	   Prefix the pathname with PREFIX before displaying it.

       -s, --status
	   Show	file additions,	modifications and removals. A file addition is
	   indicated by	a "+", a removal by a "-", and a modification by a
	   "!".

       -E, --empty-files-as-removed
	   Treat empty files as	absent for the purpose of displaying file
	   additions, modifications and	removals.

       -i PATTERN, --include=PATTERN
	   Include only	files matching PATTERN.

       -x PATTERN, --exclude=PATTERN
	   Exclude files matching PATTERN.

       -z, --decompress
	   Decompress files with extensions .gz	and .bz2.

       -H, --with-filename
	   Print the name of the patch file containing each patch.

       -h, --no-filename
	   Suppress the	name of	the patch file containing each patch.

       -v, --verbose
	   Verbose output.

       --help
	   Display a short usage message.

       --version
	   Display the version number of patchview.

       --filter
	   Behave like filterdiff(1) instead.

       --grep
	   Behave like grepdiff(1) instead.

SEE ALSO
       lsdiff(1),filterdiff(1),	grepdiff(1)

EXAMPLES
       We can make the following one-line script with the name difftotrunk.sh,
       to view the differences of two directories or svn repos (trunk and .)

	   diff	../trunk . -ru -x .svn | patchview "$@"

	   ./difftotrunk.sh , will show	all different files and	his number.

	   ./difftotrunk.sh -F3,4 , will show the differences of files #3 and #4 only.

	   ./difftotrunk.sh -F3	-#1 , will show	only hunk #1 of	file #3.

	   ./difftotrunk.sh -F3	-#x1 , will show the differences of files #3 without hunk #1 (x	means that exclude).

AUTHOR
       Tim Waugh <twaugh@redhat.com>
	   Package maintainer

patchutils			  02 Jul 2020			  PATCHVIEW(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | EXAMPLES | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=patchview&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help