Received-SPF: pass (google.com: domain of linux-kernel+bounces-215392-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161;
Message-ID: <b3f78091-1931-4e2c-a2a1-2031b09e566d@linuxfoundation.org>
Date: Fri, 14 Jun 2024 11:57:05 -0600
Precedence: bulk
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH] cpupower: Add 'help' target to the main Makefile
To: Roman Storozhenko <romeusmeister@gmail.com>,
 Thomas Renninger <trenn@suse.com>, Shuah Khan <shuah@kernel.org>,
 Javier Carrasco <javier.carrasco.cruz@gmail.com>
Cc: linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org,
 Shuah Khan <skhan@linuxfoundation.org>
References: <20240614-make-help-v1-1-513118646b71@gmail.com>
Content-Language: en-US
From: Shuah Khan <skhan@linuxfoundation.org>
In-Reply-To: <20240614-make-help-v1-1-513118646b71@gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

On 6/14/24 01:56, Roman Storozhenko wrote:
> Add 'help' target descriding building and cleaning targets
> to the main Makefile
> 
> Signed-off-by: Roman Storozhenko <romeusmeister@gmail.com>
> ---
> Make "cpupower" building process more user friendly by adding 'help'
> target to the main makefile. This target describes various build
> and cleaning options available to the user.

You could include the above in the change log.

> ---
>   tools/power/cpupower/Makefile | 37 ++++++++++++++++++++++++++++++++++++-
>   1 file changed, 36 insertions(+), 1 deletion(-)
> 
> diff --git a/tools/power/cpupower/Makefile b/tools/power/cpupower/Makefile
> index b53753dee02f..cd0225a312b4 100644
> --- a/tools/power/cpupower/Makefile
> +++ b/tools/power/cpupower/Makefile
> @@ -332,4 +332,39 @@ uninstall:
>   		rm -f $(DESTDIR)${localedir}/$$HLANG/LC_MESSAGES/cpupower.mo; \
>   	  done;
>   
> -.PHONY: all utils libcpupower update-po create-gmo install-lib install-tools install-man install-gmo install uninstall clean
> +help:
> +	@echo  'Building targets:'
> +	@echo  '  all		  - Default target. Could be omitted. Put build artifacts'
> +	@echo  '                    to "O" cmdline option dir (default: current dir)'
> +	@echo  '  install	  - Install previously built project files from the output'
> +	@echo  '                    dir defined by "O" cmdline option (default: current dir)'
> +	@echo  '                    to the install dir  defined by "DESTDIR" cmdline or'
> +	@echo  '                    Makefile config block option (default: "")'
> +	@echo  '  install-lib	  - Install previously built library binary from the output'
> +	@echo  '                    dir defined by "O" cmdline option (default: current dir)'
> +	@echo  '                    and library headers from "lib/" for userspace to the install'
> +	@echo  '                    dir  defined by "DESTDIR" cmdline (default: "")'
> +	@echo  '  install-tools	  - Install previously built "cpupower" util from the output'
> +	@echo  '                    dir defined by "O" cmdline option (default: current dir) and'
> +	@echo  '                    "cpupower-completion.sh" script from the src dir to the'
> +	@echo  '                    install dir  defined by "DESTDIR" cmdline or Makefile'
> +	@echo  '                    config block option (default: "")'
> +	@echo  '  install-man	  - Install man pages from the "man" src subdir to the'
> +	@echo  '                    install dir  defined by "DESTDIR" cmdline or Makefile'
> +	@echo  '                    config block option (default: "")'
> +	@echo  '  install-gmo	  - Install previously built language files from the output'
> +	@echo  '                    dir defined by "O" cmdline option (default: current dir)'
> +	@echo  '                    to the install dir defined by "DESTDIR" cmdline or Makefile'
> +	@echo  '                    config block option (default: "")'
> +	@echo  '  install-bench	  - Install previously built "cpufreq-bench" util files from the'
> +	@echo  '                    output dir defined by "O" cmdline option (default: current dir)'
> +	@echo  '                    to the install dir  defined by "DESTDIR" cmdline or Makefile'
> +	@echo  '                    config block option (default: "")'
> +	@echo  ''
> +	@echo  'Cleaning targets:'
> +	@echo  '  clean		  - Clean build artifacts from the dir defined by "O" cmdline'
> +	@echo  '                    option (default: current dir)'
> +	@echo  '  uninstall	  - Remove previously installed files from the dir defined by "DESTDIR"'
> +	@echo  '                    cmdline or Makefile config block option (default: "")'
> +
> +.PHONY: all utils libcpupower update-po create-gmo install-lib install-tools install-man install-gmo install uninstall clean help
> 
> ---
> base-commit: 6906a84c482f098d31486df8dc98cead21cce2d0
> change-id: 20240613-make-help-14359a943e7b
> 
> Best regards,

Something wrong in your process here. There shouldn't be
addition text at the end of the patch.

Use git-send email to send patches.

thanks,
-- Shuah