Received: by 2002:ac0:946b:0:0:0:0:0 with SMTP id j40csp1814397imj; Fri, 8 Feb 2019 07:47:32 -0800 (PST) X-Google-Smtp-Source: AHgI3Ibsqs2/HSD2gKean9c0goVvixa5RU7p5PUrT4lzxer0cuJbnz7nOV/bT9fgNoJk23vOtiV0 X-Received: by 2002:a63:2312:: with SMTP id j18mr1981979pgj.344.1549640852389; Fri, 08 Feb 2019 07:47:32 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1549640852; cv=none; d=google.com; s=arc-20160816; b=qDCnGA3ntjK/T/i9orXumJj6O6TIZZ8dgp6QQNGxYTQTCB03ZonDirels6SZanVljQ +kViRxl1gmhIsKXdCNc27f55rM6v9SpyvP0xu3pZQUCM029OFp9katNccyGmBebQmj2A xcIBYHick4V+lEO9GGN512Fkd1a6YZELVbYv38ZD//08GitZQzKyzVlRcVd/mFP6Jw7W r1epD2VsoPdpoJ7M/PwxiMIZDWsrniO8/eLTUaZFjL+B5OPyhzfSWcVJ64nYZP4xVM84 L18Ea9epyeFIPf+3xky3IVejAyp4EHB2K6OB2ZnLXijZYrK0pU+zaiP0GqWuHQ0gGZqa Lv7g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:dkim-signature; bh=0x0ow+hqpKgNG8nZU8pQBR0zcMJQoa157kMMUNcDp/c=; b=OJUut1lxAz1LbmixZZgdh5aS+EUSBtaK8u9WF+MFTY4kNsqbVW7N18gwE3NB8gtjwU XktrS5XRN32dlPBnN1ydhjGSgUZFMC7EWoQbF3ocpreu+yD5eGkuxOYzBFkSEcEfP9wJ 65Nb1XyfQPMnymos56IJ2XpQdzm5OAehq8U/W5t3dnE/6KdIR45gFLo/mvTXE5sTR9ll uE9r4GWV7exr4fs+RLF0LT5MtD7VOptzxE8TI1hhfF3NO326r7bpDhpdDLktcbbmd8MA cb8N6d+/G4p4nuNEhXYU3jWbrZPdKXWVBDWwRyiVnuV/Ipi3342xazRPdbEK93AhY+GS Vgng== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ffwll.ch header.s=google header.b=emvlvo6s; 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 j135si2432801pgc.517.2019.02.08.07.47.15; Fri, 08 Feb 2019 07:47:32 -0800 (PST) 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=@ffwll.ch header.s=google header.b=emvlvo6s; 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 S1727999AbfBHPqA (ORCPT + 99 others); Fri, 8 Feb 2019 10:46:00 -0500 Received: from mail-it1-f194.google.com ([209.85.166.194]:39650 "EHLO mail-it1-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727473AbfBHPp7 (ORCPT ); Fri, 8 Feb 2019 10:45:59 -0500 Received: by mail-it1-f194.google.com with SMTP id a6so9836010itl.4 for ; Fri, 08 Feb 2019 07:45:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=0x0ow+hqpKgNG8nZU8pQBR0zcMJQoa157kMMUNcDp/c=; b=emvlvo6sKZKjFjBGm2Qm3rOQ1WMI0NTkFeP3ibPwujZxo6PfBN2AKRo5oGenddV46I GhhuP3W66EcjctQmyDROcMuMl42f1YuGZDg9kF/NE2jqIYZCFbhldRJDVRDpX9lACo5K W7gyOWT3Hm0zn/K3a1RvvjYW/+iyIlGvJoBeo= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=0x0ow+hqpKgNG8nZU8pQBR0zcMJQoa157kMMUNcDp/c=; b=RGWBJTmklNAy/wk9uYVpNfKWGM9B8Ai/20BQnc+ubPeh5+8cBJwoNtqD0Gvtp8ihmw 0hfdVSfvGNzsVfH2B1Oyy0YAnxh9rDAfkDtQU22PVP3/EUXS8u6gCJX+7bc9B5MwM6WU 1XEmMFl0S/k9rgPZ3mx+3nCPM1r2rCoM3lZr6iKNaZqNQLy789kbAQUHNhukyDqjIE4l GPa5GCSrr67M1k9ohx9kJ8BxQbDAxpYHFihn3R1iS4vW7yiXGG1r0FzjsozkyfxhJ0K5 1k0alyHPrjcRe0TYJo9TynMrdea3LREUka/fHxaiZ9/W0ZG5ja4jnhn6Z1ZTrqkneJln 3c/g== X-Gm-Message-State: AHQUAub4rW3NoG2vb7CfKBS63VOUdWDYmSdScoZyTIEoGvBNPMvGOw14 CgP7cDdMoWLWY1ltSpXsMGiycpJWxmY3F91eIYi39g== X-Received: by 2002:a6b:4001:: with SMTP id k1mr960585ioa.34.1549640758193; Fri, 08 Feb 2019 07:45:58 -0800 (PST) MIME-Version: 1.0 References: <20190207232759.14553-1-daniel.vetter@ffwll.ch> <20190208115123.GA19392@kroah.com> <20190208152911.GM23159@phenom.ffwll.local> In-Reply-To: <20190208152911.GM23159@phenom.ffwll.local> From: Daniel Vetter Date: Fri, 8 Feb 2019 16:45:47 +0100 Message-ID: Subject: Re: [PATCH 1/4] component: Add documentation To: Greg Kroah-Hartman Cc: DRI Development , Intel Graphics Development , LKML , "Rafael J . Wysocki" , "C, Ramalingam" , Russell King , "Rafael J . Wysocki" , Jaroslav Kysela , Takashi Iwai , Rodrigo Vivi , Jani Nikula , Daniel Vetter Content-Type: text/plain; charset="UTF-8" Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Feb 8, 2019 at 4:29 PM Daniel Vetter wrote: > > On Fri, Feb 08, 2019 at 12:51:23PM +0100, Greg Kroah-Hartman wrote: > > On Fri, Feb 08, 2019 at 12:27:56AM +0100, Daniel Vetter wrote: > > > While typing these I think doing an s/component_master/aggregate/ > > > would be useful: > > > - it's shorter :-) > > > - I think component/aggregate is much more meaningful naming than > > > component/puppetmaster or something like that. At least to my > > > English ear "aggregate" emphasizes much more the "assemble a pile of > > > things into something bigger" aspect, and there's not really much > > > of a control hierarchy between aggregate and constituing components. > > > > > > But that's way more than a quick doc typing exercise ... > > > > > > Thanks to Ram for commenting on an initial draft of these docs. > > > > > > v2: Review from Rafael: > > > - git add Documenation/driver-api/component.rst > > > - lots of polish to the wording + spelling fixes. > > > > > > v3: Review from Russell: > > > - s/framework/helper > > > - clarify the documentation for component_match_add functions. > > > > > > v4: Remove a few superflous "This". > > > > > > Reviewed-by: Rafael J. Wysocki > > > Cc: "C, Ramalingam" > > > Cc: Greg Kroah-Hartman > > > Cc: Russell King > > > Cc: Rafael J. Wysocki > > > Cc: Jaroslav Kysela > > > Cc: Takashi Iwai > > > Cc: Rodrigo Vivi > > > Cc: Jani Nikula > > > Signed-off-by: Daniel Vetter > > > > Thanks for doing this! > > > > Reviewed-by: Greg Kroah-Hartman > > Thanks for reviewing (obviously includes Rafael and Russell too)! > > For merging I see two options: > - All through drm-intel, but will only land in 5.2 because the feature > cut-off has already happened for i915. So a bit awkward. > - Topic branch with the 2 component patches plus the snd-hda/drm-i915 > patch, so that you/Takashi/drm can pull it in as needed. The drm > component doc patch (3/4 in this series) I can pull in later on. > > Greg/Takashi, any preferences? Just realized that for the mei side of this series I need a topic branch anyway, so topic branch it is. I'll prep that so that CI can beat on it over the w/e, and we can rebase the i915/mei series on top, and then send out the topic pull to everyone early next week. You can then all decide whether you need it or not. Cheers, Daniel -- Daniel Vetter Software Engineer, Intel Corporation +41 (0) 79 365 57 48 - http://blog.ffwll.ch