2003-05-27 17:31:47

by Jeff Smith

[permalink] [raw]
Subject: [PATCH] KBuild documentation - make dep

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


2003-05-27 23:14:14

by Paulo Andre'

[permalink] [raw]
Subject: Re: [PATCH] KBuild documentation - make dep

On Tue, 27 May 2003 10:44:53 -0700 (PDT)
Jeff Smith <[email protected]> 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

2003-05-28 04:55:06

by Jeff Smith

[permalink] [raw]
Subject: Re: [PATCH] KBuild documentation - make dep

--- Paulo Andre' <[email protected]> wrote:
> On Tue, 27 May 2003 10:44:53 -0700 (PDT)
> Jeff Smith <[email protected]> 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

2003-05-28 10:02:03

by Paulo Andre'

[permalink] [raw]
Subject: Re: [PATCH] KBuild documentation - make dep

On Tue, 27 May 2003 22:08:19 -0700 (PDT)
Jeff Smith <[email protected]> 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


Attachments:
kbuild-commands.txt.patch (1.29 kB)

2003-05-28 11:45:20

by Jeff Smith

[permalink] [raw]
Subject: Re: [PATCH] KBuild documentation - make dep

Sounds good to me.

-- Jeff Smith

--- Paulo Andre' <[email protected]> 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