From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Corbet Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst Date: Tue, 23 Apr 2019 14:34:38 -0600 Message-ID: <20190423143438.6a7ce0f2@lwn.net> References: <20190423083135.GA11158@hirez.programming.kicks-ass.net> <20190423125519.GA7104@redhat.com> <20190423130132.GT4038@hirez.programming.kicks-ass.net> <20190423103053.07cf2149@lwn.net> <20190423171158.GG12232@hirez.programming.kicks-ass.net> <20190423115349.589c3d50@lwn.net> <20190423171944.7ac6db54@coco.lan> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: In-Reply-To: <20190423171944.7ac6db54-qA1ZUp+OV9c@public.gmane.org> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: iommu-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org Errors-To: iommu-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org To: Mauro Carvalho Chehab Cc: Mike Snitzer , "Rafael J. Wysocki" , Linus Walleij , Farhan Ali , Will Deacon , dri-devel-PD4FTy7X32lNgt0PjOBp9y5qC8QIuHrW@public.gmane.org, Jaroslav Kysela , kernel-hardening-ZwoEplunGu1jrUoiu81ncdBPR1lH4CV8@public.gmane.org, Christoph Hellwig , linux-arch-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, linux-sh-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, James Morris , Halil Pasic , tboot-devel-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org, Alan Stern , openipmi-developer-5NWGOfrQmneRv+LV9MX5uipxlwaOVQ5f@public.gmane.org, Guenter Roeck , Boqun Feng , Nicholas Piggin , Alex Williamson , Matt Mackall , Thomas Gleixner , Sean Paul , Greg Kroah-Hartman , linux-wireless@v List-Id: linux-gpio@vger.kernel.org On Tue, 23 Apr 2019 17:19:44 -0300 Mauro Carvalho Chehab wrote: > Anyway, one of the things that occurred to me is that maybe > some scripting work or a ReST extension could do something to parse > "Documentation/foo" as :doc:`Documentation/foo` without needing to > explicitly use any ReST specific tags. That probably makes sense too. People do want to link to specific subsections within documents, though; maybe we could allow "Documentation/foo#bar" for that. Such "markup" could even be useful for people reading the plain-text files. Thanks, jon 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=-1.0 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_PASS 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 C4470C10F03 for ; Tue, 23 Apr 2019 20:35:12 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 7B85A218B0 for ; Tue, 23 Apr 2019 20:35:12 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 7B85A218B0 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=lwn.net Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 199ED6B0003; Tue, 23 Apr 2019 16:35:12 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 149186B0005; Tue, 23 Apr 2019 16:35:12 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 010E26B0007; Tue, 23 Apr 2019 16:35:11 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from mail-pg1-f198.google.com (mail-pg1-f198.google.com [209.85.215.198]) by kanga.kvack.org (Postfix) with ESMTP id BBAF66B0003 for ; Tue, 23 Apr 2019 16:35:11 -0400 (EDT) Received: by mail-pg1-f198.google.com with SMTP id r5so4294139pgb.11 for ; Tue, 23 Apr 2019 13:35:11 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-original-authentication-results:x-gm-message-state:date:from:to :cc:subject:message-id:in-reply-to:references:organization :mime-version:content-transfer-encoding; bh=NWym8ed0ac5YijevlL+9P33gekKbYTV5W+hQH97w1zw=; b=SA5c3ZHMHjRdhbvsbJ47D/zHfTC9J/jUP/15YhBfDYyqmjkKum6tTG6/o1ThLq4U/R Pbt15GzW9N0YD51MonmVp4VukuUZp4Ke5IHQeBy+2rG/nYJsD9VRLfQJXOmvAkJ1nCuR Vzv5B2SPstbeuPVDEgnFbkARWmnWMWp1M49G+mLjj9HDlypwABaWlnsQOl7RheZKwqKC m1kFOx2xEG1RKGoI/ckgVC2sNUmQJFJ0v/dZQfskn2hP5WJISUfaNZ5u+uHP92xfJTis DNbReFfMAP6T16LY6WAsCyBoHOHn7FhbU0MahQg5NgNjHYLBPVFFsMs6McVzfRrrvKgj rp4g== X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net X-Gm-Message-State: APjAAAWWxAA+gQ5+3zKAebKzaU41NM9kBdombJz5Fwf7xuAdxsPxmFWn unYPvfeG9YOJhntNK0QyyefbiT7hhIJf4rcuGbsJ1kx3+aRyceE5DZ7lUFnKKPqKz50aRyRiiMR z0J3UDi6qAUdNEBsktVtmCdliTbOvLTO7Syk65GI/BHwUsA3uNWa9RnXYMZ7DAypiZw== X-Received: by 2002:a17:902:1d4a:: with SMTP id u10mr2724153plu.272.1556051711336; Tue, 23 Apr 2019 13:35:11 -0700 (PDT) X-Google-Smtp-Source: APXvYqxcuvTYntd0mBLpytNvUJOmPTHA0lradzs56+/wRuCU7L15r4OA1XbIr4eDBOlY7euF9fto X-Received: by 2002:a17:902:1d4a:: with SMTP id u10mr2724109plu.272.1556051710671; Tue, 23 Apr 2019 13:35:10 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1556051710; cv=none; d=google.com; s=arc-20160816; b=I7AZlEok12KufmVOgaCeSVcV6DI3xbj5+d0gH4ahvhNisTN1GQzVW+krLyqtbwx1Ss ibPOb/7jnKuaYsP22tdOaGv33uDMHLbNbf8NYYE4fw06Su8hmpYNhSwstXMJ9HDbQejU vVm8XpSzYzxVx9HpukfSOHQnKERr9Bz6VObdZ6fLZSYmzW7UXLwNPnKDYvXoS3IEtG5p TrywtaiHqKhYn4AbxHuSl0gPtKLu9BCNJJXKHLeaidqmMAUBv32Mif/u/TJuUS9QIaB9 sXQlUL0iCXLr3Cqf3ORudtTcA8HD51Ncei/XEQvpEgTFPsXMXdUu+VUQPxU6+2cxKXEi o3NQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:organization:references :in-reply-to:message-id:subject:cc:to:from:date; bh=NWym8ed0ac5YijevlL+9P33gekKbYTV5W+hQH97w1zw=; b=mVYYLywmGM4gGpO2k9ZrI5ZIdeebOL8SP5DhSm7Udqngc4I53IoXLCOsmldVasnyJe LxJi1j4m40nUJrpxdkuk6HfaNEA1X7sjS8z01tuWswP0WGEZWhTAEQ+Nhos7i4o3zHUZ +4OeMT9nW0oJ95KZbtQWr702IQ0eevRT7+6nml1lJswSHL3MOhUI7Z4YDOGv98jBGS/n WE05lIl7sOlmBMhEDIYzcupwOY61/pNnY125JZg7oewMQqcm76hcu4Ar2AeVdUpyuG0j x/6GlcVcHek6jKwhy1TdAfpdB1JPhcXBbUdrlD5+lrOXMHJpPfXwSwZCrDv9LSRCS7Mv Cb3A== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net Received: from ms.lwn.net (ms.lwn.net. [45.79.88.28]) by mx.google.com with ESMTPS id e92si17672217pld.252.2019.04.23.13.35.10 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 23 Apr 2019 13:35:10 -0700 (PDT) Received-SPF: pass (google.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) client-ip=45.79.88.28; Authentication-Results: mx.google.com; spf=pass (google.com: domain of corbet@lwn.net designates 45.79.88.28 as permitted sender) smtp.mailfrom=corbet@lwn.net Received: from localhost.localdomain (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 5739A2DD; Tue, 23 Apr 2019 20:34:42 +0000 (UTC) Date: Tue, 23 Apr 2019 14:34:38 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Peter Zijlstra , Mike Snitzer , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Johannes Berg , Kurt Schwemmer , Logan Gunthorpe , Bjorn Helgaas , Alasdair Kergon , dm-devel@redhat.com, Kishon Vijay Abraham I , Rob Herring , Mark Rutland , Bartlomiej Zolnierkiewicz , David Airlie , Daniel Vetter , Maarten Lankhorst , Maxime Ripard , Sean Paul , Ning Sun , Ingo Molnar , Will Deacon , Alan Stern , Andrea Parri , Boqun Feng , Nicholas Piggin , David Howells , Jade Alglave , Luc Maranget , "Paul E. McKenney" , Akira Yokosawa , Daniel Lustig , "David S. Miller" , Andreas =?UTF-8?B?RsOkcmJlcg==?= , Manivannan Sadhasivam , Cornelia Huck , Farhan Ali , Eric Farman , Halil Pasic , Martin Schwidefsky , Heiko Carstens , Harry Wei , Alex Shi , Jerry Hoemann , Wim Van Sebroeck , Guenter Roeck , Thomas Gleixner , Borislav Petkov , "H. Peter Anvin" , x86@kernel.org, Russell King , Tony Luck , Fenghua Yu , "James E.J. Bottomley" , Helge Deller , Yoshinori Sato , Rich Felker , Guan Xuetao , Jens Axboe , Greg Kroah-Hartman , "Rafael J. Wysocki" , Arnd Bergmann , Matt Mackall , Herbert Xu , Corey Minyard , Sumit Semwal , Linus Walleij , Bartosz Golaszewski , Darren Hart , Andy Shevchenko , Stuart Hayes , Jaroslav Kysela , Alex Williamson , Kirti Wankhede , Christoph Hellwig , Marek Szyprowski , Robin Murphy , Steffen Klassert , Kees Cook , Emese Revfy , James Morris , "Serge E. Hallyn" , linux-wireless@vger.kernel.org, linux-pci@vger.kernel.org, devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-fbdev@vger.kernel.org, tboot-devel@lists.sourceforge.net, linux-arch@vger.kernel.org, netdev@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-s390@vger.kernel.org, kvm@vger.kernel.org, linux-watchdog@vger.kernel.org, linux-ia64@vger.kernel.org, linux-parisc@vger.kernel.org, linux-sh@vger.kernel.org, sparclinux@vger.kernel.org, linux-block@vger.kernel.org, linux-crypto@vger.kernel.org, openipmi-developer@lists.sourceforge.net, linaro-mm-sig@lists.linaro.org, linux-gpio@vger.kernel.org, platform-driver-x86@vger.kernel.org, iommu@lists.linux-foundation.org, linux-mm@kvack.org, kernel-hardening@lists.openwall.com, linux-security-module@vger.kernel.org Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst Message-ID: <20190423143438.6a7ce0f2@lwn.net> In-Reply-To: <20190423171944.7ac6db54@coco.lan> References: <20190423083135.GA11158@hirez.programming.kicks-ass.net> <20190423125519.GA7104@redhat.com> <20190423130132.GT4038@hirez.programming.kicks-ass.net> <20190423103053.07cf2149@lwn.net> <20190423171158.GG12232@hirez.programming.kicks-ass.net> <20190423115349.589c3d50@lwn.net> <20190423171944.7ac6db54@coco.lan> Organization: LWN.net X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On Tue, 23 Apr 2019 17:19:44 -0300 Mauro Carvalho Chehab wrote: > Anyway, one of the things that occurred to me is that maybe > some scripting work or a ReST extension could do something to parse > "Documentation/foo" as :doc:`Documentation/foo` without needing to > explicitly use any ReST specific tags. That probably makes sense too. People do want to link to specific subsections within documents, though; maybe we could allow "Documentation/foo#bar" for that. Such "markup" could even be useful for people reading the plain-text files. Thanks, jon 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=-1.0 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_PASS,URIBL_BLOCKED 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 3957EC282E1 for ; Tue, 23 Apr 2019 20:35:13 +0000 (UTC) Received: from mail.linuxfoundation.org (mail.linuxfoundation.org [140.211.169.12]) (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 0FA81218C3 for ; Tue, 23 Apr 2019 20:35:12 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 0FA81218C3 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=lwn.net Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=iommu-bounces@lists.linux-foundation.org Received: from mail.linux-foundation.org (localhost [127.0.0.1]) by mail.linuxfoundation.org (Postfix) with ESMTP id D0A16F36; Tue, 23 Apr 2019 20:35:12 +0000 (UTC) Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org [172.17.192.35]) by mail.linuxfoundation.org (Postfix) with ESMTPS id 32B87F32 for ; Tue, 23 Apr 2019 20:35:11 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from ms.lwn.net (ms.lwn.net [45.79.88.28]) by smtp1.linuxfoundation.org (Postfix) with ESMTPS id BC1E882D for ; Tue, 23 Apr 2019 20:35:10 +0000 (UTC) Received: from localhost.localdomain (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 5739A2DD; Tue, 23 Apr 2019 20:34:42 +0000 (UTC) Date: Tue, 23 Apr 2019 14:34:38 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst Message-ID: <20190423143438.6a7ce0f2@lwn.net> In-Reply-To: <20190423171944.7ac6db54@coco.lan> References: <20190423083135.GA11158@hirez.programming.kicks-ass.net> <20190423125519.GA7104@redhat.com> <20190423130132.GT4038@hirez.programming.kicks-ass.net> <20190423103053.07cf2149@lwn.net> <20190423171158.GG12232@hirez.programming.kicks-ass.net> <20190423115349.589c3d50@lwn.net> <20190423171944.7ac6db54@coco.lan> Organization: LWN.net X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Cc: Mike Snitzer , "Rafael J. Wysocki" , Linus Walleij , Farhan Ali , Will Deacon , dri-devel@lists.freedesktop.org, Jaroslav Kysela , kernel-hardening@lists.openwall.com, Christoph Hellwig , linux-arch@vger.kernel.org, linux-sh@vger.kernel.org, James Morris , Halil Pasic , tboot-devel@lists.sourceforge.net, Alan Stern , openipmi-developer@lists.sourceforge.net, Guenter Roeck , Boqun Feng , Nicholas Piggin , Alex Williamson , Matt Mackall , Thomas Gleixner , Sean Paul , Greg Kroah-Hartman , linux-wireless@vger.kernel.org, linux-kernel@vger.kernel.org, linux-crypto@vger.kernel.org, Mark Rutland , linux-fbdev@vger.kernel.org, linux-ia64@vger.kernel.org, Linux Doc Mailing List , David Airlie , "James E.J. Bottomley" , dm-devel@redhat.com, Harry Wei , Manivannan Sadhasivam , Alasdair Kergon , linux-s390@vger.kernel.org, Alex Shi , Yoshinori Sato , Helge Deller , Sumit Semwal , Bartosz Golaszewski , Eric Farman , linux-watchdog@vger.kernel.org, Corey Minyard , Mauro Carvalho Chehab , linaro-mm-sig@lists.linaro.org, linux-gpio@vger.kernel.org, Bjorn Helgaas , linux-arm-kernel@lists.infradead.org, Tony Luck , Cornelia Huck , "David S. Miller" , Martin Schwidefsky , Andrea Parri , linux-pci@vger.kernel.org, Akira Yokosawa , Heiko Carstens , platform-driver-x86@vger.kernel.org, "Paul E. McKenney" , Kishon Vijay Abraham I , Peter Zijlstra , Emese Revfy , Darren Hart , Jade Alglave , "Serge E. Hallyn" , Fenghua Yu , Kees Cook , Arnd Bergmann , Bartlomiej Zolnierkiewicz , Ning Sun , Borislav Petkov , Luc Maranget , Kurt Schwemmer , Guan Xuetao , linux-parisc@vger.kernel.org, iommu@lists.linux-foundation.org, Stuart Hayes , Logan Gunthorpe , Andreas =?UTF-8?B?RsOkcmJlcg==?= , Rich Felker , kvm@vger.kernel.org, Maxime Ripard , Jerry Hoemann , David Howells , linux-mm@kvack.org, Kirti Wankhede , "H. Peter Anvin" , sparclinux@vger.kernel.org, Steffen Klassert , Herbert Xu , x86@kernel.org, Russell King , Ingo Molnar , devicetree@vger.kernel.org, Daniel Lustig , Maarten Lankhorst , linux-block@vger.kernel.org, Rob Herring , Wim Van Sebroeck , Jens Axboe , netdev@vger.kernel.org, linux-security-module@vger.kernel.org, Daniel Vetter , Johannes Berg , Robin Murphy , Andy Shevchenko X-BeenThere: iommu@lists.linux-foundation.org X-Mailman-Version: 2.1.12 Precedence: list List-Id: Development issues for Linux IOMMU support List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit Sender: iommu-bounces@lists.linux-foundation.org Errors-To: iommu-bounces@lists.linux-foundation.org Message-ID: <20190423203438.qn-q1_OXtaqd_f60d34aNPKZUqhvXtquMwe4F0nwPpc@z> On Tue, 23 Apr 2019 17:19:44 -0300 Mauro Carvalho Chehab wrote: > Anyway, one of the things that occurred to me is that maybe > some scripting work or a ReST extension could do something to parse > "Documentation/foo" as :doc:`Documentation/foo` without needing to > explicitly use any ReST specific tags. That probably makes sense too. People do want to link to specific subsections within documents, though; maybe we could allow "Documentation/foo#bar" for that. Such "markup" could even be useful for people reading the plain-text files. Thanks, jon _______________________________________________ iommu mailing list iommu@lists.linux-foundation.org https://lists.linuxfoundation.org/mailman/listinfo/iommu