mirror of
https://github.com/lm-sensors/lm-sensors.git
synced 2026-10-11 17:12:32 +07:00
Frodo Looijaard
10ca370b06
to add more up-to-date documentation. git-svn-id: http://lm-sensors.org/svn/lm-sensors/trunk@108 7894878c-1315-0410-8ee3-d5d059ff63e0
76 lines
3.2 KiB
Plaintext
76 lines
3.2 KiB
Plaintext
The Makefiles in this package are rather advanced. They are partially based
|
|
on the article "Recursive Make considered Harmful", written by Peter Miller.
|
|
See doc/useful_addresses.html for a link to this article.
|
|
|
|
There is one big Makefile in the root of this package. It includes many
|
|
other files; one for each directory in which source code is found. These
|
|
included files are called 'Module.mk'. There is a separate set of Makefiles
|
|
in the i2c/ directories; these are Simon Vogl's original Makefiles, and
|
|
not referred by the main package Makefile.
|
|
|
|
There are several interesting targets defined through this Makefile:
|
|
* all
|
|
Create everything in all directories.
|
|
* all-i2c, all-src, ...
|
|
Create everything in the designated directory.
|
|
* install
|
|
Install everything from all directories.
|
|
* install-i2c, install-src, ...
|
|
Install everything in the designated directory.
|
|
* clean
|
|
Remove anything which can be regenerated from all directories. A call
|
|
of 'make clean' (without any other targets) will ignore any .d files;
|
|
this is useful when they are out of date (and prevent the calling of
|
|
any other target).
|
|
* clean-i2c, clean-src, ...
|
|
Remove anything which can be regenerated from the designated directory.
|
|
* dep
|
|
Do nothing, but generate any missing .d files. The command
|
|
'make clean && make dep' canbe useful in this case ('make clean dep'
|
|
will not work, due to technical reasons!).
|
|
* version
|
|
Regenerate version.h, using the current date for the date-stamp, and
|
|
a user-supplied version number.
|
|
* package
|
|
Create a .tar.gz file containing everything except the CVS directories.
|
|
* src/lm78.o, i2c/i2c-core.o, ...
|
|
You can of course also specify one or more targets to make.
|
|
|
|
The best way to understand the Module.mk subfiles is to examine one of them,
|
|
for example src/Module.mk. They are not too difficult to understand.
|
|
|
|
There are several variables which can be set in the main Makefile. You can
|
|
also specify them on the command-line; this overrules any definitions
|
|
within the Makefile. For example: 'make all WARN=1' will enable all warnings.
|
|
Examine main Makefile to see which ones are available. The most important
|
|
ones for developers:
|
|
* WARN
|
|
Set to 1 to enable many compiler warnings.
|
|
* DEBUG
|
|
Set to 1 to enable any debugging code. Note that debugging code should
|
|
only output more information, and never make the code mis-behave.
|
|
|
|
Several files are generated by Makefiles:
|
|
* .d
|
|
Dependency files for modules. Automatically generated.
|
|
* .rd
|
|
Dependency files for executables. Automatically generated.
|
|
* .ao
|
|
Dependency files for static libraries. Automatically generated.
|
|
* .lo
|
|
Dependency files for shared libraries. Automatically generated.
|
|
* .o
|
|
Generated modules
|
|
* .ro
|
|
Object files for executables. They will be linked together to create
|
|
the executable. This extension is used to distinguish them from
|
|
modules (which end on .o). Also, using a different extensions makes
|
|
the Makefile fragments much simpler.
|
|
* .ao
|
|
Object files for static libraries
|
|
* .lo
|
|
Object files for shared libraries
|
|
|
|
There are lots of comments within the main Makefile. Please read them if
|
|
you want to know more.
|