Received: by 2002:a6b:500f:0:0:0:0:0 with SMTP id e15csp386525iob; Wed, 18 May 2022 04:31:34 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwwQm5SDxCe/VRnOL0aKgZG2bHEhsfhM/dGz8L3M0tQaMkhvXxndrAKrGDh5Xy/myjQVmPd X-Received: by 2002:a17:903:1252:b0:154:ca85:59a0 with SMTP id u18-20020a170903125200b00154ca8559a0mr27358499plh.169.1652873494054; Wed, 18 May 2022 04:31:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1652873494; cv=none; d=google.com; s=arc-20160816; b=BnN+yLK/rIRZC57AD5CJ/opQ1t0KJqp6yGXE2Ai2RKoQl1ehH8t1+sMW93VvrVVkW3 nwI55AHgPVnQLQfaYmdoZZvyR3Mf1Je6EFNzEtRcuHrnCT8u6dd7tZCntZ/DnXIGMrwf QMeWp8+iJShkUstDfoJxEqZVdY63Pj2h729JDhYTXcqr/S0zrNxthvumcWfoviq+YQXr Q4CukIo3sTsBRz90EwCQxXXLB5MWb8hiIm2c18ixRrvmUy1IcBgFChqKxCvUZ+JDmXij BuJMgAxW97PyZPYZ8ZDzo6fl22v59XmPlbx8SH4Ru717BTyS6wbLNtA9EbZQfFDTChE8 PmsQ== 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:to:content-language:subject:cc:user-agent:mime-version :date:message-id:dkim-signature; bh=eNRtY2UVNaiZWbqXDZ5CTfMenfNBiVFqmnPOSCsUNuo=; b=qDpztLFQtGcgJqtm8Yi2RVWaGSL5YiQLh9RykbbRO+Hsjk0mliIk+ElQAOccKjFMuO QBnDPFcRzcChwpOJ9MtacGOlP/s3rKdyD7P7bOQNp0NAiv8mlarebeJ3w7ZLjZcY3VDX 0N2iP+YPPq3XwjNsFkVS0Ejbvauc1tgLr0p6g5B7+wE2XGtI4PVwACXe0qPsSjqznIYt NgsXyr13W5dXKpEZeUapUBcwEoIb0itp4rqM1M9AcYKLhhtggH3WEdGI4d6rsp8A7e0N MK0oiutLPlpE+mL0FR4KBwlA6/p90AEqLzt7yZi1xtF2WpVXmgM0lH1Hq8Chmk94t2OI kNGA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=hxETIbvh; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=collabora.com Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [23.128.96.19]) by mx.google.com with ESMTPS id f15-20020a056a00238f00b0051069299ec6si3261108pfc.173.2022.05.18.04.31.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 May 2022 04:31:34 -0700 (PDT) Received-SPF: softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) client-ip=23.128.96.19; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=hxETIbvh; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=collabora.com Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 17505166454; Wed, 18 May 2022 04:28:02 -0700 (PDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S235659AbiERL1u (ORCPT + 99 others); Wed, 18 May 2022 07:27:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38296 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S235637AbiERL1r (ORCPT ); Wed, 18 May 2022 07:27:47 -0400 Received: from bhuna.collabora.co.uk (bhuna.collabora.co.uk [46.235.227.227]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C815C166455; Wed, 18 May 2022 04:27:45 -0700 (PDT) Received: from [127.0.0.1] (localhost [127.0.0.1]) (Authenticated sender: usama.anjum) with ESMTPSA id 545681F449B3 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1652873264; bh=rBbCjdKWBmSyC6DxT/Ml286Uzl18qmi9zuCiDKlWOYc=; h=Date:Cc:Subject:To:References:From:In-Reply-To:From; b=hxETIbvhCXlF07VtM55O17KnEffGaMX0AFK2f/GIVWDG85eLSv1sKOYhVYZ5YtezQ 6TiPUkUn21A7yKRS/tu+jQBMDeA+8JXttz9J8r5z06zYzwG8vGM3WniTpiP6ccSB2r CiXnGzUAZAX1MnhUAg9NYoZcQyNQ7qQAY4LK9BkP/S6iMVYW3HjoIOvAZW2ehHIMJn 0xadwx32BRSsO+goqBa+Q1FFplkxgh55p/735ifSr9kFOA2d8rv32sSb6vyBVkz6P/ 5CNeGIeVEIf/Ifd1yMcI4moFLbHGN+RQOSgP9BFDpy9xTaaoJ7/zgPfKvIRD6Lp4QZ zNXZ3Wh/ky7UQ== Message-ID: <890ae132-cf86-8c82-8280-291869183f5f@collabora.com> Date: Wed, 18 May 2022 16:27:35 +0500 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.8.0 Cc: usama.anjum@collabora.com, Benson Leung , Guenter Roeck , Andy Shevchenko , Greg Kroah-Hartman , "Rafael J . Wysocki" , Dmitry Torokhov , Tzung-Bi Shih , Linux Kernel Mailing List , Linux Next Mailing List Subject: Re: [PATCH v2 2/2] platform/chrome: Use imperative mood for ChromeOS ACPI sysfs ABI descriptions Content-Language: en-US To: Bagas Sanjaya , linux-doc@vger.kernel.org References: <20220518083524.37380-1-bagasdotme@gmail.com> <20220518083524.37380-3-bagasdotme@gmail.com> From: Muhammad Usama Anjum In-Reply-To: <20220518083524.37380-3-bagasdotme@gmail.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-4.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,NICE_REPLY_A,RDNS_NONE,SPF_HELO_NONE, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=unavailable 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 5/18/22 1:35 PM, Bagas Sanjaya wrote: > The current descriptions all begin with ("This file shows something") > clause, which is incorrect wording since these mean return value from > sysfs. > > Use imperative mood ("Returns something") instead, in line with > corresponding ACPI documentation at firmware-guide/. > > Cc: Benson Leung > Cc: Guenter Roeck > Cc: Andy Shevchenko > Cc: Greg Kroah-Hartman > Cc: Rafael J. Wysocki > Cc: Dmitry Torokhov > Cc: Enric Balletbo i Serra > Cc: Muhammad Usama Anjum > Cc: Tzung-Bi Shih > Cc: Linux Kernel Mailing List > Cc: Linux Next Mailing List > Signed-off-by: Bagas Sanjaya Reviewed-by: Muhammad Usama Anjum -- Muhammad Usama Anjum