Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp2492685pxj; Mon, 17 May 2021 02:55:11 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyxF06Aui/wE7GcLSZ1yqtm3rJt8TudIspTKO632JzS6YEZcit8y5nUCJ89v4UeIyiBzEMt X-Received: by 2002:a05:6e02:92f:: with SMTP id o15mr5858597ilt.127.1621245310696; Mon, 17 May 2021 02:55:10 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1621245310; cv=none; d=google.com; s=arc-20160816; b=yOpQ3B0xxUgv4qAk/OBeTfZP0anBD9c0WsmcGSnv6aK9yDJ9F4WlE468xLsqu9gl7Q Q5ehSPvrYl5j089D34MnvuJbQ8nY3jzs1rIwdCu7a+bsx8iJksoZKaNsAPcj5rYvcjB5 573KsUfQ7V+ecj4F8SW/r0FnOIBUeAzslR8v6un3QsGH6oW9CurGwJ79yxXsR751BrTR O39PDklI1hl7rGPA//q3aDzHHha0CU/BBpvY36fghyiIj4zoQHNZiQMqkNJKjuLMOTYc MXUsj6J9KB+Y4x95zUvX7Lhu2mSqzh/f4eBslmcCgIWvRtgNz6sR4SPVYt2j9Nj25YBX 1Hcw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=ngU07/Nz5uBaGKSNQDKxKqJRj7ed23twEteeceYcPE0=; b=efCA+JKwM+G5aC963KLiGFVNkY9TYylCqJGfW6EhVvRPJ8SqoVBqL1JAUjwtT3pUkf TvobsYTme8Wm+c+zq10YVmiIQwHZJT24oZNgPQhW787tMDn3KMFaakn2Mg7v5JYK5uSI Lw14104py6wIeSNdW7iktt821ymrwHqadiFDHeBz8INQSThvoEfWH2WuXGxDky2Rwwbu Td20TMrWnRbDOrS65bSjgB6IhD8n75/KwteLXSvgT0ihNE3DJXY3C0cftaLuTziPGPUe mmD1Hy2RwcPyvSGrlN6CtEzAMHWvCxU6qa+1JGHI8+4hI5cyziXKzqxepIfKJXxkjmUA JZjg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=kzsE5o55; 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; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id s6si17387035jao.56.2021.05.17.02.54.57; Mon, 17 May 2021 02:55:10 -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=pass header.i=@gmail.com header.s=20161025 header.b=kzsE5o55; 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; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232452AbhEQJyT (ORCPT + 99 others); Mon, 17 May 2021 05:54:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34460 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229474AbhEQJyT (ORCPT ); Mon, 17 May 2021 05:54:19 -0400 Received: from mail-lj1-x22b.google.com (mail-lj1-x22b.google.com [IPv6:2a00:1450:4864:20::22b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CD7BFC061573; Mon, 17 May 2021 02:53:02 -0700 (PDT) Received: by mail-lj1-x22b.google.com with SMTP id v5so6396024ljg.12; Mon, 17 May 2021 02:53:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=ngU07/Nz5uBaGKSNQDKxKqJRj7ed23twEteeceYcPE0=; b=kzsE5o55kTlANbGYoIAaMo6gz3+pJ8pWPgcfyFQ5twZZEpcSLTTAdGQ3xXjZ6soUKu W4q89rLrsjkUb8rgpSvYZbIf/PrvJtRcn4mUJGVDkKKBEApvmDh9D4/az1H1Trh8ch5q TGG7ypBl+Vr8MT0NdwRQnpjmchGWB2IrgfoP//7fgogV5dkUTDrdJtFbeUO6FbFkh2oH 06sk0X4MNBgILAs2RGblxKrde3R1TJgV6VRufgQ27lrf9DLP5qjKxvZNvjuvdqg0YaqM PRgG2oKxdum9s4b4gGlcpE8jxOTHPAwN9X4PZ+YzxNVfuBhsrcGjS6mCUfO9epuLYmca PG6Q== 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=ngU07/Nz5uBaGKSNQDKxKqJRj7ed23twEteeceYcPE0=; b=SWkOimIipT67yiWM41C2tRH+75Uxx6pQOtopLkA9WyMBrM2fcoFF3VhkYlRteLDTHH mcRz83GHcqVS2SYo6X1BG99squKlZimoov7kpFefmxKQSW7DiTIu8F9M0leAJagSYmZA KzrB/PGF0NEYKcnr7seGiX4wd9ROkXV05OdByjHvaY04aSZ5AlCkUy5zxgX/OIURkJWp STxj5D0OK2x+C08MQfGxrp/BOxng6M1qIi3MTSKkWahzdfvRmZPmleFEf5c4D9DdDYE3 q1vz7Ds/y8F0JCFj+JFHNBwC8oLe6WlKq1fQLUFwDLNViwDkTPFTJbhHi/+BgRpBtXp1 YQcA== X-Gm-Message-State: AOAM533PpA6xEQ6n+ulhtLjALIfUuPXzuHM+zfkneASd9TRzx0cbnTpb YXnrfRXvwXlSJkkQPRAwl50xFK8vELxTKcYz92PrB4jJG0J3IyQXSr0= X-Received: by 2002:a2e:9211:: with SMTP id k17mr49792574ljg.284.1621245181177; Mon, 17 May 2021 02:53:01 -0700 (PDT) MIME-Version: 1.0 References: <1621243800-27702-1-git-send-email-yangtiezhu@loongson.cn> In-Reply-To: From: Dwaipayan Ray Date: Mon, 17 May 2021 15:22:50 +0530 Message-ID: Subject: Re: [PATCH v3] Documentation: checkpatch: add description if no filenames are given To: Lukas Bulwahn Cc: Tiezhu Yang , Joe Perches , Jonathan Corbet , "open list:DOCUMENTATION" , Linux Kernel Mailing List Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, May 17, 2021 at 3:13 PM Lukas Bulwahn wrote: > > On Mon, May 17, 2021 at 11:30 AM Tiezhu Yang wrote: > > > > After commit 45107ff6d526 ("checkpatch: if no filenames then read stdin"), > > if no filenames are given, it will read patch from stdin rather than exit > > directly. This means the script waits for input indefinitely, which > > confuses new checkpatch users at first. > > > > Add some basic documentation on this behaviour of checkpatch to lower > > the confusion. > > > > Signed-off-by: Tiezhu Yang > > --- > > > > v3: Update the commit message, thank you Lukas. > > > > Thanks. > > Acked-by: Lukas Bulwahn > > Dwaipayan, can you acknowledge this as well? > Yes it looks good to me too. Thanks for the patch Tiezhu. Acked-by: Dwaipayan Ray > Jonathan, I assume you will pick this up in your doc tree once > Dwaipayan ack is there, right? > > Lukas > > > Documentation/dev-tools/checkpatch.rst | 2 ++ > > 1 file changed, 2 insertions(+) > > > > diff --git a/Documentation/dev-tools/checkpatch.rst b/Documentation/dev-tools/checkpatch.rst > > index 51fed1b..3eb9ead 100644 > > --- a/Documentation/dev-tools/checkpatch.rst > > +++ b/Documentation/dev-tools/checkpatch.rst > > @@ -22,6 +22,8 @@ Usage:: > > > > ./scripts/checkpatch.pl [OPTION]... [FILE]... > > > > +When FILE is -, or absent, checkpatch reads from standard input. > > + > > Available options: > > > > - -q, --quiet > > -- > > 2.1.0 > >