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

FreeBSD Manual Pages

  
 
  

home | help
PORTFIX(1)		    General Commands Manual		    PORTFIX(1)

NAME
       portfix -- macro	to execute three programs to create a ports patch

SYNOPSIS
       portfix original

DESCRIPTION
       portfix is a wrapper.  It consecutively runs:

       1.   dupe original
       2.   <editor> original
       3.   genpatch original

       If  PORTEDITOR  is defined in the environment then that program will be
       used to edit [original] file.  If PORTEDITOR is not defined but	EDITOR
       is  defined, then the EDITOR program will be invoked.  If neither vari-
       able is defined in the environment, then	vi(1) will be invoked for  the
       edit step.

       portfix	should be launched when	the current working directory is equal
       to the port's WRKSRC, and [original] should be a	relative path to  file
       that  needs  a  patch.  Assuming	changes	are saved after	the editor ap-
       pears, a	patch file will	be automatically generated in the proper  diff
       format  with  the standard "make	makepatch" naming convention.  It only
       needs to	be moved to the	port's "files" directory to be used.

       If portfix is launched outside of the port's WRKSRC, then  diff	output
       will still be generated,	but it will be sent to stdout rather than to a
       file.   This  will  also	 occur when the	port is	located	outside	of the
       standard	tree.

ERRORS
       The script will abort if	the number of arguments	does not equal one, or
       if the one argument is not an existing regular file.

       If the editor is	closed without making changes, no patch	will  be  cre-
       ated.   However,	 the duplicated	file will exist.  If the script	is run
       again, it will detect the duplicate and create a	second duplicate  with
       the .intermediate extension.  See genpatch(1) for more information.

ENVIRONMENT
       PORTEDITOR  First  priority  editor  to	use  for  modifying file to be
		   patched

       EDITOR	   Second priority editor to use  for  modifying  file	to  be
		   patched

SEE ALSO
       dupe(1),	genpatch(1)

HISTORY
       This  script was	inspired by pkgsrc's pkgdiff suite although it works a
       bit differently.	 It was	written	by  John  Marino  <marino@freebsd.org>
       and  used for a couple of years on DragonFly's DPorts before being for-
       mally imported into FreeBSD Ports Collection.

FreeBSD	ports 15.0		  17 May 2015			    PORTFIX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=portfix&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help