Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1686408 > unrolled thread

[PATCH] kbuild: trivial cleanup on the comments

Started byCao jin <caoj.fnst@cn.fujitsu.com>
First post2017-07-13 11:40 +0200
Last post2017-07-17 13:20 +0200
Articles 4 — 3 participants

Back to article view | Back to linux.kernel


Contents

  [PATCH] kbuild: trivial cleanup on the comments Cao jin <caoj.fnst@cn.fujitsu.com> - 2017-07-13 11:40 +0200
    [PATCH v2] kbuild: trivial cleanups on the comments Cao jin <caoj.fnst@cn.fujitsu.com> - 2017-07-16 12:10 +0200
      Re: [PATCH v2] kbuild: trivial cleanups on the comments Randy Dunlap <rdunlap@infradead.org> - 2017-07-16 19:00 +0200
      Re: [PATCH v2] kbuild: trivial cleanups on the comments Masahiro Yamada <yamada.masahiro@socionext.com> - 2017-07-17 13:20 +0200

#1686408 — [PATCH] kbuild: trivial cleanup on the comments

FromCao jin <caoj.fnst@cn.fujitsu.com>
Date2017-07-13 11:40 +0200
Subject[PATCH] kbuild: trivial cleanup on the comments
Message-ID<u2ILg-3SK-9@gated-at.bofh.it>
Signed-off-by: Cao jin <caoj.fnst@cn.fujitsu.com>
---
 scripts/Kbuild.include | 7 +++----
 scripts/basic/Makefile | 2 +-
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/scripts/Kbuild.include b/scripts/Kbuild.include
index 61f87a9..f0a4ada 100644
--- a/scripts/Kbuild.include
+++ b/scripts/Kbuild.include
@@ -85,8 +85,8 @@ TMPOUT := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/)
 
 # try-run
 # Usage: option = $(call try-run, $(CC)...-o "$$TMP",option-ok,otherwise)
