Received: by 10.192.165.148 with SMTP id m20csp4508743imm; Tue, 8 May 2018 09:31:09 -0700 (PDT) X-Google-Smtp-Source: AB8JxZrl7XjBupCfmfdkd+uZ8hKjLXlVgUSH/zF1ZJJttW4dreXQxB2UDAm0q1h2Kt0kr/vyMMkq X-Received: by 2002:a17:902:ab98:: with SMTP id f24-v6mr15403489plr.144.1525797069610; Tue, 08 May 2018 09:31:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1525797069; cv=none; d=google.com; s=arc-20160816; b=wwvW+2yJOtiOgOx0rQo/mjT5QKVHiXFu99d36q5EFzzD6J9KwIAZQazL4jsuNIBnul kl7fjkEJOnX+MVIAQC8LsiDgxeYlQ45FCBcxu+N3EDfEzjyKGzEaIJ9/ukH7+ufppZKC LW4PQ2xs+3dPWZr7Vc0uBM8zTWgm4NGeRj5BEXUVexChU6Gumgi+K3SFmsTDqsjpp/8n vAw7ZelTg29KCmdiF+EeP/6oPE/ULe1lakxgwI55SUfTM5cx/E6HD2bxinCuD0JCmFKh 7bTcBcAhVkCbQbBnKAUSadOnX97OjzG4vBQL/G08+rg1wY5qFmqLNMD1LGBXtfodB7T+ VH7g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-transfer-encoding:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature :arc-authentication-results; bh=qLf0J5s58CveW7XALkBfvtB1y2NsdSpcIwQBA2jFgt8=; b=EY3xwtLUJ8/1vA9+D5ncX7BEO8BUmxVAacDzSivwVzlY0P/lQ+ifQ3dm65PBK2mPT1 s31vesHVlTOKWXYLdNIGGajnHlXljqfwyPK66C6oBkv6WuZjrAKjM+ExNz6ByKjPkMOe 9BIhtUp5q1GNuFoEt0IuQzHgHpQQWJKj3diDegHAjLgAJlVvFtjEYWv2cEJgnFYTX7n+ 2+odX1rXTXm8dINxjHopo1Ng0ucUa1KXbYOETMxPtHUA5DivJgzWpS75Ml+xyDojsGd7 wX6Ue97lcZQbNjnt0rJrU2wLK23k5+586V748QJKdBRkQH67yFATLitwE/eywDozO1pz MRAg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=hcD78ZaZ; 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 y8si24797711pfd.47.2018.05.08.09.30.55; Tue, 08 May 2018 09:31:09 -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; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=hcD78ZaZ; 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 S933099AbeEHQaF (ORCPT + 99 others); Tue, 8 May 2018 12:30:05 -0400 Received: from mail-wm0-f67.google.com ([74.125.82.67]:54404 "EHLO mail-wm0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932743AbeEHQ3H (ORCPT ); Tue, 8 May 2018 12:29:07 -0400 Received: by mail-wm0-f67.google.com with SMTP id f6so19874679wmc.4 for ; Tue, 08 May 2018 09:29:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amarulasolutions.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:content-transfer-encoding:in-reply-to :user-agent; bh=qLf0J5s58CveW7XALkBfvtB1y2NsdSpcIwQBA2jFgt8=; b=hcD78ZaZAwQXX/wXX5UYKSpUWCLvVRm5WCnjAqXaf3zr13+o8l3ZHWDw5nbrXhTJGO nhvBExN42l/Y7tqT3zPpTsqBM09i0Eex0PO/ucFWEeJbWAVIY2PCSGixqIF2cfU7mpw8 l9ui5bhHb5Jn+WykZXffb+xaqP4EvQNyWUz2w= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:content-transfer-encoding :in-reply-to:user-agent; bh=qLf0J5s58CveW7XALkBfvtB1y2NsdSpcIwQBA2jFgt8=; b=YqK1nLI9/XLIsnJtXBNK/czul+w2jHGyCigS/VHdXY35a6W9mvh4cx7pZxyTUfZA+P g1sszimN+iykT0fkPhxRWjizOnE0/yGjqxm5YzwvJm6VITGiICx41E3aabsu7ElBb8WS bR4fs0qyfJJ10qakKkPF50P2jWj+3GBTF0F2O5HSzFIXSJTReG3jVpbyBQ4w7LrXqn5v +ztwMneOOZCGYabpIru8S1Arq0jlr7IzxA61N94VL4RXXQuAq4kGZODmTwnMTNqlqrFt itdUTRy2L/0pVE/iSSCvQrDvX3hNjNJABi788mPZ+EnS8KW98BEyFqH1aIJAn38B8BdE tE7w== X-Gm-Message-State: ALKqPwdzLsAUK6z1hwA48rNfG9LRnngGcnfjKU2cGbuZVEtGtwUUD5/m h2wViBYaixS7CS4tIqvYOeU7fA== X-Received: by 10.28.103.65 with SMTP id b62mr3819049wmc.0.1525796945589; Tue, 08 May 2018 09:29:05 -0700 (PDT) Received: from andrea ([94.230.152.15]) by smtp.gmail.com with ESMTPSA id 69-v6sm14356634wmi.29.2018.05.08.09.29.04 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 08 May 2018 09:29:04 -0700 (PDT) Date: Tue, 8 May 2018 18:28:55 +0200 From: Andrea Parri To: Jani Nikula Cc: Mauro Carvalho Chehab , Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Jonathan Corbet , Alan Stern , Andrea Parri , Will Deacon , Peter Zijlstra , Boqun Feng , Nicholas Piggin , David Howells , Jade Alglave , Luc Maranget , "Paul E. McKenney" , Akira Yokosawa , Matthew Wilcox , Jeff Layton , Randy Dunlap , Elena Reshetova , "Tobin C. Harding" , SeongJae Park , Ingo Molnar , Helmut Grohne Subject: Re: [PATCH 05/18] docs: core-api: add cachetlb documentation Message-ID: <20180508162855.GA8536@andrea> References: <07b59879d34502828467f0190f941e23e08fdc81.1525684985.git.mchehab+samsung@kernel.org> <20180507122937.GA5813@andrea> <87y3gu43d3.fsf@intel.com> <20180508160242.GA5469@andrea> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <20180508160242.GA5469@andrea> User-Agent: Mutt/1.5.24 (2015-08-30) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, May 08, 2018 at 06:02:42PM +0200, Andrea Parri wrote: > Hi Jani, > > On Tue, May 08, 2018 at 05:40:56PM +0300, Jani Nikula wrote: > > On Mon, 07 May 2018, Andrea Parri wrote: > > > On Mon, May 07, 2018 at 06:35:41AM -0300, Mauro Carvalho Chehab wrote: > > >> The cachetlb.txt is already in ReST format. So, move it to the > > >> core-api guide, where it belongs. > > >> > > >> Signed-off-by: Mauro Carvalho Chehab > > >> --- > > >> Documentation/00-INDEX | 2 -- > > >> Documentation/{cachetlb.txt => core-api/cachetlb.rst} | 0 > > >> Documentation/core-api/index.rst | 1 + > > >> Documentation/memory-barriers.txt | 2 +- > > >> Documentation/translations/ko_KR/memory-barriers.txt | 2 +- > > >> 5 files changed, 3 insertions(+), 4 deletions(-) > > >> rename Documentation/{cachetlb.txt => core-api/cachetlb.rst} (100%) > > > > > > I see a few "inline" references to the .txt file in -rc4 (see below): > > > I am not sure if you managed to update them too. > > > > Side note, there's scripts/documentation-file-ref-check to grep the > > kernel tree for things that look like file references to Documentation/* > > and complain if they don't exist. > > > > I get about 350+ hits with that, patches welcome! ;) > > Thanks for pointing out the script/results. > > It's also worth stressing, I think, the fact that some of those are from > the MAINTAINERS file; I stumbled accross one of them yesterday: > > http://lkml.kernel.org/r/1525707655-3542-1-git-send-email-andrea.parri@amarulasolutions.com > > False positives apart (e.g., the four references in tools/memory-model/), > those are regressions from my POV: please do not (consiously) merge more! s/four/five Andrea > > Andrea > > > > > > > > BR, > > Jani. > > > > > > > > > > ./arch/microblaze/include/asm/cacheflush.h:/* Look at Documentation/cachetlb.txt */ > > > ./arch/unicore32/include/asm/cacheflush.h: * See Documentation/cachetlb.txt for more information. > > > ./arch/arm64/include/asm/cacheflush.h: * See Documentation/cachetlb.txt for more information. Please note that > > > ./arch/arm/include/asm/cacheflush.h: * See Documentation/cachetlb.txt for more information. > > > ./arch/xtensa/include/asm/cacheflush.h: * (see also Documentation/cachetlb.txt) > > > ./arch/xtensa/include/asm/cacheflush.h:/* This is not required, see Documentation/cachetlb.txt */ > > > > > > Andrea > > > > > > > > >> > > >> diff --git a/Documentation/00-INDEX b/Documentation/00-INDEX > > >> index 53699c79ee54..04074059bcdc 100644 > > >> --- a/Documentation/00-INDEX > > >> +++ b/Documentation/00-INDEX > > >> @@ -76,8 +76,6 @@ bus-devices/ > > >> - directory with info on TI GPMC (General Purpose Memory Controller) > > >> bus-virt-phys-mapping.txt > > >> - how to access I/O mapped memory from within device drivers. > > >> -cachetlb.txt > > >> - - describes the cache/TLB flushing interfaces Linux uses. > > >> cdrom/ > > >> - directory with information on the CD-ROM drivers that Linux has. > > >> cgroup-v1/ > > >> diff --git a/Documentation/cachetlb.txt b/Documentation/core-api/cachetlb.rst > > >> similarity index 100% > > >> rename from Documentation/cachetlb.txt > > >> rename to Documentation/core-api/cachetlb.rst > > >> diff --git a/Documentation/core-api/index.rst b/Documentation/core-api/index.rst > > >> index c670a8031786..d4d71ee564ae 100644 > > >> --- a/Documentation/core-api/index.rst > > >> +++ b/Documentation/core-api/index.rst > > >> @@ -14,6 +14,7 @@ Core utilities > > >> kernel-api > > >> assoc_array > > >> atomic_ops > > >> + cachetlb > > >> refcount-vs-atomic > > >> cpu_hotplug > > >> idr > > >> diff --git a/Documentation/memory-barriers.txt b/Documentation/memory-barriers.txt > > >> index 6dafc8085acc..983249906fc6 100644 > > >> --- a/Documentation/memory-barriers.txt > > >> +++ b/Documentation/memory-barriers.txt > > >> @@ -2903,7 +2903,7 @@ is discarded from the CPU's cache and reloaded. To deal with this, the > > >> appropriate part of the kernel must invalidate the overlapping bits of the > > >> cache on each CPU. > > >> > > >> -See Documentation/cachetlb.txt for more information on cache management. > > >> +See Documentation/core-api/cachetlb.rst for more information on cache management. > > >> > > >> > > >> CACHE COHERENCY VS MMIO > > >> diff --git a/Documentation/translations/ko_KR/memory-barriers.txt b/Documentation/translations/ko_KR/memory-barriers.txt > > >> index 0a0930ab4156..081937577c1a 100644 > > >> --- a/Documentation/translations/ko_KR/memory-barriers.txt > > >> +++ b/Documentation/translations/ko_KR/memory-barriers.txt > > >> @@ -2846,7 +2846,7 @@ CPU 의 캐시에서 RAM 으로 쓰여지는 더티 캐시 라인에 의해 덮 > > >> 문제를 해결하기 위해선, 커널의 적절한 부분에서 각 CPU 의 캐시 안의 문제가 되는 > > >> 비트들을 무효화 시켜야 합니다. > > >> > > >> -캐시 관리에 대한 더 많은 정보를 위해선 Documentation/cachetlb.txt 를 > > >> +캐시 관리에 대한 더 많은 정보를 위해선 Documentation/core-api/cachetlb.rst 를 > > >> 참고하세요. > > >> > > >> > > >> -- > > >> 2.17.0 > > >> > > > -- > > > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > > > the body of a message to majordomo@vger.kernel.org > > > More majordomo info at http://vger.kernel.org/majordomo-info.html > > > > -- > > Jani Nikula, Intel Open Source Technology Center