[{"id":3683651,"web_url":"http://patchwork.ozlabs.org/comment/3683651/","msgid":"","list_archive_url":null,"date":"2026-04-28T18:36:32","subject":"Re: [ovs-dev] [PATCH ovn 0/5] Fix up northd documentation.","submitter":{"id":76798,"url":"http://patchwork.ozlabs.org/api/people/76798/","name":"Ilya Maximets","email":"i.maximets@ovn.org"},"content":"On 4/28/26 7:45 PM, Mark Michelson via dev wrote:\n> This patch set aims to correct errors in ovn-northd documentation.\n> Specifially, 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> \n> In addition to the above, this series also splits the ovn-northd manpage\n> in two. The ovn-northd manpage contains only information about running\n> the ovn-northd application, such as command line options. The new\n> ovn-logical-flows manpage contains information about the logical flows\n> that ovn-northd installs. The final commit in this series converts the\n> ovn-logical-flows manpage input file from XML to rST, since it is more\n> frequently updated by developers, and rST is much easier to read and\n> edit than XML.\n> \n> One thing this series does NOT try to address is missing information in\n> the ovn-logical-flows document regarding how certain options affect the\n> generated logical flows. This can be done in another patch series, and\n> with the conversion to rST, this will likely be much easier to do.\n> \n> About 99% of this series was AI-generated. My contributions are some\n> clarifications in the commit messages, as well as updating some\n> ancillary files in the final commit to indicate the requirement for\n> rst2man.\n\nFWIW, we shouldn't add an extra dependency for this. The standard way to\nbuild rST man pages is with sphinx and OVN already has all the infra for\nthat in Documentation/automake.mk. The ovn-sim.1 is built this way.\nThough you'll need to use RST_MANPAGES instead of RST_MANPAGES_NOINST for\nthe northd page, I suppose. You can also find more examples in the\nDocumentation/automake.mk in OVS.\n\nThe resulted page will be in Documentation/ref, make sure it's properly\nplaced for distribution. Will need an update for Documentation/conf.py\nand Documentation/ref/index.rst, so it is browse-able in the built\ndocumentation on the website.\n\nAnd maybe tell claude to respect the ling length limits where it's not\na vebratim code. :)\n\nBest regards, Ilya Maximets.","headers":{"Return-Path":"","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 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)","smtp3.osuosl.org;\n dmarc=none (p=none dis=none) header.from=ovn.org"],"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 4g4q0C3j29z1yHv\n\tfor ; Wed, 29 Apr 2026 04:36:43 +1000 (AEST)","from localhost (localhost [127.0.0.1])\n\tby smtp2.osuosl.org (Postfix) with ESMTP id 57399407CD;\n\tTue, 28 Apr 2026 18:36:41 +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 FjQBs_2onnRN; Tue, 28 Apr 2026 18:36:39 +0000 (UTC)","from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56])\n\tby smtp2.osuosl.org (Postfix) with ESMTPS id B09B0407C1;\n\tTue, 28 Apr 2026 18:36:39 +0000 (UTC)","from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id 8978AC04FB;\n\tTue, 28 Apr 2026 18:36:39 +0000 (UTC)","from smtp3.osuosl.org (smtp3.osuosl.org [140.211.166.136])\n by lists.linuxfoundation.org (Postfix) with ESMTP id 8B207C04FA\n for ; Tue, 28 Apr 2026 18:36:38 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp3.osuosl.org (Postfix) with ESMTP id 7D0496107B\n for ; Tue, 28 Apr 2026 18:36:38 +0000 (UTC)","from smtp3.osuosl.org ([127.0.0.1])\n by localhost (smtp3.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id xYt3yMbo5Rvu for ;\n Tue, 28 Apr 2026 18:36:37 +0000 (UTC)","from mail-vs1-f68.google.com (mail-vs1-f68.google.com\n [209.85.217.68])\n by smtp3.osuosl.org (Postfix) with ESMTPS id 7BDA461076\n for ; Tue, 28 Apr 2026 18:36:37 +0000 (UTC)","by mail-vs1-f68.google.com with SMTP id\n ada2fe7eead31-61399bdd395so3839691137.2\n for ; Tue, 28 Apr 2026 11:36:37 -0700 (PDT)","from [192.168.88.241] (89-24-34-32.nat.epc.tmcz.cz. [89.24.34.32])\n by smtp.gmail.com with ESMTPSA id\n ada2fe7eead31-627f7c24a03sm1725850137.8.2026.04.28.11.36.34\n (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);\n Tue, 28 Apr 2026 11:36:35 -0700 (PDT)"],"X-Virus-Scanned":["amavis at osuosl.org","amavis at osuosl.org"],"X-Comment":"SPF check N/A for local connections - client-ip=140.211.9.56;\n helo=lists.linuxfoundation.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver= ","DKIM-Filter":["OpenDKIM Filter v2.11.0 smtp2.osuosl.org B09B0407C1","OpenDKIM Filter v2.11.0 smtp3.osuosl.org 7BDA461076"],"Received-SPF":"Pass (mailfrom) identity=mailfrom; client-ip=209.85.217.68;\n helo=mail-vs1-f68.google.com; envelope-from=i.maximets.ovn@gmail.com;\n receiver=","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp3.osuosl.org 7BDA461076","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1777401396; x=1778006196;\n h=content-transfer-encoding:in-reply-to:autocrypt:from\n :content-language:references:to:subject:cc:user-agent:mime-version\n :date:message-id:x-gm-gg:x-gm-message-state:from:to:cc:subject:date\n :message-id:reply-to;\n bh=XSXB1dqjRHdYVNZiCAkZXabEdUXuRgbnY+xl4uqsHJM=;\n b=Ec5bwK/ifs8Z/31BQdof2H09t4PS9eBzJZRR1toK/9xOPZMyoRDzHjshVyasa1imQU\n Ro/YROqY29BeZVf8py8tsJFEi13R63Nn+Y87ZiCf4seqwf8kAbPnjOerJ3AAi6Y1alfe\n o3fesR3TtphvKNjcCwT0EHgSrBB1tDHfWtMHQiG9C6pIuO0WBAZNvkSLi82Xq2mRTAfR\n IUBz/ApQw7lROCucdGILWV4/CbxH/WIG2IIE63jWFLxY6OOWsj6N1kQkK2bhCWLF+nlO\n UYO2MKDai+W5ejnzoQ/10UifeXYC5HugrnrOrNeKUnHZHmf1bJIpq66EH/rrYsxmSxZW\n t9yg==","X-Forwarded-Encrypted":"i=1;\n AFNElJ/6eGtqEz0gtkBv8jzgG7dFg5mduwLoy5xstpMpy0+GeXiS5CXfEZ6SWuBut/w1YXvIcNk=@openvswitch.org","X-Gm-Message-State":"AOJu0Yyn77pfvqja5cr294k/c6D2QfNjoJx61tZx22qNtoUaeUKvbi4i\n w1EAzxBW6rL/XCZl2JE3eEo8hLFXSvJWQkR0Js6IRYf556VfFFzgmAjX","X-Gm-Gg":"AeBDiesB0Agb1rAIJEVbMG/4iANK4dL82sNxxkwu7ZE4OESFZoHgLyrEzjw+bNJz7oL\n US8Rl/rPkQSNYbhCMBfGA9Xw8kvozkm/sGIU11pdyw5GHMn5o7rymfXbwOiD7K5Iy7VJ8N8NwhW\n IRHfPigACg2rRXY/B493gNWzxEaUWZcjFXlc54ZhdLD//q7UrNidNcwGYktRZNGmBkG+a3oMOGU\n 741xjpjcJmQVxlLB2wc6tkyHIqYlo7uY0gHkJ4z8HxNgwJKSpfVIboANDDBdZUrqmkb75WOtC9L\n E+KxEJyDgcQ0h9uDz8y4N6rcjKWW4YaE0Mek7QKGBZegidrTaO86nlkU8eFI/aevFjEP3IKH1BW\n sho48w/hlEIWBcKbo93fZ+tGrCW2ymOHxtV0mfQUy/I81p1jVtENfVD0zj0xSTNvRMvNBCLK6kw\n RFBP3upOYLbcuTO2VV+DFoNqS5totQh5IWXaxHEZrlhHTzXhNTRhvlhwmyvv8hG9t5fFQpJI0lz\n g==","X-Received":"by 2002:a05:6102:604c:b0:60f:7499:9b6e with SMTP id\n ada2fe7eead31-6280b9ecad2mr2102049137.27.1777401396090;\n Tue, 28 Apr 2026 11:36:36 -0700 (PDT)","Message-ID":"","Date":"Tue, 28 Apr 2026 20:36:32 +0200","MIME-Version":"1.0","User-Agent":"Mozilla Thunderbird","Cc":"i.maximets@ovn.org","To":"Mark Michelson , dev@openvswitch.org","References":"<20260428174509.145440-1-mmichels@redhat.com>","Content-Language":"en-US","From":"Ilya Maximets ","Autocrypt":"addr=i.maximets@ovn.org; keydata=\n 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","In-Reply-To":"<20260428174509.145440-1-mmichels@redhat.com>","Subject":"Re: [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":"","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Content-Type":"text/plain; charset=\"us-ascii\"","Content-Transfer-Encoding":"7bit","Errors-To":"ovs-dev-bounces@openvswitch.org","Sender":"\"dev\" "}},{"id":3683682,"web_url":"http://patchwork.ozlabs.org/comment/3683682/","msgid":"","list_archive_url":null,"date":"2026-04-28T19:13:53","subject":"Re: [ovs-dev] [PATCH ovn 0/5] Fix up northd documentation.","submitter":{"id":76798,"url":"http://patchwork.ozlabs.org/api/people/76798/","name":"Ilya Maximets","email":"i.maximets@ovn.org"},"content":"On 4/28/26 8:36 PM, Ilya Maximets wrote:\n> On 4/28/26 7:45 PM, Mark Michelson via dev wrote:\n>> This patch set aims to correct errors in ovn-northd documentation.\n>> Specifially, 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>>\n>> In addition to the above, this series also splits the ovn-northd manpage\n>> in two. The ovn-northd manpage contains only information about running\n>> the ovn-northd application, such as command line options. The new\n>> ovn-logical-flows manpage contains information about the logical flows\n>> that ovn-northd installs. The final commit in this series converts the\n>> ovn-logical-flows manpage input file from XML to rST, since it is more\n>> frequently updated by developers, and rST is much easier to read and\n>> edit than XML.\n>>\n>> One thing this series does NOT try to address is missing information in\n>> the ovn-logical-flows document regarding how certain options affect the\n>> generated logical flows. This can be done in another patch series, and\n>> with the conversion to rST, this will likely be much easier to do.\n>>\n>> About 99% of this series was AI-generated. My contributions are some\n>> clarifications in the commit messages, as well as updating some\n>> ancillary files in the final commit to indicate the requirement for\n>> rst2man.\n> \n> FWIW, we shouldn't add an extra dependency for this. The standard way to\n> build rST man pages is with sphinx and OVN already has all the infra for\n> that in Documentation/automake.mk. The ovn-sim.1 is built this way.\n> Though you'll need to use RST_MANPAGES instead of RST_MANPAGES_NOINST for\n> the northd page, I suppose. You can also find more examples in the\n> Documentation/automake.mk in OVS.\n\nThere is also this commit where I converted ovs-actions page from XML\nto rST quite a few years ago (in OVS repo, of course):\n c2fb5bdae6e3 (\"ovs-actions: Convert man page from xml to rST.\")\nIt's not perfect, but can be used as a reference.\n\n> \n> The resulted page will be in Documentation/ref, make sure it's properly\n> placed for distribution. Will need an update for Documentation/conf.py\n> and Documentation/ref/index.rst, so it is browse-able in the built\n> documentation on the website.\n> \n> And maybe tell claude to respect the ling length limits where it's not\n> a vebratim code. :)\n\nThis last remark is primarily for over-wrapping. The line lengths in the\nnew rST doc are all over the place in terms of their length, it's actually\nhard to read. The doc can be likely significantly shorter, if the lines\nare wrapped proerply. E.g. this:\n\n+ - If the logical router has rules specified in\n+ ``nat`` with\n+ ``external_mac``, then\n+ those addresses are also used to populate the switch's destination\n+ lookup on the chassis where\n+ ``logical_port`` is\n+ resident.\n\nCan probably be about 3 lines instead of 7.\n\nIt also sometimes splits the `` `` blocks, sometimes it doesn't. In a few\nplaces it might be more beneficial to use proper blocks with :: instead of\nvery long `` `` lines.\n\nIn general, while claude made a bulk of work, I'd suggest to do a manual\nediting run. It sucks, but the doc can be much better with proper formatting,\nhighlights and section cross-reference (I don't see links between sections\nin the patch, while they can be there, since rST allows for this kind of\nstuff) that will be very useful in html on the website. Maybe claude can\nhelp with this stuff too, but it needs to be guided.\n\nBest regards, Ilya Maximets.","headers":{"Return-Path":"","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 spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org\n (client-ip=2605:bc80:3010::138; helo=smtp1.osuosl.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org)","smtp4.osuosl.org;\n dmarc=none (p=none dis=none) header.from=ovn.org"],"Received":["from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138])\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 4g4qqH0B80z1xrS\n\tfor ; Wed, 29 Apr 2026 05:14:02 +1000 (AEST)","from localhost (localhost [127.0.0.1])\n\tby smtp1.osuosl.org (Postfix) with ESMTP id 65E1883D6F;\n\tTue, 28 Apr 2026 19:14:01 +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 hccIUD_76o7Z; Tue, 28 Apr 2026 19:13:59 +0000 (UTC)","from lists.linuxfoundation.org (lf-lists.osuosl.org [140.211.9.56])\n\tby smtp1.osuosl.org (Postfix) with ESMTPS id A74F283D6A;\n\tTue, 28 Apr 2026 19:13:59 +0000 (UTC)","from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id 8C31FC04FB;\n\tTue, 28 Apr 2026 19:13:59 +0000 (UTC)","from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137])\n by lists.linuxfoundation.org (Postfix) with ESMTP id 12A02C04FA\n for ; Tue, 28 Apr 2026 19:13:59 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp4.osuosl.org (Postfix) with ESMTP id F2BDC411C0\n for ; Tue, 28 Apr 2026 19:13:58 +0000 (UTC)","from smtp4.osuosl.org ([127.0.0.1])\n by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id FQ3BtUyHIMkC for ;\n Tue, 28 Apr 2026 19:13:58 +0000 (UTC)","from mail-wm1-f65.google.com (mail-wm1-f65.google.com\n [209.85.128.65])\n by smtp4.osuosl.org (Postfix) with ESMTPS id A9349411BF\n for ; Tue, 28 Apr 2026 19:13:57 +0000 (UTC)","by mail-wm1-f65.google.com with SMTP id\n 5b1f17b1804b1-48984d29fe3so143210285e9.0\n for ; Tue, 28 Apr 2026 12:13:57 -0700 (PDT)","from [192.168.88.241] (89-24-34-32.nat.epc.tmcz.cz. [89.24.34.32])\n by smtp.gmail.com with ESMTPSA id\n 5b1f17b1804b1-48a7c31fb8asm453505e9.30.2026.04.28.12.13.54\n (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128);\n Tue, 28 Apr 2026 12:13:54 -0700 (PDT)"],"X-Virus-Scanned":["amavis at osuosl.org","amavis at osuosl.org"],"X-Comment":"SPF check N/A for local connections - client-ip=140.211.9.56;\n helo=lists.linuxfoundation.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver= ","DKIM-Filter":["OpenDKIM Filter v2.11.0 smtp1.osuosl.org A74F283D6A","OpenDKIM Filter v2.11.0 smtp4.osuosl.org A9349411BF"],"Received-SPF":"Pass (mailfrom) identity=mailfrom; client-ip=209.85.128.65;\n helo=mail-wm1-f65.google.com; envelope-from=i.maximets.ovn@gmail.com;\n receiver=","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp4.osuosl.org A9349411BF","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1777403636; x=1778008436;\n h=content-transfer-encoding:in-reply-to:autocrypt:from\n :content-language:references:to:subject:cc:user-agent:mime-version\n :date:message-id:x-gm-gg:x-gm-message-state:from:to:cc:subject:date\n :message-id:reply-to;\n bh=B9EB6GIpay/O5CAcSqqII/Sjsx2YQ2vSqVDLvPdFtaY=;\n b=bqvB1ChIiOGE+DCmDGV5HNpLPsO3S7Pyu7Gpf1/p15YhyutXhYK8l3lOYL6c0BjTNU\n kyO62DkVsvJwgsVu9iqlkvmGD6+7B08qHvtwt7tPQXOzKntFWojxsHAAv9gpJJUXKKj9\n IciaBJboMR20S8Dzl7zIuGDDSuRLNDxTFf6friHnvex+j+rtsjdqIQoFDdKx0M7yvXnS\n PXVCFLJg0mbIeNnrVyU/+on5ghujVDrUtxLgYkEpcu/c+QFVnEcVg194drMPCVnrjdZ2\n GKSg1E3mlc4p9DToljbhSAW1JD2NPwscwtcWTwhpkCzkHJ/CyftjzZYTfUv5rmPTtXyQ\n WbfA==","X-Forwarded-Encrypted":"i=1;\n AFNElJ/5slkcem/dUOoClL6MHrHkLcNQL+YK48WJo9HGhPW0KDBRgn5laEzNVVZzxR58dYBy/Hk=@openvswitch.org","X-Gm-Message-State":"AOJu0YwlqRYHiuj7m72cBWvnjXXG9Gk/yrQ/XkA1rr9Wz9WWvqAd/sQN\n JG/Y1U/tknQ7k3dLbizqun56F5ttwMRf2NlQ9iVFnSuuKCLOXnbJisdo","X-Gm-Gg":"AeBDietmFZlIeL/6s+fzXCAX8xwh5BAzg8MxhI1epDslWG3uiL12vWX4S2rVBgtVnjH\n 192Ss3XX+mGAbb/GdXzhOs9wW+jacHQ3b15midfXwrpiRIpj2u7aDmtCBrV50J6vDJrQjll1JPs\n jn0+wkW+Se+jcEZdNKf2oNRqGkGKg4uZcQu9pannumzwNJ8D7gyI8CFWiHbFkF7DXkrX8tulsuz\n RXrMI72W8Jamx6GspCSCtsMXg5HSmkCgGNJKjiFN6c+4mRi5ZWmS5vtf5qiw+tWxdtB3rU+wrfi\n 8r/FSLk+TFdPhJBpNaL+lBtL/wAvIW719ZpiAXvDmLMY30N9BpB79jRrMInMxmpE1a5zKdhuGD4\n IV205pdO3fTY5ui3K+8ffxTo/IPcExQVkC9X9kXLWP5rrymNAlo3SRua8v4DQU/a/UN4hx/XVqH\n Kp+RfAPCqeptoKrFb7MOtcWOx1oyZ5zjnkUu9lxPa3U8zJSYG7L6+C8iShQiMs+ps=","X-Received":"by 2002:a05:600c:820c:b0:48a:568f:ae6b with SMTP id\n 5b1f17b1804b1-48a77adc7fdmr74918965e9.7.1777403635347;\n Tue, 28 Apr 2026 12:13:55 -0700 (PDT)","Message-ID":"","Date":"Tue, 28 Apr 2026 21:13:53 +0200","MIME-Version":"1.0","User-Agent":"Mozilla Thunderbird","Cc":"i.maximets@ovn.org","To":"Mark Michelson , dev@openvswitch.org","References":"<20260428174509.145440-1-mmichels@redhat.com>\n ","Content-Language":"en-US","From":"Ilya Maximets ","Autocrypt":"addr=i.maximets@ovn.org; keydata=\n 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","In-Reply-To":"","Subject":"Re: [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":"","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Content-Type":"text/plain; charset=\"us-ascii\"","Content-Transfer-Encoding":"7bit","Errors-To":"ovs-dev-bounces@openvswitch.org","Sender":"\"dev\" "}},{"id":3683714,"web_url":"http://patchwork.ozlabs.org/comment/3683714/","msgid":"","list_archive_url":null,"date":"2026-04-28T20:55:17","subject":"Re: [ovs-dev] [PATCH ovn 0/5] Fix up northd documentation.","submitter":{"id":71978,"url":"http://patchwork.ozlabs.org/api/people/71978/","name":"Mark Michelson","email":"mmichels@redhat.com"},"content":"Thanks for the comments Ilya!\n\nOn Tue, Apr 28, 2026 at 3:14 PM Ilya Maximets wrote:\n>\n> On 4/28/26 8:36 PM, Ilya Maximets wrote:\n> > On 4/28/26 7:45 PM, Mark Michelson via dev wrote:\n> >> This patch set aims to correct errors in ovn-northd documentation.\n> >> Specifially, 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> >>\n> >> In addition to the above, this series also splits the ovn-northd manpage\n> >> in two. The ovn-northd manpage contains only information about running\n> >> the ovn-northd application, such as command line options. The new\n> >> ovn-logical-flows manpage contains information about the logical flows\n> >> that ovn-northd installs. The final commit in this series converts the\n> >> ovn-logical-flows manpage input file from XML to rST, since it is more\n> >> frequently updated by developers, and rST is much easier to read and\n> >> edit than XML.\n> >>\n> >> One thing this series does NOT try to address is missing information in\n> >> the ovn-logical-flows document regarding how certain options affect the\n> >> generated logical flows. This can be done in another patch series, and\n> >> with the conversion to rST, this will likely be much easier to do.\n> >>\n> >> About 99% of this series was AI-generated. My contributions are some\n> >> clarifications in the commit messages, as well as updating some\n> >> ancillary files in the final commit to indicate the requirement for\n> >> rst2man.\n> >\n> > FWIW, we shouldn't add an extra dependency for this. The standard way to\n> > build rST man pages is with sphinx and OVN already has all the infra for\n> > that in Documentation/automake.mk. The ovn-sim.1 is built this way.\n> > Though you'll need to use RST_MANPAGES instead of RST_MANPAGES_NOINST for\n> > the northd page, I suppose. You can also find more examples in the\n> > Documentation/automake.mk in OVS.\n>\n> There is also this commit where I converted ovs-actions page from XML\n> to rST quite a few years ago (in OVS repo, of course):\n> c2fb5bdae6e3 (\"ovs-actions: Convert man page from xml to rST.\")\n> It's not perfect, but can be used as a reference.\n\nThanks for the pointers, I'll have a look and see what I can do.\n\n>\n> >\n> > The resulted page will be in Documentation/ref, make sure it's properly\n> > placed for distribution. Will need an update for Documentation/conf.py\n> > and Documentation/ref/index.rst, so it is browse-able in the built\n> > documentation on the website.\n> >\n> > And maybe tell claude to respect the ling length limits where it's not\n> > a vebratim code. :)\n>\n> This last remark is primarily for over-wrapping. The line lengths in the\n> new rST doc are all over the place in terms of their length, it's actually\n> hard to read. The doc can be likely significantly shorter, if the lines\n> are wrapped proerply. E.g. this:\n>\n> + - If the logical router has rules specified in\n> + ``nat`` with\n> + ``external_mac``, then\n> + those addresses are also used to populate the switch's destination\n> + lookup on the chassis where\n> + ``logical_port`` is\n> + resident.\n>\n> Can probably be about 3 lines instead of 7.\n>\n> It also sometimes splits the `` `` blocks, sometimes it doesn't. In a few\n> places it might be more beneficial to use proper blocks with :: instead of\n> very long `` `` lines.\n\nPretty much everything you've said above with regards to formatting is\nlikely a symptom of\n* That's how the original XML document was. Different authors used\ndifferent styles, and we weren't always the best at catching when the\nline lengths were longer than 80 characters.\n* I simply instructed Claude to convert the file, with no direction\nwith regards to reformatting. Lines that had cumbersome XML tags were\nreduced to a few formatting characters, meaning that some lines that\nused to be quite long were reduced in size dramatically. The\nconversion left those as they were rather than attempting to compact\nthe text into something resembling a proper document.\n\nThat second bullet point is on me since I should have been more\nexplicit with my instructions. The big thing I did was to make sure\nthe resulting manpage looked sane, rather than looking at the source\ntext to make sure that it was formatted in a reasonable way.\n\n>\n> In general, while claude made a bulk of work, I'd suggest to do a manual\n> editing run. It sucks, but the doc can be much better with proper formatting,\n> highlights and section cross-reference (I don't see links between sections\n> in the patch, while they can be there, since rST allows for this kind of\n> stuff) that will be very useful in html on the website. Maybe claude can\n> help with this stuff too, but it needs to be guided.\n\nWith regards to making the document more readable by respecting the 80\ncharacter limitation, I'll happily do that.\n\nWere there cross-references in the original XML? I know there were\nreferences to DB tables and columns, but I don't recall if there were\nreferences to other document sections in the original XML. I'm willing\nto guide claude through an attempt at adding these. However, if they\nweren't there originally, and it requires manually editing several\nthousand lines of documentation, then I would argue that adding them\nwould be a separate scope beyond the initial conversion and could be\ndone as a follow-up. In other words, if the conversion is not losing\ninformation, then I think it's fine as-is and the niceties can be\nadded later.\n\n>\n> Best regards, Ilya Maximets.\n>","headers":{"Return-Path":"","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=RViM69J6;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org\n (client-ip=2605:bc80:3010::137; helo=smtp4.osuosl.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org)","smtp4.osuosl.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=RViM69J6","smtp3.osuosl.org; dmarc=pass (p=quarantine dis=none)\n header.from=redhat.com","smtp3.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=RViM69J6"],"Received":["from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137])\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 4g4t4X2cpmz1yHZ\n\tfor ; Wed, 29 Apr 2026 06:55:40 +1000 (AEST)","from localhost (localhost [127.0.0.1])\n\tby smtp4.osuosl.org (Postfix) with ESMTP id 5CDB641EBD;\n\tTue, 28 Apr 2026 20:55:38 +0000 (UTC)","from smtp4.osuosl.org ([127.0.0.1])\n by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id be75LEly3gCU; Tue, 28 Apr 2026 20:55:36 +0000 (UTC)","from lists.linuxfoundation.org (lf-lists.osuosl.org\n [IPv6:2605:bc80:3010:104::8cd3:938])\n\tby smtp4.osuosl.org (Postfix) with ESMTPS id 4EBEB40E32;\n\tTue, 28 Apr 2026 20:55:36 +0000 (UTC)","from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id 299F1C04FB;\n\tTue, 28 Apr 2026 20:55:36 +0000 (UTC)","from smtp3.osuosl.org (smtp3.osuosl.org [IPv6:2605:bc80:3010::136])\n by lists.linuxfoundation.org (Postfix) with ESMTP id EAC3FC04FA\n for ; Tue, 28 Apr 2026 20:55:34 +0000 (UTC)","from localhost (localhost [127.0.0.1])\n by smtp3.osuosl.org (Postfix) with ESMTP id D6BE260623\n for ; Tue, 28 Apr 2026 20:55:34 +0000 (UTC)","from smtp3.osuosl.org ([127.0.0.1])\n by localhost (smtp3.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id Zavw7bZqekaN for ;\n Tue, 28 Apr 2026 20:55:34 +0000 (UTC)","from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.129.124])\n by smtp3.osuosl.org (Postfix) with ESMTPS id AD13E60F2C\n for ; Tue, 28 Apr 2026 20:55:32 +0000 (UTC)","from mail-oo1-f71.google.com (mail-oo1-f71.google.com\n [209.85.161.71]) by relay.mimecast.com with ESMTP with STARTTLS\n (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id\n us-mta-541-3VrPdzNlOcWD0fSeUkmo7Q-1; Tue, 28 Apr 2026 16:55:30 -0400","by mail-oo1-f71.google.com with SMTP id\n 006d021491bc7-694885643e1so17230872eaf.3\n for ; Tue, 28 Apr 2026 13:55:30 -0700 (PDT)"],"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= ","DKIM-Filter":["OpenDKIM Filter v2.11.0 smtp4.osuosl.org 4EBEB40E32","OpenDKIM Filter v2.11.0 smtp3.osuosl.org AD13E60F2C"],"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=","DMARC-Filter":"OpenDMARC Filter v1.4.2 smtp3.osuosl.org AD13E60F2C","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1777409731;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=nZ2CvKjIIBDm9Mgw/dyysUsLG/8yblA5XFSKnhn6/AI=;\n b=RViM69J6JpOATUhaCrd/5C8cnndBNrUqJTI8q/7PMJ3VHISi+nTf9vR/2YkEKCUS2lFM7x\n YcjMhJ3zcgVRKn3YE9tkiYvqTmv7gJf/KDkYAt1QzMFIOYzLuvjLOHd1YytSmq84f2UJVz\n hRa5UMJbxpPPunzdhpmYIWSUe14WsSw=","X-MC-Unique":"3VrPdzNlOcWD0fSeUkmo7Q-1","X-Mimecast-MFC-AGG-ID":"3VrPdzNlOcWD0fSeUkmo7Q_1777409729","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1777409729; x=1778014529;\n h=content-transfer-encoding:cc:to:subject:message-id:date:from\n :in-reply-to:references:mime-version:x-gm-gg:x-gm-message-state:from\n :to:cc:subject:date:message-id:reply-to;\n bh=nZ2CvKjIIBDm9Mgw/dyysUsLG/8yblA5XFSKnhn6/AI=;\n b=NYtZKiw9zA010sfKch+tsDzW+C3lr4l7bSWj/JWPeHgLigzALSxPEucQz60FiC/6Ql\n oNEYNgtge0YMlBGQ5S1aSyADGvFlyaonyPkQX66hEGz59ir6tS34jquIRny7NTkJrAFt\n hGFCmAD6KkmEhpqtHKSBhZrrt5YqBb8b7D0urPYf3PJy9/sTsZIXa3TdKTQnSkDiL1Sn\n OHPaUWlHlLSR1KxbW7cI9kUTGq41lbfr4JGWVpoRhpcXTACzn39ozk8HL/OjFRDuU4tN\n XJZ3wcXTidupB35K0EhV+sNDOA4iJkgVEBkNLS49sFeV0R26KqDM3PKUfwPCW5kYG7my\n J1rw==","X-Gm-Message-State":"AOJu0YzYnU5sFd1CHassYZeXAiTxTH4aBaHmFen/1T5RJZbdO5BI3KMj\n QCP3NuYfH1xbIC7iBkNWyLE9V4rYCjMlQlhpKhms5zRb9fjDg3NNkWzPJxFYoR/CYp4+LmutIcX\n fjxvQMExtB5pIOlD3srZnxCUOe4tFqwKe8Jz2EYrWb3I5/YLpiaGXPRiEvXrwKgib2fmTL7K0FD\n 7wtaxYWtjdmzG4l+UcvkC50l0wI8TSi1Ewlcuv","X-Gm-Gg":"AeBDievw0yPvUq0WJmE2rLhCAFb1DMeBWFGVq3nh8ESnT8rcDYy5zHxceqjXIUl79Sv\n bgwwRMrtl54q+UEhaHTFRtJYTVrUA91/1Q7TkLas8LUzT6PLL/Jv4rUCOcAODordp4D3xJ94gQk\n Kq30GOT1PDXADhv9vQCQxlyTUxk/FvobPUSiCC357oc22xW3LrTXft6Dp2ZZHuTorpdyPkjHdwA\n laTtNGb4IjWCHB/","X-Received":["by 2002:a05:6820:211:b0:694:9b71:3745 with SMTP id\n 006d021491bc7-69668529637mr634282eaf.57.1777409729148;\n Tue, 28 Apr 2026 13:55:29 -0700 (PDT)","by 2002:a05:6820:211:b0:694:9b71:3745 with SMTP id\n 006d021491bc7-69668529637mr634267eaf.57.1777409728629; Tue, 28 Apr 2026\n 13:55:28 -0700 (PDT)"],"MIME-Version":"1.0","References":"<20260428174509.145440-1-mmichels@redhat.com>\n \n ","In-Reply-To":"","Date":"Tue, 28 Apr 2026 16:55:17 -0400","X-Gm-Features":"AVHnY4KCljbg40juAjU__k9hjjCzxR4tPH8OanFeV1bEkqNoXajKfneWICtvHoo","Message-ID":"\n ","To":"Ilya Maximets ","Cc":"dev@openvswitch.org","X-Mimecast-Spam-Score":"0","X-Mimecast-MFC-PROC-ID":"FzzIvMYp4Xf_uHiAPKoOxWO1p3gD1CpM0y-bPMRmJ8U_1777409729","X-Mimecast-Originator":"redhat.com","Subject":"Re: [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":"","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","From":"Mark Michelson via dev ","Reply-To":"Mark Michelson ","Content-Type":"text/plain; charset=\"utf-8\"","Content-Transfer-Encoding":"base64","Errors-To":"ovs-dev-bounces@openvswitch.org","Sender":"\"dev\" "}}]