-# Exit code chooses option. "$$TMP" is can be used as temporary file and
-# is automatically cleaned up.
+# Exit code chooses option. "$$TMP" serves as temporary file and is
+# automatically cleaned up.
 try-run = $(shell set -e;		\
 	TMP="$(TMPOUT).$$$$.tmp";	\
 	TMPO="$(TMPOUT).$$$$.o";	\
@@ -256,7 +256,6 @@ make-cmd = $(call escsq,$(subst \#,\\\#,$(subst $$,$$$$,$(cmd_$(1)))))
 any-prereq = $(filter-out $(PHONY),$?) $(filter-out $(PHONY) $(wildcard $^),$^)
 
 # Execute command if command has changed or prerequisite(s) are updated.
-#
 if_changed = $(if $(strip $(any-prereq) $(arg-check)),                       \
 	@set -e;                                                             \
 	$(echo-cmd) $(cmd_$(1));                                             \
@@ -310,7 +309,7 @@ if_changed_rule = $(if $(strip $(any-prereq) $(arg-check) ),                 \
 	$(rule_$(1)), @:)
 
 ###
-# why - tell why a a target got build
+# why - tell why a target got build
 #       enabled by make V=2
 #       Output (listed in the order they are checked):
 #          (1) - due to target is PHONY
diff --git a/scripts/basic/Makefile b/scripts/basic/Makefile
index ec10d93..edd983f 100644
--- a/scripts/basic/Makefile
+++ b/scripts/basic/Makefile
@@ -1,5 +1,5 @@
 ###
-# Makefile.basic lists the most basic programs used during the build process.
+# scripts/basic/Makefile lists the most basic programs used during the build process.
 # The programs listed herein are what are needed to do the basic stuff,
 # such as fix file dependencies.
 # This initial step is needed to avoid files to be recompiled
-- 
2.1.0

[toc] | [next] | [standalone]


#1688181 — [PATCH v2] kbuild: trivial cleanups on the comments

FromCao jin <caoj.fnst@cn.fujitsu.com>
Date2017-07-16 12:10 +0200
Subject[PATCH v2] kbuild: trivial cleanups on the comments
Message-ID<u3OEV-62q-3@gated-at.bofh.it>
In reply to#1686408
Signed-off-by: Cao jin <caoj.fnst@cn.fujitsu.com>
---
 Makefile               | 6 +++---
 scripts/Kbuild.include | 7 +++----
 scripts/basic/Makefile | 2 +-
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/Makefile b/Makefile
index 7b60fb3..2600f03 100644
--- a/Makefile
+++ b/Makefile
@@ -961,7 +961,7 @@ export KBUILD_VMLINUX_INIT := $(head-y) $(init-y)
 export KBUILD_VMLINUX_MAIN := $(core-y) $(libs-y) $(drivers-y) $(net-y) $(virt-y)
 export KBUILD_LDS          := arch/$(SRCARCH)/kernel/vmlinux.lds
 export LDFLAGS_vmlinux
-# used by scripts/pacmage/Makefile
+# used by scripts/package/Makefile
 export KBUILD_ALLDIRS := $(sort $(filter-out arch/%,$(vmlinux-alldirs)) arch Documentation include samples scripts tools)
 
 vmlinux-deps := $(KBUILD_LDS) $(KBUILD_VMLINUX_INIT) $(KBUILD_VMLINUX_MAIN)
@@ -989,8 +989,8 @@ include/generated/autoksyms.h: FORCE
 ARCH_POSTLINK := $(wildcard $(srctree)/arch/$(SRCARCH)/Makefile.postlink)
 
 # Final link of vmlinux with optional arch pass after final link
-    cmd_link-vmlinux =                                                 \
-	$(CONFIG_SHELL) $< $(LD) $(LDFLAGS) $(LDFLAGS_vmlinux) ;       \
+cmd_link-vmlinux =                                                 \
+	$(CONFIG_SHELL) $< $(LD) $(LDFLAGS) $(LDFLAGS_vmlinux) ;    \
 	$(if $(ARCH_POSTLINK), $(MAKE) -f $(ARCH_POSTLINK) $@, true)
 
 vmlinux: scripts/link-vmlinux.sh vmlinux_prereq $(vmlinux-deps) FORCE
diff --git a/scripts/Kbuild.include b/scripts/Kbuild.include
index 61f87a9..f0a4ada 100644
--- a/scripts/Kbuild.include
+++ b/scripts/Kbuild.include
@@ -85,8 +85,8 @@ TMPOUT := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/)
 
 # try-run
 # Usage: option = $(call try-run, $(CC)...-o "$$TMP",option-ok,otherwise)
-# Exit code chooses option. "$$TMP" is can be used as temporary file and
-# is automatically cleaned up.
+# Exit code chooses option. "$$TMP" serves as temporary file and is
+# automatically cleaned up.
 try-run = $(shell set -e;		\
 	TMP="$(TMPOUT).$$$$.tmp";	\
 	TMPO="$(TMPOUT).$$$$.o";	\
@@ -256,7 +256,6 @@ make-cmd = $(call escsq,$(subst \#,\\\#,$(subst $$,$$$$,$(cmd_$(1)))))
 any-prereq = $(filter-out $(PHONY),$?) $(filter-out $(PHONY) $(wildcard $^),$^)
 
 # Execute command if command has changed or prerequisite(s) are updated.
-#
 if_changed = $(if $(strip $(any-prereq) $(arg-check)),                       \
 	@set -e;                                                             \
 	$(echo-cmd) $(cmd_$(1));                                             \
@@ -310,7 +309,7 @@ if_changed_rule = $(if $(strip $(any-prereq) $(arg-check) ),                 \
 	$(rule_$(1)), @:)
 
 ###
-# why - tell why a a target got build
+# why - tell why a target got build
 #       enabled by make V=2
 #       Output (listed in the order they are checked):
 #          (1) - due to target is PHONY
diff --git a/scripts/basic/Makefile b/scripts/basic/Makefile
index ec10d93..edd983f 100644
--- a/scripts/basic/Makefile
+++ b/scripts/basic/Makefile
@@ -1,5 +1,5 @@
 ###
-# Makefile.basic lists the most basic programs used during the build process.
+# scripts/basic/Makefile lists the most basic programs used during the build process.
 # The programs listed herein are what are needed to do the basic stuff,
 # such as fix file dependencies.
 # This initial step is needed to avoid files to be recompiled
-- 
2.1.0

[toc] | [prev] | [next] | [standalone]


#1688509 — Re: [PATCH v2] kbuild: trivial cleanups on the comments

FromRandy Dunlap <rdunlap@infradead.org>
Date2017-07-16 19:00 +0200
SubjectRe: [PATCH v2] kbuild: trivial cleanups on the comments
Message-ID<u3V3H-1yX-1@gated-at.bofh.it>
In reply to#1688181
On 07/16/2017 03:12 AM, Cao jin wrote:
> Signed-off-by: Cao jin <caoj.fnst@cn.fujitsu.com>
> ---
>  Makefile               | 6 +++---
>  scripts/Kbuild.include | 7 +++----
>  scripts/basic/Makefile | 2 +-
>  3 files changed, 7 insertions(+), 8 deletions(-)


> @@ -310,7 +309,7 @@ if_changed_rule = $(if $(strip $(any-prereq) $(arg-check) ),                 \
>  	$(rule_$(1)), @:)
>  
>  ###
> -# why - tell why a a target got build
> +# why - tell why a target got build

	tell why a target got built
or
	tell why a target was built

>  #       enabled by make V=2
>  #       Output (listed in the order they are checked):
>  #          (1) - due to target is PHONY


-- 
~Randy

[toc] | [prev] | [next] | [standalone]


#1688933 — Re: [PATCH v2] kbuild: trivial cleanups on the comments

FromMasahiro Yamada <yamada.masahiro@socionext.com>
Date2017-07-17 13:20 +0200
SubjectRe: [PATCH v2] kbuild: trivial cleanups on the comments
Message-ID<u4ced-4iB-3@gated-at.bofh.it>
In reply to#1688181
Hi Cao,


2017-07-16 19:12 GMT+09:00 Cao jin <caoj.fnst@cn.fujitsu.com>:
> index 61f87a9..f0a4ada 100644
> --- a/scripts/Kbuild.include
> +++ b/scripts/Kbuild.include
> @@ -85,8 +85,8 @@ TMPOUT := $(if $(KBUILD_EXTMOD),$(firstword $(KBUILD_EXTMOD))/)
>
>  # try-run
>  # Usage: option = $(call try-run, $(CC)...-o "$$TMP",option-ok,otherwise)
> -# Exit code chooses option. "$$TMP" is can be used as temporary file and
> -# is automatically cleaned up.
> +# Exit code chooses option. "$$TMP" serves as temporary file and is
> +# automatically cleaned up.


I am not a native speaker, but I think "file" is countable.

Maybe, is "as a temporary file" even better?




> diff --git a/scripts/basic/Makefile b/scripts/basic/Makefile
> index ec10d93..edd983f 100644
> --- a/scripts/basic/Makefile
> +++ b/scripts/basic/Makefile
> @@ -1,5 +1,5 @@
>  ###
> -# Makefile.basic lists the most basic programs used during the build process.
> +# scripts/basic/Makefile lists the most basic programs used during the build process.

This change is correct, but this line will exceed 80 cols limit.

Wrap the lines, or reword like "This Makefile lists ..."

Either will do.



>  # The programs listed herein are what are needed to do the basic stuff,
>  # such as fix file dependencies.
>  # This initial step is needed to avoid files to be recompiled






-- 
Best Regards
Masahiro Yamada

[toc] | [prev] | [standalone]


Back to top | Article view | linux.kernel


csiph-web