Cover Letter Detail
Show a cover letter.
GET /api/1.1/covers/2229774/?format=api
{ "id": 2229774, "url": "http://patchwork.ozlabs.org/api/1.1/covers/2229774/?format=api", "web_url": "http://patchwork.ozlabs.org/project/ovn/cover/20260428174509.145440-1-mmichels@redhat.com/", "project": { "id": 68, "url": "http://patchwork.ozlabs.org/api/1.1/projects/68/?format=api", "name": "Open Virtual Network development", "link_name": "ovn", "list_id": "ovs-dev.openvswitch.org", "list_email": "ovs-dev@openvswitch.org", "web_url": "http://openvswitch.org/", "scm_url": "", "webscm_url": "" }, "msgid": "<20260428174509.145440-1-mmichels@redhat.com>", "date": "2026-04-28T17:45:00", "name": "[ovs-dev,0/5] Fix up northd documentation.", "submitter": { "id": 71978, "url": "http://patchwork.ozlabs.org/api/1.1/people/71978/?format=api", "name": "Mark Michelson", "email": "mmichels@redhat.com" }, "mbox": "http://patchwork.ozlabs.org/project/ovn/cover/20260428174509.145440-1-mmichels@redhat.com/mbox/", "series": [ { "id": 501914, "url": "http://patchwork.ozlabs.org/api/1.1/series/501914/?format=api", "web_url": "http://patchwork.ozlabs.org/project/ovn/list/?series=501914", "date": "2026-04-28T17:45:02", "name": "Fix up northd documentation.", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/501914/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/covers/2229774/comments/", "headers": { "Return-Path": "<ovs-dev-bounces@openvswitch.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "dev@openvswitch.org" ], "Delivered-To": [ "patchwork-incoming@legolas.ozlabs.org", "ovs-dev@lists.linuxfoundation.org" ], "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=LzXZlEas;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org\n (client-ip=2605:bc80:3010::133; helo=smtp2.osuosl.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org)", "smtp2.osuosl.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key)\n header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=LzXZlEas", "smtp1.osuosl.org; dmarc=pass (p=quarantine dis=none)\n header.from=redhat.com", "smtp1.osuosl.org; dkim=pass (1024-bit key,\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=LzXZlEas" ], "Received": [ "from smtp2.osuosl.org (smtp2.osuosl.org [IPv6:2605:bc80:3010::133])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g4ns035fDz1xvV\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 29 Apr 2026 03:45:24 +1000 (AEST)", "from localhost (localhost [127.0.0.1])\n\tby smtp2.osuosl.org (Postfix) with ESMTP id 9CAAA407CA;\n\tTue, 28 Apr 2026 17:45:22 +0000 (UTC)", "from smtp2.osuosl.org ([127.0.0.1])\n by localhost (smtp2.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id DXgV0_ig5EW9; Tue, 28 Apr 2026 17:45:21 +0000 (UTC)", "from lists.linuxfoundation.org (lf-lists.osuosl.org\n [IPv6:2605:bc80:3010:104::8cd3:938])\n\tby smtp2.osuosl.org (Postfix) with ESMTPS id 40255407C2;\n\tTue, 28 Apr 2026 17:45:21 +0000 (UTC)", "from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id D9C6CC0628;\n\tTue, 28 Apr 2026 17:45:20 +0000 (UTC)", "from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138])\n by lists.linuxfoundation.org (Postfix) with ESMTP id 9C622C04FA\n for <dev@openvswitch.org>; Tue, 28 Apr 2026 17:45:18 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n by smtp1.osuosl.org (Postfix) with ESMTP id 8AFDA821CB\n for <dev@openvswitch.org>; Tue, 28 Apr 2026 17:45:18 +0000 (UTC)", "from smtp1.osuosl.org ([127.0.0.1])\n by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id eADpmYdrSvzI for <dev@openvswitch.org>;\n Tue, 28 Apr 2026 17:45:16 +0000 (UTC)", "from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.129.124])\n by smtp1.osuosl.org (Postfix) with ESMTPS id F26A9815DE\n for <dev@openvswitch.org>; Tue, 28 Apr 2026 17:45:15 +0000 (UTC)", "from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-517-XPgpNVYEOuKqD_WH0A_Sgg-1; Tue,\n 28 Apr 2026 13:45:12 -0400", "from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 5EE2F1800366\n for <dev@openvswitch.org>; Tue, 28 Apr 2026 17:45:11 +0000 (UTC)", "from localhost.localdomain.com (unknown [10.22.88.208])\n by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id F10BF19560AB\n for <dev@openvswitch.org>; Tue, 28 Apr 2026 17:45:10 +0000 (UTC)" ], "X-Virus-Scanned": [ "amavis at osuosl.org", "amavis at osuosl.org" ], "X-Comment": "SPF check N/A for local connections -\n client-ip=2605:bc80:3010:104::8cd3:938; helo=lists.linuxfoundation.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=<UNKNOWN> ", "DKIM-Filter": [ "OpenDKIM Filter v2.11.0 smtp2.osuosl.org 40255407C2", "OpenDKIM Filter v2.11.0 smtp1.osuosl.org F26A9815DE" ], "Received-SPF": "Pass (mailfrom) identity=mailfrom; client-ip=170.10.129.124;\n helo=us-smtp-delivery-124.mimecast.com; envelope-from=mmichels@redhat.com;\n receiver=<UNKNOWN>", "DMARC-Filter": "OpenDMARC Filter v1.4.2 smtp1.osuosl.org F26A9815DE", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1777398313;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding;\n bh=BUlU0CZZI/0y1JMZKlp1eTxutJ90uJjZN6GD7FfST14=;\n b=LzXZlEas7YXk36wzW9AQ+nRGgVq+iM4Q3CAvYc2HytwH4eoHr8tQzk10NxhgX1z17e6BFy\n dG3iWEOd9E1fHptlhreMmqbmUpwrFFlPrtSz9WKvklaIxDd8SEPPiNl9kuLVuFgl1doTnZ\n cM/F8Kl/0a4JPtgBmuXSNXxs/ofsGVk=", "X-MC-Unique": "XPgpNVYEOuKqD_WH0A_Sgg-1", "X-Mimecast-MFC-AGG-ID": "XPgpNVYEOuKqD_WH0A_Sgg_1777398311", "To": "dev@openvswitch.org", "Date": "Tue, 28 Apr 2026 13:45:00 -0400", "Message-ID": "<20260428174509.145440-1-mmichels@redhat.com>", "MIME-Version": "1.0", "X-Scanned-By": "MIMEDefang 3.0 on 10.30.177.12", "X-Mimecast-Spam-Score": "0", "X-Mimecast-MFC-PROC-ID": "wiVlTSer5SIIGAsqO_lYidE7HK_VfNGc-mkuF94QT1g_1777398311", "X-Mimecast-Originator": "redhat.com", "Subject": "[ovs-dev] [PATCH ovn 0/5] Fix up northd documentation.", "X-BeenThere": "ovs-dev@openvswitch.org", "X-Mailman-Version": "2.1.30", "Precedence": "list", "List-Id": "<ovs-dev.openvswitch.org>", "List-Unsubscribe": "<https://mail.openvswitch.org/mailman/options/ovs-dev>,\n <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 <mailto:ovs-dev-request@openvswitch.org?subject=subscribe>", "From": "Mark Michelson via dev <ovs-dev@openvswitch.org>", "Reply-To": "Mark Michelson <mmichels@redhat.com>", "Content-Type": "text/plain; charset=\"us-ascii\"", "Content-Transfer-Encoding": "7bit", "Errors-To": "ovs-dev-bounces@openvswitch.org", "Sender": "\"dev\" <ovs-dev-bounces@openvswitch.org>" }, "content": "This patch set aims to correct errors in ovn-northd documentation.\nSpecifially, it corrects the following:\n\n* Add missing/incorrect program options to manpages. For this series,\n this includes the ovn-northd, ovn-nb, and ovn-nbctl manpages.\n* Correct missing/incorrect program options in usage strings. For this\n series, this includes the ovn-northd and ovn-nbctl programs.\n\nIn addition to the above, this series also splits the ovn-northd manpage\nin two. The ovn-northd manpage contains only information about running\nthe ovn-northd application, such as command line options. The new\novn-logical-flows manpage contains information about the logical flows\nthat ovn-northd installs. The final commit in this series converts the\novn-logical-flows manpage input file from XML to rST, since it is more\nfrequently updated by developers, and rST is much easier to read and\nedit than XML.\n\nOne thing this series does NOT try to address is missing information in\nthe ovn-logical-flows document regarding how certain options affect the\ngenerated logical flows. This can be done in another patch series, and\nwith the conversion to rST, this will likely be much easier to do.\n\nAbout 99% of this series was AI-generated. My contributions are some\nclarifications in the commit messages, as well as updating some\nancillary files in the final commit to indicate the requirement for\nrst2man.\n\nMark Michelson (5):\n ovn-nbctl: Fix documentation and usage output for all commands.\n ovn-nb: Document Load_Balancer \"event\" option.\n northd: Split logical flow docs into ovn-logical-flows(7).\n northd: Fix ovn-northd manpage and usage for options and commands.\n northd: Convert ovn-logical-flows(7) from XML to RST.\n\n Documentation/intro/install/general.rst | 5 +\n NEWS | 6 +\n northd/automake.mk | 6 +\n northd/ovn-logical-flows.7.rst | 4311 ++++++++++++++++\n northd/ovn-northd.8.xml | 6122 +----------------------\n northd/ovn-northd.c | 2 +\n ovn-nb.xml | 9 +\n rhel/ovn-fedora.spec.in | 1 +\n utilities/ovn-nbctl.8.xml | 174 +-\n utilities/ovn-nbctl.c | 191 +-\n 10 files changed, 4661 insertions(+), 6166 deletions(-)\n create mode 100644 northd/ovn-logical-flows.7.rst" }