Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/807027/?format=api
{ "id": 807027, "url": "http://patchwork.ozlabs.org/api/patches/807027/?format=api", "web_url": "http://patchwork.ozlabs.org/project/openvswitch/patch/20170829095424.4707-1-stephen@that.guru/", "project": { "id": 47, "url": "http://patchwork.ozlabs.org/api/projects/47/?format=api", "name": "Open vSwitch", "link_name": "openvswitch", "list_id": "ovs-dev.openvswitch.org", "list_email": "ovs-dev@openvswitch.org", "web_url": "http://openvswitch.org/", "scm_url": "git@github.com:openvswitch/ovs.git", "webscm_url": "https://github.com/openvswitch/ovs", "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20170829095424.4707-1-stephen@that.guru>", "list_archive_url": null, "date": "2017-08-29T09:54:24", "name": "[ovs-dev] docs: Add references to git-pw", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": false, "hash": "2de53dc6051163e56a4b8ff7d254ffceaf6ab1fe", "submitter": { "id": 69991, "url": "http://patchwork.ozlabs.org/api/people/69991/?format=api", "name": "Stephen Finucane", "email": "stephen@that.guru" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/openvswitch/patch/20170829095424.4707-1-stephen@that.guru/mbox/", "series": [ { "id": 342, "url": "http://patchwork.ozlabs.org/api/series/342/?format=api", "web_url": "http://patchwork.ozlabs.org/project/openvswitch/list/?series=342", "date": "2017-08-29T09:54:24", "name": "[ovs-dev] docs: Add references to git-pw", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/342/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/807027/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/807027/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<ovs-dev-bounces@openvswitch.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "dev@openvswitch.org" ], "Delivered-To": [ "patchwork-incoming@bilbo.ozlabs.org", "ovs-dev@mail.linuxfoundation.org" ], "Authentication-Results": [ "ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=openvswitch.org\n\t(client-ip=140.211.169.12; helo=mail.linuxfoundation.org;\n\tenvelope-from=ovs-dev-bounces@openvswitch.org;\n\treceiver=<UNKNOWN>)", "ozlabs.org;\n\tdkim=fail reason=\"key not found in DNS\" (0-bit key;\n\tunprotected) header.d=that.guru header.i=@that.guru\n\theader.b=\"ML1ix/pJ\"; dkim-atps=neutral" ], "Received": [ "from mail.linuxfoundation.org (mail.linuxfoundation.org\n\t[140.211.169.12])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256\n\tbits)) (No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xhQ1s6QSsz9t5T\n\tfor <incoming@patchwork.ozlabs.org>;\n\tTue, 29 Aug 2017 20:32:01 +1000 (AEST)", "from mail.linux-foundation.org (localhost [127.0.0.1])\n\tby mail.linuxfoundation.org (Postfix) with ESMTP id F0633910;\n\tTue, 29 Aug 2017 10:31:55 +0000 (UTC)", "from smtp1.linuxfoundation.org (smtp1.linux-foundation.org\n\t[172.17.192.35])\n\tby mail.linuxfoundation.org (Postfix) with ESMTPS id 87907258\n\tfor <dev@openvswitch.org>; Tue, 29 Aug 2017 10:31:54 +0000 (UTC)", "from nov-007-i592.relay.mailchannels.net\n\t(nov-007-i592.relay.mailchannels.net [46.232.183.146])\n\tby smtp1.linuxfoundation.org (Postfix) with ESMTPS id A20F71AC\n\tfor <dev@openvswitch.org>; Tue, 29 Aug 2017 10:31:51 +0000 (UTC)", "from relay.mailchannels.net (localhost [127.0.0.1])\n\tby relay.mailchannels.net (Postfix) with ESMTP id E510F5C1990\n\tfor <dev@openvswitch.org>; Tue, 29 Aug 2017 09:54:31 +0000 (UTC)", "from one.mxroute.com (unknown [100.96.140.134])\n\t(Authenticated sender: mxroute)\n\tby relay.mailchannels.net (Postfix) with ESMTPA id 634635C1438\n\tfor <dev@openvswitch.org>; Tue, 29 Aug 2017 09:54:31 +0000 (UTC)", "from one.mxroute.com (one-outgoing.mxroute.com [100.96.140.1])\n\t(using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384)\n\tby 0.0.0.0:2500 (trex/5.9.14); Tue, 29 Aug 2017 09:54:31 +0000" ], "X-Greylist": "delayed 00:37:16 by SQLgrey-1.7.6", "X-Sender-Id": [ "mxroute|x-authuser|stephen@that.guru", "mxroute|x-authuser|stephen@that.guru" ], "X-MC-Relay": "Neutral", "X-MailChannels-SenderId": "mxroute|x-authuser|stephen@that.guru", "X-MailChannels-Auth-Id": "mxroute", "X-Bottle-Bottle": "228feb47051bc948_1504000471657_96499894", "X-MC-Loop-Signature": "1504000471656:949994976", "X-MC-Ingress-Time": "1504000471656", "DKIM-Signature": "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=that.guru;\n\ts=default;\n\th=Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:MIME-Version\n\t:Content-Type:Content-Transfer-Encoding:Content-ID:Content-Description:\n\tResent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:\n\tIn-Reply-To:References:List-Id:List-Help:List-Unsubscribe:List-Subscribe:\n\tList-Post:List-Owner:List-Archive;\n\tbh=j9jATbYO49Y2s3tdBAJmRbXM0pVO8lGDrD00fGCilhA=;\n\tb=ML1ix/pJqhFq4mThkMfHiUClRy\n\t+E2wPjp6O0RFGFtIrUJY2UoK1n6gz3psFnbm2qr57xFFBKv5Z+P/a5ynMJHAEzYZltqqPk52bsI5d\n\t0896x5xv+pFE1fAUTqgzt5Wt2sC/PZecQF4FnCVX/417Y1z7bOxdgTkkRvzANL06YCwEUgB25dpR3\n\tHqcwS/nM/wdVwvRjX3r5awtTLmxIwVPlWAbgDDIPVxsEUfxKrewl+S9A9aiQH3lxyGM9wLpRYIKeg\n\t/3D2mn6bcPzHJhUifzEypOMAWNJ3Ru5vMxaeV59OpUdpLLPbi8lffxwSW4wc4fE/1tvH8D+MjPAUc\n\t8SyGusxA==;", "From": "Stephen Finucane <stephen@that.guru>", "To": "dev@openvswitch.org", "Date": "Tue, 29 Aug 2017 10:54:24 +0100", "Message-Id": "<20170829095424.4707-1-stephen@that.guru>", "X-Mailer": "git-send-email 2.13.5", "X-AuthUser": "stephen@that.guru", "X-Spam-Status": "No, score=0.1 required=5.0 tests=DKIM_SIGNED,\n\tRCVD_IN_DNSWL_NONE, \n\tT_DKIM_INVALID autolearn=disabled version=3.3.1", "X-Spam-Checker-Version": "SpamAssassin 3.3.1 (2010-03-16) on\n\tsmtp1.linux-foundation.org", "Subject": "[ovs-dev] [PATCH] docs: Add references to git-pw", "X-BeenThere": "ovs-dev@openvswitch.org", "X-Mailman-Version": "2.1.12", "Precedence": "list", "List-Id": "<ovs-dev.openvswitch.org>", "List-Unsubscribe": "<https://mail.openvswitch.org/mailman/options/ovs-dev>,\n\t<mailto:ovs-dev-request@openvswitch.org?subject=unsubscribe>", "List-Archive": "<http://mail.openvswitch.org/pipermail/ovs-dev/>", "List-Post": "<mailto:ovs-dev@openvswitch.org>", "List-Help": "<mailto:ovs-dev-request@openvswitch.org?subject=help>", "List-Subscribe": "<https://mail.openvswitch.org/mailman/listinfo/ovs-dev>,\n\t<mailto:ovs-dev-request@openvswitch.org?subject=subscribe>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"us-ascii\"", "Content-Transfer-Encoding": "7bit", "Sender": "ovs-dev-bounces@openvswitch.org", "Errors-To": "ovs-dev-bounces@openvswitch.org" }, "content": "Now that Patchwork 2.0 is out, folks can start to take advantage of some\nof the new features that it offers. Chief among these is series support,\nwhich is only exposed via the web UI and new REST API and which, in\nturn, necessitates using git-pw rather than pwclient. As such, this tool\nis slightly documented.\n\nSigned-off-by: Stephen Finucane <stephen@that.guru>\n---\nPS: I still plan to get back to converting the man pages to rST, but\nhave been sidetracked by other projects/work. Eventually! :)\n---\n Documentation/internals/patchwork.rst | 34 ++++++++++++++++++++++++++--------\n 1 file changed, 26 insertions(+), 8 deletions(-)", "diff": "diff --git a/Documentation/internals/patchwork.rst b/Documentation/internals/patchwork.rst\nindex 3ae0d9503..07b233bd3 100644\n--- a/Documentation/internals/patchwork.rst\n+++ b/Documentation/internals/patchwork.rst\n@@ -29,33 +29,51 @@ Patchwork\n \n Open vSwitch uses `Patchwork`__ to track the status of patches sent to the\n :doc:`ovs-dev mailing list <mailing-lists>`. The Open vSwitch Patchwork\n-instance can be found on `ozlabs.org`__. The ``pwclientrc`` file, required for\n-*pwclient*, can be found on the `project page`__\n+instance can be found on `ozlabs.org`__.\n \n Patchwork provides a number of useful features for developers working on Open\n vSwitch:\n \n - Tracking the lifecycle of patches (accepted, rejected, under-review, ...)\n - Assigning reviewers (delegates) to patches\n-- Downloading/applying patches via the web UI or the XML-RPC API (see\n- :ref:`pwclient`)\n+- Downloading/applying patches, series, and bundles via the web UI, REST API\n+ (see :ref:`git-pw`), or the legacy XML-RPC API (see :ref:`pwclient`)\n - A usable UI for viewing patch discussions\n \n __ https://github.com/getpatchwork/patchwork\n __ https://patchwork.ozlabs.org/project/openvswitch/list/\n-__ https://patchwork.ozlabs.org/project/openvswitch/\n+\n+.. _git-pw:\n+\n+git-pw\n+------\n+\n+The *git-pw* tool provides a way to download and apply patches, series, and\n+bundles. You can install *git-pw* from `PyPi`__ like so::\n+\n+ $ pip install --user git-pw\n+\n+Once installed, run::\n+\n+ $ git pw --help\n+\n+to get more information about the functionality *git-pw* provides.\n+\n+__ https://pypi.python.org/pypi/git-pw\n \n .. _pwclient:\n \n pwclient\n --------\n \n-The *pwclient* tool provides an way to download and apply patches, change the\n+The *pwclient* tool provides a way to download and apply patches, change the\n state of patches in Patchwork, and more. You can download *pwclient* from\n-`here`__. Once downloaded, run::\n+`here`__. You will also need a ``pwclientrc`` file, which can be found on the\n+`Open vSwitch project page`__. Once both files are downloaded, run::\n \n $ pwclient help\n \n-to get more information about the functionality pwclient provides.\n+to get more information about the functionality *pwclient* provides.\n \n __ https://patchwork.ozlabs.org/pwclient/\n+__ https://patchwork.ozlabs.org/project/openvswitch/\n", "prefixes": [ "ovs-dev" ] }