From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.2 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_SANE_2 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 67E71C433B4 for ; Wed, 7 Apr 2021 07:33:31 +0000 (UTC) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id C5C4861245 for ; Wed, 7 Apr 2021 07:33:30 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org C5C4861245 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=kaod.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Received: from localhost ([::1]:46386 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lU2gr-0005RW-Hq for qemu-devel@archiver.kernel.org; Wed, 07 Apr 2021 03:33:29 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37416) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lU2g8-00051v-Kq for qemu-devel@nongnu.org; Wed, 07 Apr 2021 03:32:44 -0400 Received: from smtpout1.mo529.mail-out.ovh.net ([178.32.125.2]:41909) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lU2g6-00021G-Hz for qemu-devel@nongnu.org; Wed, 07 Apr 2021 03:32:44 -0400 Received: from mxplan5.mail.ovh.net (unknown [10.109.146.249]) by mo529.mail-out.ovh.net (Postfix) with ESMTPS id 042FC97C9221; Wed, 7 Apr 2021 09:32:31 +0200 (CEST) Received: from kaod.org (37.59.142.99) by DAG8EX1.mxp5.local (172.16.2.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2106.2; Wed, 7 Apr 2021 09:32:31 +0200 Authentication-Results: garm.ovh; auth=pass (GARM-99G00349945f9e-a0ec-4544-a811-b14d99f08777, 14E8A29DAE054FFFC15D378747E0F684EF09551A) smtp.auth=groug@kaod.org X-OVh-ClientIp: 78.197.208.248 Date: Wed, 7 Apr 2021 09:32:30 +0200 From: Greg Kurz To: Christian Schoenebeck Subject: Re: [PATCH 0/4] add in-tree 9pfs developers documentation Message-ID: <20210407093230.5b172a8a@bahia.lan> In-Reply-To: <3541529.Jmkro1RegT@silver> References: <3541529.Jmkro1RegT@silver> X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Originating-IP: [37.59.142.99] X-ClientProxiedBy: DAG9EX2.mxp5.local (172.16.2.82) To DAG8EX1.mxp5.local (172.16.2.71) X-Ovh-Tracer-GUID: c593d76c-49ae-4308-ac34-9f3eebd636e0 X-Ovh-Tracer-Id: 6921751153251555808 X-VR-SPAMSTATE: OK X-VR-SPAMSCORE: -100 X-VR-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgeduledrudejiedguddvvdcutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfqggfjpdevjffgvefmvefgnecuuegrihhlohhuthemucehtddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpeffhffvuffkjghfofggtgfgihesthhqredtredtjeenucfhrhhomhepifhrvghgucfmuhhriicuoehgrhhouhhgsehkrghougdrohhrgheqnecuggftrfgrthhtvghrnhepudfhueffjeeitdffkeefvddvheeuleefjeehudfhtdetkeeiieekhfeiffeliefhnecuffhomhgrihhnpehqvghmuhdrohhrghdpghhithhhuhgsrdgtohhmnecukfhppedtrddtrddtrddtpdefjedrheelrddugedvrdelleenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhhouggvpehsmhhtphdqohhuthdphhgvlhhopehmgihplhgrnhehrdhmrghilhdrohhvhhdrnhgvthdpihhnvghtpedtrddtrddtrddtpdhmrghilhhfrhhomhepghhrohhugheskhgrohgurdhorhhgpdhrtghpthhtohepphgvthgvrhdrmhgrhiguvghllheslhhinhgrrhhordhorhhg Received-SPF: pass client-ip=178.32.125.2; envelope-from=groug@kaod.org; helo=smtpout1.mo529.mail-out.ovh.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Paolo Bonzini , qemu-devel@nongnu.org, Peter Maydell Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: "Qemu-devel" On Tue, 06 Apr 2021 14:27:41 +0200 Christian Schoenebeck wrote: > On Dienstag, 23. M=C3=A4rz 2021 20:40:20 CEST Christian Schoenebeck wrote: > > The original source for the QEMU 9p developers documentation is: > >=20 > > https://wiki.qemu.org/Documentation/9p > >=20 > > This patch set adds it as in-tree .rst file along with its pictures to = the > > QEMU source tree. The 9p.rst file has been auto generated by 'pandoc'. > >=20 > > Preview of generated 9p.rst file with pictures: > >=20 > > =20 > > https://github.com/cschoenebeck/qemu/blob/bbc74655d54f2fa9c3eabf485e87f= 9952 > > 53b8cfd/docs/devel/9p.rst > >=20 > > Picture binary files (omitted as binary blobs from patch 2): > >=20 > > =20 > > https://github.com/cschoenebeck/qemu/tree/bbc74655d54f2fa9c3eabf485e87f= 9952 > > 53b8cfd/docs/devel/img > >=20 > > Or simply access my '9p.experimental' branch on github. > >=20 > > I have no idea if that fits into the current sphinx/meson concept in th= is > > form and way. I hope either Peter or Paolo might tell. > >=20 > > The individual patches could also be squashed, I kept them split for no= w to > > show what pandoc actually did and what I manually adjusted afterwards. > >=20 > > Christian Schoenebeck (4): > > docs/devel: add 9p.rst > > docs/devel: add directory for pictures > > docs/devel/9p: fix references to pictures > > MAINTAINERS: add responsibility for docs/devel/9p.rst >=20 > Ping >=20 > Anyone? On doubt I just leave the 9p developer docs solely on the wiki si= te. >=20 Hi Christian, Sorry for the delay... well, it is probably handy to have some in-tree documentation. This being said I can't really tell if it makes sense to have an exact copy of the wiki... or if this should simply replace the wiki. Also, do we want to host the png files ? It seems that other in-tree documentation rather relies on ASCII-art, which provides a more terminal-friendly experience. Cheers, -- Greg > >=20 > > MAINTAINERS | 1 + > > docs/devel/9p.rst | 544 +++++++++++++++++++++++++++ > > docs/devel/img/9pfs_control_flow.png | Bin 0 -> 156560 bytes > > docs/devel/img/9pfs_topology.png | Bin 0 -> 51529 bytes > > docs/devel/img/Coroutines_stacks.png | Bin 0 -> 87204 bytes > > 5 files changed, 545 insertions(+) > > create mode 100644 docs/devel/9p.rst > > create mode 100644 docs/devel/img/9pfs_control_flow.png > > create mode 100644 docs/devel/img/9pfs_topology.png > > create mode 100644 docs/devel/img/Coroutines_stacks.png >=20 > Best regards, > Christian Schoenebeck >=20 >=20