From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-6.0 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id CD7A87D2EF for ; Wed, 29 May 2019 22:30:54 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726411AbfE2Way (ORCPT ); Wed, 29 May 2019 18:30:54 -0400 Received: from ms.lwn.net ([45.79.88.28]:43864 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726018AbfE2Way (ORCPT ); Wed, 29 May 2019 18:30:54 -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 6ECC660C; Wed, 29 May 2019 22:30:53 +0000 (UTC) Date: Wed, 29 May 2019 16:30:52 -0600 From: Jonathan Corbet To: "Tobin C. Harding" Cc: Al Viro , Mauro Carvalho Chehab , Neil Brown , Randy Dunlap , linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v4 0/9] docs: Convert VFS doc to RST Message-ID: <20190529163052.6ce91581@lwn.net> In-Reply-To: <20190515002913.12586-1-tobin@kernel.org> References: <20190515002913.12586-1-tobin@kernel.org> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Wed, 15 May 2019 10:29:04 +1000 "Tobin C. Harding" wrote: > Here is an updated version of the VFS doc conversion. This series in no > way represents a final point for the VFS documentation rather it is a > small step towards getting VFS docs updated. This series does not > update the content of vfs.txt, only does formatting. I've finally gotten to this, sorry for taking so long. Applying it to docs-next turned out to be a bit of a chore; there have been intervening changes to vfs.txt that we didn't want to lose. But I did it. Unfortunately, there's still a remaining issue. You did a lot of list conversions like this: > - struct file_system_type *fs_type: describes the filesystem, partly initialized > +``struct file_system_type *fs_type``: describes the filesystem, partly initialized > by the specific filesystem code but that does not render the way you would like, trust me. You really want to use the list format, something like: ``struct file_system_type *fs_type`` describes the filesystem, partly initialized by the specific filesystem code There are, unfortunately, a lot of these to fix... I bet it could be done with an elisp function, but I don't have time to beat my head against that wall right now. Any chance you would have time to send me a followup patch fixing these up? I'll keep my branch with this set for now so there's no need to rebase those. Thanks, jon