[PATCH] KBuild documentation - make dep

[PATCH] KBuild documentation - make dep

[Jeff Smith]

Remove references to make {dep|depend} in kbuild documentation.

- Jeff Smith

========================================================================
--- a/Documentation/kbuild/commands.txt Mon May 26 20:00:41 2003
+++ b/Documentation/kbuild/commands.txt Tue May 27 11:59:24 2003
@@ -17,7 +17,6 @@
 you need:

     make config
-    make dep
     make bzImage

 Instead of 'make config', you can run 'make menuconfig' for a full-screen
@@ -86,28 +85,5 @@

        You can run 'make checkhelp' without configuring the kernel.
        Also, 'make checkhelp' does not modify any files.
-
-    make dep, make depend
-
-       'make dep' is a synonym for the long form, 'make depend'.
-
-       This command does two things.  First, it computes dependency
-       information about which .o files depend on which .h files.
-       It records this information in a top-level file named .hdepend
-       and in one file per source directory named .depend.
-
-       Second, if you have CONFIG_MODVERSIONS enabled, 'make dep'
-       computes symbol version information for all of the files that
-       export symbols (note that both resident and modular files may
-       export symbols).
-
-       If you do not enable CONFIG_MODVERSIONS, you only have to run
-       'make dep' once, right after the first time you configure
-       the kernel.  The .hdepend files and the .depend file are
-       independent of your configuration.
-
-       If you do enable CONFIG_MODVERSIONS, you must run 'make dep'
-       every time you change your configuration, because the module
-       symbol version information depends on the configuration.

 [to be continued ...]


__________________________________
Do you Yahoo!?
The New Yahoo! Search - Faster. Easier. Bingo.
http://search.yahoo.com

Re: [PATCH] KBuild documentation - make dep

[Paulo Andre']

On Tue, 27 May 2003 10:44:53 -0700 (PDT)
Jeff Smith <whydoubt@yahoo.com> wrote:

> Remove references to make {dep|depend} in kbuild documentation.

Perhaps a reference saying that `make dep' is not needed anymore and
that it is actually deprecated should remain in the documentation?

		Paulo

Re: [PATCH] KBuild documentation - make dep

[Jeff Smith]

--- Paulo Andre' <fscked@iol.pt> wrote:
> On Tue, 27 May 2003 10:44:53 -0700 (PDT)
> Jeff Smith <whydoubt@yahoo.com> wrote:
> 
> Perhaps a reference saying that `make dep' is not needed anymore and
> that it is actually deprecated should remain in the documentation?
> 
> 		Paulo

Paulo,
I would say make dep was deprecated around 2.5.23.  In 2.5.60, in the root
Makefile, the target was reduced to a simple warning.  I would call this
'obsoleted'.  As far as I can tell, only one Makefile still utilizes the
dep target, and this may be an oversight.  So how about this patch:

-- Jeff Smith

========================================================================
--- a/Documentation/kbuild/commands.txt Mon May 26 20:00:41 2003
+++ b/Documentation/kbuild/commands.txt Tue May 27 23:39:29 2003
@@ -17,7 +17,6 @@
 you need:

     make config
-    make dep
     make bzImage

 Instead of 'make config', you can run 'make menuconfig' for a full-screen
@@ -91,23 +90,6 @@

        'make dep' is a synonym for the long form, 'make depend'.

-       This command does two things.  First, it computes dependency
-       information about which .o files depend on which .h files.
-       It records this information in a top-level file named .hdepend
-       and in one file per source directory named .depend.
-
-       Second, if you have CONFIG_MODVERSIONS enabled, 'make dep'
-       computes symbol version information for all of the files that
-       export symbols (note that both resident and modular files may
-       export symbols).
-
-       If you do not enable CONFIG_MODVERSIONS, you only have to run
-       'make dep' once, right after the first time you configure
-       the kernel.  The .hdepend files and the .depend file are
-       independent of your configuration.
-
-       If you do enable CONFIG_MODVERSIONS, you must run 'make dep'
-       every time you change your configuration, because the module
-       symbol version information depends on the configuration.
+       As of version 2.5.60, this command is obsolete.

 [to be continued ...]


__________________________________
Do you Yahoo!?
Yahoo! Calendar - Free online calendar with sync to Outlook(TM).
http://calendar.yahoo.com

Re: [PATCH] KBuild documentation - make dep

[Paulo Andre']

[-- Attachment #1: Type: text/plain, Size: 532 bytes --]

On Tue, 27 May 2003 22:08:19 -0700 (PDT)
Jeff Smith <whydoubt@yahoo.com> wrote:

>
> Paulo,
> I would say make dep was deprecated around 2.5.23.  In 2.5.60, in the
> root Makefile, the target was reduced to a simple warning.  I would
> call this'obsoleted'.  As far as I can tell, only one Makefile still
> utilizes the dep target, and this may be an oversight.  So how about
> this patch:

Thanks for the insight, wasn't aware of the exact versions. Following
that, I've elaborated it just a bit more. What do you think?

		Paulo


[-- Attachment #2: kbuild-commands.txt.patch --]
[-- Type: text/plain, Size: 1321 bytes --]

--- linux-2.5-vanilla/Documentation/kbuild/commands.txt	2003-03-24 22:00:50.000000000 +0000
+++ linux/Documentation/kbuild/commands.txt	2003-05-28 11:12:48.000000000 +0100
@@ -91,23 +91,8 @@
 
 	'make dep' is a synonym for the long form, 'make depend'.
 
-	This command does two things.  First, it computes dependency
-	information about which .o files depend on which .h files.
-	It records this information in a top-level file named .hdepend
-	and in one file per source directory named .depend.
-
-	Second, if you have CONFIG_MODVERSIONS enabled, 'make dep'
-	computes symbol version information for all of the files that
-	export symbols (note that both resident and modular files may
-	export symbols).
-
-	If you do not enable CONFIG_MODVERSIONS, you only have to run
-	'make dep' once, right after the first time you configure
-	the kernel.  The .hdepend files and the .depend file are
-	independent of your configuration.
-
-	If you do enable CONFIG_MODVERSIONS, you must run 'make dep'
-	every time you change your configuration, because the module
-	symbol version information depends on the configuration.
+	As a visible side effect of the new kbuild system, 'make dep'
+	is no longer needed at any build stage anymore. As of version
+	2.5.60 this target has actually become obsolete.
 
 [to be continued ...]

Re: [PATCH] KBuild documentation - make dep

[Jeff Smith]

Sounds good to me.

  -- Jeff Smith

--- Paulo Andre' <fscked@iol.pt> wrote:
> Thanks for the insight, wasn't aware of the exact versions. Following
> that, I've elaborated it just a bit more. What do you think?
> 
> 		Paulo
> 
<snip>
> +	As a visible side effect of the new kbuild system, 'make dep'
> +	is no longer needed at any build stage anymore. As of version
> +	2.5.60 this target has actually become obsolete.
<snip>
> 

__________________________________
Do you Yahoo!?
Yahoo! Calendar - Free online calendar with sync to Outlook(TM).
http://calendar.yahoo.com