Received: by 2002:a05:6359:c8b:b0:c7:702f:21d4 with SMTP id go11csp2235862rwb; Sun, 2 Oct 2022 18:56:39 -0700 (PDT) X-Google-Smtp-Source: AMsMyM6aNBLguVAzE3LVJaeCaE0scRDfEP3E0d6Dzqnv3WKyE9wkMCC1c7SUWemz92L2fRfRzTRn X-Received: by 2002:a17:90b:4d92:b0:202:f200:a3c9 with SMTP id oj18-20020a17090b4d9200b00202f200a3c9mr9771481pjb.4.1664762199520; Sun, 02 Oct 2022 18:56:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1664762199; cv=none; d=google.com; s=arc-20160816; b=NIsyap69yZLuaBJeDKsilnV+bdu809LYSgv3m+9ixH2ISCgtBj3vvGUO2L7BibYRpz oTBGEuk3ZbZTbIlsNi2kcUNKqxDilSqdUpqhDLVBoTvU+0bQqhAlPHI3EVNLhjz7CGmy +DImAT74avGJOL+eAPgjH2baPVRpaU+DVYiYPt1euP7t7hWj76eSbZXIj6AtYUiHDfZT T7BAKv9KWwISZkZAE1AgvAGmPfmtLUW3N7v89XRv6bC7pCB/JKobuyElssZUg14F7zHM fhEz97LNobmNm1kqEd48EugLfmQ49zLKHsr8Id+FyVXo6UMqFPIwLjUrO7oiwBHv/cQT 0UXA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to:from :references:cc:to:content-language:subject:user-agent:mime-version :date:message-id:dkim-signature; bh=ea4Dhkf8Ig20YxhTpzRQu+OV4A/Sn5CkcLr1NVTi+sA=; b=EfmhoJvJTF4IBGoT0rC0N9gixIXLVNlf0TIpSvBM39GmfedO1dH+ADZOOk4QYBTctw bTkPieFBNQW8C06vgoYkCJuaqBMxzcf1PX0JXPgJ4yhbFuSYO2liC3kSg6bPq2jU9N7X iddrMrQKgoq0aJbBrTUr/puwmv7Y8mArjcoaJ2xil/6pPchVt54ytgGhbo1MRQmeic4T sSDKa+pclGmPyIxBGpnFl6X1iCFu8j0t8gP8wDsoZmjjMfLGJviR+Rt0BrbTKt1h1ew8 wmzQ6V/NZNmCBW8utH4tAL2h1dA62IkbD5ssHbEqVE/SQsq6KYbdzFDCh00Y5cgpnzGY jFpA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=HL1mdIq7; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id c18-20020a056a00249200b0053876f662casi11245513pfv.9.2022.10.02.18.56.28; Sun, 02 Oct 2022 18:56:39 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=HL1mdIq7; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229550AbiJCBR2 (ORCPT + 99 others); Sun, 2 Oct 2022 21:17:28 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46672 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229459AbiJCBR0 (ORCPT ); Sun, 2 Oct 2022 21:17:26 -0400 Received: from mail-pj1-x102f.google.com (mail-pj1-x102f.google.com [IPv6:2607:f8b0:4864:20::102f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 567803687C; Sun, 2 Oct 2022 18:17:25 -0700 (PDT) Received: by mail-pj1-x102f.google.com with SMTP id g1-20020a17090a708100b00203c1c66ae3so8705256pjk.2; Sun, 02 Oct 2022 18:17:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date; bh=ea4Dhkf8Ig20YxhTpzRQu+OV4A/Sn5CkcLr1NVTi+sA=; b=HL1mdIq7pLpR3vycDeQtDjZeGvJNS9D/d4CdKocJqhd5RvK/IRHuVqfJOoMMQE+6NZ i7caAs1PYW8WXQBMxsigZX9cv7La2sZa+eKqdGCT9Qpja2e5bRfLMKkweH99i+plSYd7 xRnjO3dpBtcmCz9vPlDfD+7VIYyf8npu8ZYIYNmkPlFP7OczYk41GnhqQbhhHubpX/Z1 uN64IpeWHyhr3pi6+nkqkS1BJEBRasMb4xvlenyn2kRiaAepZXE1QoNyY6Fop26zSIW3 SoK98jIn/mOqqoF5zPUH/M4nx2EkyV4SMk0zzrryrQuOFhSdO7gieWO9mFWHA21D/Ik2 PBNQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date; bh=ea4Dhkf8Ig20YxhTpzRQu+OV4A/Sn5CkcLr1NVTi+sA=; b=cH9vePKtq8J29fuWziN0o27WDGe0zZdJDIM7crz8b5V579RaBAevsBaexkKChsOvCl w7Ct81Whp/WoMq4zalgv8q2o8nvzwwbYcpPVEtWMjDp1MRwdLDnDprknm+jhMYe1D/a7 hBzXs03nD0uk9+g5eJ6VX2Te1H/aJ0kz6Vr9DWwg20evvzlScD5fKrCmUUFhA7u1JI5x oGWKDxqWWY9c4QFRFk6Q54eJx6fvvaPwrQUbL5dbj5yFTXQZT9U6qyDy6W1+J+AxA4rU 9NM+WZUz+dxhT8pzNkN6pC5N3yMPMho9D5IrI8FaqdOvzavN0aIt5kv2RNUxGW9Avouy L0CQ== X-Gm-Message-State: ACrzQf3Q0B4L3oJ6TCqQUuKXoB5QXE/EAY6vjksO/tyhClNrsNWkAUyw OwLhxAfPgqQzcQKp28ZKVg8= X-Received: by 2002:a17:902:8bc2:b0:17f:5908:9a01 with SMTP id r2-20020a1709028bc200b0017f59089a01mr3029018plo.133.1664759844825; Sun, 02 Oct 2022 18:17:24 -0700 (PDT) Received: from [192.168.11.9] (KD106167171201.ppp-bb.dion.ne.jp. [106.167.171.201]) by smtp.gmail.com with ESMTPSA id p6-20020a170902780600b0015e8d4eb26esm5869326pll.184.2022.10.02.18.17.22 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 02 Oct 2022 18:17:24 -0700 (PDT) Message-ID: <92ef6be6-dc99-555d-8263-77484b7d0f12@gmail.com> Date: Mon, 3 Oct 2022 10:17:19 +0900 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 Subject: Re: [PATCH v3] Documentation/process: Add text to indicate supporters should be mailed Content-Language: en-US To: Joe Perches Cc: corbet@lwn.net, konstantin@linuxfoundation.org, Theodore Ts'o , Bryan O'Donoghue , Krzysztof Kozlowski , linux@leemhuis.info, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: <20220930064629.329514-2-bryan.odonoghue@linaro.org> <21f8d79a-0ad4-b28b-15d8-f4be0cfd9730@gmail.com> <70759d05-2646-57e5-0b87-3a196488f622@linaro.org> From: Akira Yokosawa In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-3.2 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,NICE_REPLY_A, RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Sun, 02 Oct 2022 16:55:05 -0700, Joe Perches wrote: > On Mon, 2022-10-03 at 08:04 +0900, Akira Yokosawa wrote: >> Hello Joe, >> >> Thank you for chiming in. >> >> On 2022/10/03 0:49, Joe Perches wrote: >>> On Sun, 2022-10-02 at 09:58 +0200, Krzysztof Kozlowski wrote: >>>> The easiest to achieve it is to run with --no-git-fallback and CC entire >>>> output. However it does not mean submitter must run with >>>> --no-git-fallback. It is only for this generic rule - CC entire output >>>> of get_maintainers.pl. >>>> >>>> If you add such rule "CC entire output of get_maintainers.pl" and do not >>>> mention no-git-fallback, some folks will think they need to CC all these >>>> people who made one commit to your file... >>> >>> false. >>> >>> git-fallback is _not_ used when there is a listed maintainer for a >>> specific file. >>> >>> If there is a use of git-fallback, it's because there is _no_ >>> specified maintainer for a specific file. >>> >>> --git-fallback => use git when no exact MAINTAINERS pattern (default: 1) >>> >>> i.e.: It's not "your file" if you don't maintain it. >> >> Joe, I sometimes see unexpected output WRT --git-fallback. >> >> Example: >> >> $ ./get_maintainer.pl -f Documentation/doc-guide/sphinx.rst >> Jonathan Corbet (maintainer:DOCUMENTATION,commit_signer:1/1=100%) >> <-- ??? >> Lukas Bulwahn (commit_signer:1/1=100%,authored:1/1=100%,added_lines:2/2=100%,removed_lines:2/2=100%) >> <-- ??? >> linux-doc@vger.kernel.org (open list:DOCUMENTATION) >> >> linux-kernel@vger.kernel.org (open list) >> >> As you see, --git-fallback is used in this case. Why? >> It looks strange to me as Jon is listed as a "maintainer". >> >> Having "F: Documentation/" in MAINTAINERS does not suffice? > > No. It's not an exact pattern match as the files below the > top level of Documentation are not specifically matched by > "F: Documentation/". For me, calling this is "not an exact pattern match" sounds inconsistent with the explanation (quoted below) near the top of MAINTAINERS: F: *Files* and directories wildcard patterns. A trailing slash includes all files and subdirectory files. What am I missing? Does this explanation needs update? Regards, Akira > [...]