text::patch(3pm) [debian man page]

Patch(3pm)						User Contributed Perl Documentation						Patch(3pm)

NAME

       Text::Patch - Patches text with given patch

SYNOPSIS

	   use Text::Patch;

	   $output = patch( $source, $diff, STYLE => "Unified" );

	   use Text::Diff;

	   $src  = ...
	   $dst  = ...

	   $diff = diff( $src, $dst, { STYLE => 'Unified' } );

	   $out  = patch( $src, $diff, { STYLE => 'Unified' } );

	   print "Patch successful" if $out eq $dst;

DESCRIPTION

       Text::Patch combines source text with given diff (difference) data.  Diff data is produced by Text::Diff module or by the standard diff
       utility (man diff, see -u option).

       patch( $source, $diff, options... )
	   First argument is source (original) text. Second is the diff data.  Third argument can be either hash reference with options or all the
	   rest arguments will be considered patch options:

	       $output = patch( $source, $diff, STYLE => "Unified", ... );

	       $output = patch( $source, $diff, { STYLE => "Unified", ... } );

	   Options are:

	     STYLE => 'Unified'

	   STYLE can be "Unified", "Context" or "OldStyle".

	   The 'Unified' diff format looks like this:

	     @@ -1,7 +1,6 @@
	     -The Way that can be told of is not the eternal Way;
	     -The name that can be named is not the eternal name.
	      The Nameless is the origin of Heaven and Earth;
	     -The Named is the mother of all things.
	     +The named is the mother of all things.
	     +
	      Therefore let there always be non-being,
		so we may see their subtlety,
	      And let there always be being,
	     @@ -9,3 +8,6 @@
	      The two are the same,
	      But after they are produced,
		they have different names.
	     +They both may be called deep and profound.
	     +Deeper and more profound,
	     +The door of all subtleties!

TODO

	 Interfaces with files, arrays, etc.

AUTHOR

	 Vladi Belperchinov-Shabanski "Cade"

	 <cade@biscom.net> <cade@datamax.bg> <cade@cpan.org>

	 http://cade.datamax.bg

VERSION

	 $Id: Patch.pm,v 1.6 2007/04/07 19:57:41 cade Exp $

perl v5.10.1							    2010-10-04								Patch(3pm)

STG-EDIT(1)							   StGit Manual 						       STG-EDIT(1)

NAME

       stg-edit - edit a patch description or diff

SYNOPSIS

       stg edit [options] [<patch>]

DESCRIPTION

       Edit the description and author information of the given patch (or the current patch if no patch name was given). With --diff, also edit
       the diff.

       The editor is invoked with the following contents:

	   From: A U Thor <author@example.com>
	   Date: creation date

	   Patch description

       If --diff was specified, the diff appears at the bottom, after a separator:

	   ---

	   Diff text

       Command-line options can be used to modify specific information without invoking the editor. (With the --edit option, the editor is invoked
       even if such command-line options are given.)

       If the patch diff is edited but does not apply, no changes are made to the patch at all. The edited patch is saved to a file which you can
       feed to "stg edit --file", once you have made sure it does apply.

OPTIONS

       -d, --diff
	   Edit the patch diff.

       -e, --edit
	   Invoke interactive editor.

       --sign
	   Add a "Signed-off-by:" to the end of the patch.

       --ack
	   Add an "Acked-by:" line to the end of the patch.

       -m MESSAGE, --message MESSAGE
	   Use MESSAGE instead of invoking the editor.

       -f FILE, --file FILE
	   Use the contents of FILE instead of invoking the editor. (If FILE is "-", write to stdout.)

       --save-template FILE
	   Instead of running the command, just write the message template to FILE, and exit. (If FILE is "-", write to stdout.)

	   When driving StGit from another program, it is often useful to first call a command with --save-template, then let the user edit the
	   message, and then call the same command with --file.

       --author "NAME <EMAIL>"
	   Set the author details.

       --authname NAME
	   Set the author name.

       --authemail EMAIL
	   Set the author email.

       --authdate DATE
	   Set the author date.

       -O OPTIONS, --diff-opts OPTIONS
	   Extra options to pass to "git diff".

STGIT

       Part of the StGit suite - see linkman:stg[1]

StGit								    03/13/2012							       STG-EDIT(1)