DragonFly On-Line Manual Pages

Search: Section:  

PORTFIX(1)             DragonFly 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 variable 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 appears, 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 created.
     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 formally
     imported into FreeBSD Ports Collection.

DragonFly 6.5-DEVELOPMENT         17 May 2015        DragonFly 6.5-DEVELOPMENT

Search: Section: