Received: by 2002:a5b:505:0:0:0:0:0 with SMTP id o5csp4543233ybp; Mon, 7 Oct 2019 09:59:07 -0700 (PDT) X-Google-Smtp-Source: APXvYqwtZJ1WK1fRjre+516jYvE01buxMd0o/oodH0x1XI7kbr9PgKra1jR86KzNc+Y64ZMlgUFD X-Received: by 2002:aa7:c98a:: with SMTP id c10mr30650312edt.23.1570467547796; Mon, 07 Oct 2019 09:59:07 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1570467547; cv=none; d=google.com; s=arc-20160816; b=V20HV6Otsg0Ivc6BMOz++PSaUhzqbDLJjRw4oZtG1mDRkkOL4PJmzuFNz1Gf9U/JfB PADCtapvvJ3p/Oa22sJqFH5TFn1n6f29Yeo8rvktTwdW4KQhDgZi+IYuEwdZCa1Sh95G XPgb1/U1ivdykojVwnb7QpjedF6r/KOIMZHbq7hbXsOT+SA44i2cRwSvZTLR/R5CgIT5 qtL+i/3JA1tYHDluR0h14XRm/YilZE6hArgHDGJYPWmDU1vr6onsBdXWvM3PeS2n3cEj ANeZwTKHw2RyTPTIDqW8pljA7XXEAVHjobjadzNO4j4bsoI7Ydj1XkaPFHR1v5SK6L2P PD9A== 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 :content-language:in-reply-to:mime-version:user-agent:date :message-id:from:references:cc:to:subject:dkim-signature; bh=M1olqyDfSGoMIsdSc+T5PN89uxP7EflDYmXBg03m/Tk=; b=xHZJc4g8FNiQk6TG4L1MmDaD3ANNk56zCIkrkmt/807zvYK0mbXFMaYgAN0ARenFjf paDkX0KcQT1ibFkzcaduaWv5hcCEmlopoEDgeb4K1PQmGv8T+8UIdxrwIDZfkCAqI+ni 0glYefWSp3HYMo2o6Uaz/tWeV5XS9J02XmoMyMNIhifeuUHl8S288GFPI7kYLyLMPbkx 7V1qFlqB4431kbmbkf0mPXYCUh54Ez1LE0XdgRtevsWe7vUtcOhvD5LUMSAHKVm9WGIS 0eQfXj4wk2xf3q5s8/g80POb41mROrtEMK8usV5uHTlnmRFQeiAUvIIQRtbF8qUtsHIi 5HRQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=MdwKcAKd; 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 b8si9489658edc.231.2019.10.07.09.58.44; Mon, 07 Oct 2019 09:59:07 -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=fail header.i=@infradead.org header.s=bombadil.20170209 header.b=MdwKcAKd; 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 S1729032AbfJGQ63 (ORCPT + 99 others); Mon, 7 Oct 2019 12:58:29 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:60842 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728474AbfJGQ61 (ORCPT ); Mon, 7 Oct 2019 12:58:27 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:MIME-Version:Date:Message-ID:From:References:Cc:To: Subject:Sender:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=M1olqyDfSGoMIsdSc+T5PN89uxP7EflDYmXBg03m/Tk=; b=MdwKcAKdqP7IXITupOTHJxXm4 e24SkkeEV5TSj97fhYNM+2yoHZ6oTmvtMrmloRNAzVnk56GdXxTFXCM2MLxIi8fy59/+SGC+8JgeX weXcIbg/H1niihCFNEcI15EkvR0Gd15Eug+S/kxkgrtuyRMG0MaUn2euRvxqFRjSo4hkVf3Ng9dN8 tWkP6T6yGG49vF8WW0VeZaTqOSIeo+/xGr3uPAu9pJ7H5dM2OV/YKHERA5VOrmgV4YI7M+rKG9qOJ DKyhj/zrjr7V5qfnx2/Ae4qcIBW/q11rl+9g8BNgJN/GiOI2e52/D6XfjEowk6tgs8ZiHmvNdtLAY giYMxxHHw==; Received: from [2601:1c0:6280:3f0::9ef4] by bombadil.infradead.org with esmtpsa (Exim 4.92.2 #3 (Red Hat Linux)) id 1iHWL4-0001O1-8G; Mon, 07 Oct 2019 16:58:26 +0000 Subject: Re: [PATCH] doc: move namespaces.rst out of kbuild directory To: Matthias Maennich , Jonathan Corbet Cc: Jessica Yu , Masahiro Yamada , linux-doc@vger.kernel.org, Mauro Carvalho Chehab , Adam Zerella , Michal Marek , linux-kbuild@vger.kernel.org, linux-kernel@vger.kernel.org References: <20191007043611.31036-1-yamada.masahiro@socionext.com> <20191007060614.GA142813@google.com> <20191007081241.GA8279@linux-8ccs> <20191007072930.07b1e90a@lwn.net> <20191007134124.GC23938@google.com> From: Randy Dunlap Message-ID: <373b2646-7894-cf4b-21b6-a8a63ad707fa@infradead.org> Date: Mon, 7 Oct 2019 09:58:24 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.1.1 MIME-Version: 1.0 In-Reply-To: <20191007134124.GC23938@google.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 10/7/19 6:41 AM, Matthias Maennich wrote: > On Mon, Oct 07, 2019 at 07:29:30AM -0600, Jonathan Corbet wrote: >> On Mon, 7 Oct 2019 10:12:42 +0200 >> Jessica Yu wrote: >> >>> This was my line of thought as well, since the audience of >>> admin-guide/ is sysadmins and users. Namespaces are mostly relevant to >>> module authors and kernel developers. Currently, I don't think there >>> is an existing good place in Documentation/ for this topic :-/ >>> I suppose kernel-hacking/ might be the closest fit, as Adam suggested. >> >> I didn't see this thread before responding in the first, naturally... >> >> I think the core-api manual is probably as good a place as any for this. >> Changing the name to something like symbol-namespaces.rst is probably a >> good idea, since most people think of other things when they see >> "namespaces".  Or perhaps that mythical Somebody could expand it into a >> proper description of symbol exports in general...:) > > As I said in the other thread, I am happy for it to be moved to a better > location. core-api/ as well as kernel-hacking/ seem to be good > locations. core-api/ please. kernel-hacking/ does not make any sense to me. > I could imagine expanding the documentation, but would not like to > commit to it right now. (Even though I feel very encouraged by your talk > in Paris, Jon. Thanks for that!) -- ~Randy