[PATCH 05/19] kbuild: document cc-fullversion

[PATCH 05/19] kbuild: document cc-fullversion

[Sam Ravnborg]

Subject: [PATCH 05/19] kbuild: document cc-fullversion
From: Sam Ravnborg <sam@ravnborg.org>
Date: Mon, 28 May 2007 22:26:55 +0200

Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
---
 Documentation/kbuild/makefiles.txt |   14 ++++++++++++++
 1 files changed, 14 insertions(+), 0 deletions(-)

diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
index bb5306e..c6d9a35 100644
--- a/Documentation/kbuild/makefiles.txt
+++ b/Documentation/kbuild/makefiles.txt
@@ -501,6 +501,20 @@ more details, with real examples.
 	The third parameter may be a text as in this example, but it may also
 	be an expanded variable or a macro.
 
+    cc-fullversion
+	cc-fullversion is usefull when the exact version of gcc is needed.
+	One typical use-case is when a specific GCC version is broken.
+	cc-fullversion points out a more specific version than cc-version does.
+
+	Example:
+		#arch/powerpc/Makefile
+		$(Q)if test "$(call cc-fullversion)" = "040200" ; then \
+			echo -n '*** GCC-4.2.0 cannot compile the 64-bit powerpc ' ; \
+			false ; \
+		fi
+
+	In this example for a specific GCC version the build will error out explaining
+	the user why it stops.
 
 === 4 Host Program support
 
-- 
1.5.1.rc3.1544.g8a923


----- End forwarded message -----

Re: [PATCH 05/19] kbuild: document cc-fullversion

[Randy Dunlap]

On Sun, 3 Jun 2007 22:46:03 +0200 Sam Ravnborg wrote:

> Subject: [PATCH 05/19] kbuild: document cc-fullversion
> From: Sam Ravnborg <sam@ravnborg.org>
> Date: Mon, 28 May 2007 22:26:55 +0200
> 
> Signed-off-by: Sam Ravnborg <sam@ravnborg.org>
> ---
>  Documentation/kbuild/makefiles.txt |   14 ++++++++++++++
>  1 files changed, 14 insertions(+), 0 deletions(-)
> 
> diff --git a/Documentation/kbuild/makefiles.txt b/Documentation/kbuild/makefiles.txt
> index bb5306e..c6d9a35 100644
> --- a/Documentation/kbuild/makefiles.txt
> +++ b/Documentation/kbuild/makefiles.txt
> @@ -501,6 +501,20 @@ more details, with real examples.
>  	The third parameter may be a text as in this example, but it may also
>  	be an expanded variable or a macro.
>  
> +    cc-fullversion
> +	cc-fullversion is usefull when the exact version of gcc is needed.

                          useful

> +	One typical use-case is when a specific GCC version is broken.
> +	cc-fullversion points out a more specific version than cc-version does.
> +
> +	Example:
> +		#arch/powerpc/Makefile
> +		$(Q)if test "$(call cc-fullversion)" = "040200" ; then \
> +			echo -n '*** GCC-4.2.0 cannot compile the 64-bit powerpc ' ; \
> +			false ; \
> +		fi
> +
> +	In this example for a specific GCC version the build will error out explaining
> +	the user why it stops.

        to the user why  it stops.
>  
>  === 4 Host Program support
>  
> -- 

---
~Randy
*** Remember to use Documentation/SubmitChecklist when testing your code ***