freebsd-ports/Tools/scripts/README.getpatch
2012-08-23 14:07:48 +00:00

83 lines
2.1 KiB
Text

GETPATCH(1) FreeBSD General Commands Manual GETPATCH(1)
NAME
getpatch - An utility to download patch attachments on Bug Tracking Systems
SYNOPSIS
getpatch [-h] [--mode gnats|bz] [--last] [--stdout] <pr-id>
DESCRIPTION
getpatch is an utility to download patch attachments on Bug Tracking
Systems such Gnats and Bugzilla. It currently supports retrieving multiple
attachments from the command line.
Its written in python witout any extra dependencies. Compare to getpr
utility it does web scrapping on BTS web interface in order to retrieve
patchs attached.
The following command line options are supported:
-h Prints a multi-line help message and exits
--mode Specify BTS mode. Supported are "gnats" or "bz".
--last Only retrieve last iteration patch attached.
--stdout Output patch to stdout file descriptor.
Options can be used after or before the <pr-id> on the command line.
FILES
${PORTSDIR}/Tools/scripts/getpatch
EXAMPLES
Retrieve all patchs attached on pr ports/166692 on a Gnats BTS:
getpatch --mode gnats ports/166692
or
getpatch 166692
Gnats is the default mode and category isn't mandatory.
Retrieve all patchs on a Bugzilla BTS:
getpatch --mode bz ports/166692
Retrieve only last iteration of the patch:
getpatch --last ports/166692
Retrieve patch on standard output
getpatch --stdout ports/166692
On fly patching can be done in a port directory this way:
For a diff
cd ${PORTSDIR}/category/port
patch -p0 < <(getpatch 166692 --stdout)
For a shar
cd ${PORTSDIR}/category/port
sh <(getpatch 166692 --stdout)
Redirection <() depends on the shell you're using, validated with zsh and bash.
DIAGNOSTICS
getpatch exits 0 on success or 1 if a help message was output.
SEE ALSO
getpr, prpatch
AUTHORS
Sofian Brabez <sbz@freebsd.org>
BUGS
If you're using getpatch and you encounter a bug or want an improvement
don't hesitate to mail me.
FreeBSD 14 August 2012 FreeBSD