Received: by 2002:a25:ab43:0:0:0:0:0 with SMTP id u61csp8457632ybi; Thu, 6 Jun 2019 12:39:40 -0700 (PDT) X-Google-Smtp-Source: APXvYqwnMN7M72lLOZPlo8sFF6kPJ1XDknRutknpnPeGAQHOk0zg/a6XZA1VSsYz6iq+DnAPbcIO X-Received: by 2002:a62:e417:: with SMTP id r23mr23236755pfh.160.1559849980028; Thu, 06 Jun 2019 12:39:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1559849980; cv=none; d=google.com; s=arc-20160816; b=y0XoMW3QLocTrRHhyTZOCoO5uNfYIZKye7kbbzgSz4q1sa+uRwguZdMvkOH/OkyvBQ 9w+n+ee7JdMD7EAzw9KimoZQdlFoffloL/nU/r0rPJyVfu3BGqGAES2coglfSDOMtvhw kXOPlqOIulGaSFMLsd/hm/iYKugDkGIzf61nImK8Q2tZSpPli40TBPz9x5Htwxnpje73 xo/Ze4KwqGxCU7qQPWArP1uJpj59fmcPQK3fQGMclgRDP5tsK7VyQjWYdbWOK930SK1m kewB+RTQa5+TWkK/xNa4OyF8Uwskb9AHGWMZOSx2p5kLT67JpC0Iq4Jdm93cZ6KaYS9J Gpgg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=1q68QSQMUu1hT/+gaajsBC4vs9Xky/6i8LQ/kQmHYxE=; b=LEwep5W8q0E9IdDD+zz/FoAER7+YIqqDTpFPCyELsa2m/U97cIBWTa5riiZwehcspC zupXyZ7/mUfr1Vwic7rL42n5PTfiXKHwSpA1iNSoLkpLIbPPBn49hSvSmceE0994xTwl Zj8IGBwisemDZrbQKJ4TsfXFcHrAApO/QAiVDtO3tcGezbP9ePGIW8oi5oJhJIAuGEMp xAngzaKMGfVTZoW9oOrOrdw1e9S/AxQPc6CEoL9FK3zxveAADVrt7fWWCFoohg7+xcYm lcrFfgMTCAXkzcBDoGjRfI5N7fEsS1oJI5NQYbV40uz/jkwJuIPSbLrFPyEZA5nFH1R1 G9tg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id t3si2741477pgq.254.2019.06.06.12.39.23; Thu, 06 Jun 2019 12:39:40 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729424AbfFFPqb (ORCPT + 99 others); Thu, 6 Jun 2019 11:46:31 -0400 Received: from ms.lwn.net ([45.79.88.28]:50162 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729344AbfFFPqa (ORCPT ); Thu, 6 Jun 2019 11:46:30 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 0CCF9737; Thu, 6 Jun 2019 15:46:30 +0000 (UTC) Date: Thu, 6 Jun 2019 09:46:28 -0600 From: Jonathan Corbet To: "Tobin C. Harding" Cc: Al Viro , Neil Brown , Randy Dunlap , linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs: filesystems: vfs: Render method descriptions Message-ID: <20190606094628.0e8775f7@lwn.net> In-Reply-To: <20190604002656.30925-1-tobin@kernel.org> References: <20190604002656.30925-1-tobin@kernel.org> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, 4 Jun 2019 10:26:56 +1000 "Tobin C. Harding" wrote: > Currently vfs.rst does not render well into HTML the method descriptions > for VFS data structures. We can improve the HTML output by putting the > description string on a new line following the method name. > > Suggested-by: Jonathan Corbet > Signed-off-by: Tobin C. Harding > --- > > Jon, > > As discussed on LKML; this patch applies on top of the series > > [PATCH v4 0/9] docs: Convert VFS doc to RST > > If it does not apply cleanly to your branch please feel free to ask me > to fix it. There was one merge conflict, but nothing too serious. I've applied it, and things look a lot better - thanks! jon