Received: by 2002:a05:6a10:a0d1:0:0:0:0 with SMTP id j17csp1133038pxa; Wed, 5 Aug 2020 23:49:26 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz20ibwZmFDxArU5ryFi0Y/UVzPebVJEGT6WX3rI2pdyyh+6W2bKr0JIj7yeGm65LH2S2Vy X-Received: by 2002:a17:906:eb4f:: with SMTP id mc15mr2820899ejb.435.1596696566362; Wed, 05 Aug 2020 23:49:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1596696566; cv=none; d=google.com; s=arc-20160816; b=K9xDKhGWOQLTQuTGZk0XWPNnwXf+bAXSAn72d7ySgDmzP+E9V+/drubGB9mgmMFCb6 ouSMYGAd0y3iTtCnrJw3Sp+Yig613LUP3QPHQyseMnR52M+kSiE4X/t9q6IHqY3dJsvP RgOGSf/0fTZJ/+6dopdG9P9fiUXTCxoKfDUeErW+8lGgsTEqBQ89kpwZcZYt8UhbsnyW UUKBhFGGiyVg2t8SqGL8H27/ovi6XuLKqo16nrggSMjKzIRS6yPK2A50qb2ZzvA11WmJ iJU4G6HgyH9wy83GRu0dzzTk/xh1BG2LVEEm6aBtIQ+nB4Rc4Wh/kB9nWJIwxhrq1Jjs uRDA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:in-reply-to:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :dkim-signature; bh=0ETtt3bGMW4XUze5AkKh67V3N6Iw1g4CzmBpAFLh8dA=; b=U2u1G0ny/hXjmG9w1Vfgrs6bbwglM+qz0JoVRaHVWtl8RKtvar5akkHGgey+TZBYbG 7zBM/mx6UXqx06Ncn4PsyDlrZcGgd51txt+EMQme7n7OJL3Sno53nIrbzPBQhz/vuqJ4 C3/4iHqE20K7xsPlyiNUNzAW4VQxoEPSF7ALLWHlpBQsF/P/9nBAtDWbctQajzpkn16I VsexZOcbBjkZ8hp9Rro+YkO6Nek/J9Re67HSGhl6qMmwZuRnEKQ/V3oAjgkAfE3/8qy8 cTMNd8q1dFDSu9vvqDyED68n2eekS1hyj7e3SZG+CXHHKHEc/Bp6mpjJKE8Ls0oW709g gCgw== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@infradead.org header.s=casper.20170209 header.b=LOGJ0PUy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id d27si2665745ejb.176.2020.08.05.23.49.03; Wed, 05 Aug 2020 23:49:26 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=fail header.i=@infradead.org header.s=casper.20170209 header.b=LOGJ0PUy; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728298AbgHFGsm (ORCPT + 99 others); Thu, 6 Aug 2020 02:48:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35382 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728050AbgHFGsl (ORCPT ); Thu, 6 Aug 2020 02:48:41 -0400 Received: from casper.infradead.org (casper.infradead.org [IPv6:2001:8b0:10b:1236::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B84CDC061574; Wed, 5 Aug 2020 23:48:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=In-Reply-To:Content-Type:MIME-Version: References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=0ETtt3bGMW4XUze5AkKh67V3N6Iw1g4CzmBpAFLh8dA=; b=LOGJ0PUyOjZnOZ6qc8Gbcev0hM nGf4lIqxQMzNZJSOHwUvWg1h8K8UgxSgcVRfGOxT4q6ry9ij9JdSqbLtCvjxKlLZ63dWBKIE/0dMh gbOcqmzPuSeU8P/Vv2nPxzZ6h6s4mSIAMHrYHJsZWLaQoSE1W4p1F2MOmyo/P7aO9Cp9bPWhzHYgs QvFsEeXdQoGtxe0X8ZEsVuU5dIlEArBlUzMBV+COpY6H+BsBvce4wOSV3BgoozGc3vqbtZFEgaGbB OuEVL3rH0Asa2Y9fgK9dnmTDWiYc11Dbsaq9pbdQWiweknpTqAY/eZI7FrIXSSd1R2HRgezDNBNdr qq0MBRaQ==; Received: from hch by casper.infradead.org with local (Exim 4.92.3 #3 (Red Hat Linux)) id 1k3ZhP-0002MU-JT; Thu, 06 Aug 2020 06:48:23 +0000 Date: Thu, 6 Aug 2020 07:48:23 +0100 From: Christoph Hellwig To: peterz@infradead.org Cc: Vegard Nossum , NeilBrown , Steven Rostedt , Jonathan Corbet , linux-doc@vger.kernel.org, LKML Subject: Re: Minor RST rant Message-ID: <20200806064823.GA7292@infradead.org> References: <20200724132200.51fd2065@oasis.local.home> <20200724113325.44923f75@lwn.net> <20200724144234.3227b501@oasis.local.home> <877dusv5lc.fsf@notabene.neil.brown.name> <20200729124445.GB2638@hirez.programming.kicks-ass.net> <1e60ff85-4965-92cb-e50b-8ea9ccf6788e@oracle.com> <20200805151230.GT2674@hirez.programming.kicks-ass.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200805151230.GT2674@hirez.programming.kicks-ass.net> X-SRS-Rewrite: SMTP reverse-path rewritten from by casper.infradead.org. See http://www.infradead.org/rpr.html Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, Aug 05, 2020 at 05:12:30PM +0200, peterz@infradead.org wrote: > On Wed, Aug 05, 2020 at 04:49:50PM +0200, Vegard Nossum wrote: > > FWIW, I *really* like how the extra markup renders in a browser, and I > > don't think I'm the only one. > > The thing is, I write code in a text editor, not a browser. When a > header file says: read Documentation/foo I do 'gf' and that file gets > opened in a buffer. > > Needing a browser is a fail. And that is my main problem with all the RST craze. It optmizes for shiny display in a browser, but copletely messed up the typical developer flow.