pointed out by Sam Ravnborg

The rewritten makefile for DocBook requires that working directory
is $(TOPDIR) therefore use -f Documentation/DocBook/Makefile to
invoke the docbook makefile.

To support the new DocBook makefile the script target needs to be located
the block that is checked for precense of a .config file.

the global irq-lock debugging

The serial layer is restructured to allow less code duplication (and
hence bug duplication) across various serial drivers.  Since ARM adds
six extra serial drivers, maintaining six copies of serial.c was not
my idea of fun.

Therefore, we've ended up with a core serial driver, which knows about
the interactions with the tty layer, and low-level hardware drivers,
which know all about the hardware.  The interface between the two is
described in "Documentation/serial/driver".

This patch completely removes the old serial.c driver and its associated
configuration options, as you requested at KS2002.  We keep a certain
amount of configuration compatibility with the per-architecture serial.h
file for the moment; this *will* be killed in the next round of patches.
The biggest user of this is x86, and since I don't have an x86 box to
test this stuff on, I think the changes are best kept separate.

Added the new target "help" that list the most common targets
Calls down to Documentation/Makefile to list documentation targets.
Furthermore calls down to the architecture specific Makefile
to list architecture specific targets.
So far only i386 is supporting this.

Use the Rules.make provided objcopy command and untangle piggy.o
generation.

Some archs sneaked additional flags for ld into $(LD). This can be done
cleaner now, by just using $(LDFLAGS).

Everywhere else we use CFLAGS_<target> etc to designate special flags
for an object, so handle vmlinux the same way.

    
o Provide $(obj),$(objtree) and friends in the top-level Makefile as well
  for consistency (Sam Ravnborg)
o Make $(call cmd,whatever) consistent with $(call if_changed,whatever),
  i.e. both will execute $(cmd_whatever)
o Add $(echo_target), which will print the current target in a suitable
  way for the quiet output format (i.e. target name relative to the
  top-level directory)
o Fix the dependencies for host compiled programs to work for files in
  subdirectories (missed converting them when introducing $(depfile))
o Add commands which will be useful when generating boot images.

This fixes the tags/TAGS/clean/etc targets.

People are confused by "make vmlinux/bzImage/..." building modules at
the same time. So revert to the old behavior.

"make bzImage modules" builds bzImage and modules, using only one pass
of descending into subdirs.

"make" or "make all" builds a standard target of "vmlinux modules". On
i386 this is extended to do "bzImage modules", which seems to be the most
sensible default.

For separate source and object directories, Rules.make needs
to know where the files live.

For all the normal variables, $(obj-[ymn]) etc, it can figure that
out by itself, but for explicit rules to generate files it needs
help. 

So there $(obj)/target.o indicates that this file lives in the 
object directory, as opposed to $(src)/target.c, which lives in
the source dir.

For now $(obj) = $(src) = ., but convert some Makefiles to it
already.

Rename the shipped 53c.. firmware files to <name>_shipped.

Add a default rule for shipped files, which will just
call <name>_shipped to <name> if no specific rule to generate
the target exists.

Rename the aic7xxx firmware to fit into this naming scheme.

For now 53c... defaults to just using the shipped firmware.

We skip removing scripts/lxdialog/.*.cmd on make clean, which is
on purpose since we want lxdialog to survive here. But on
make mrproper these should go as well.

make got confused in some cases when we had both targets which
do and do not need .config included on the command line. Simplify
and fix it by just re-calling make for each target separately
in this case.

(Andries Brouwer)

Since we don't do dependencies up front anymore, archdep does not make
too much sense anymore. It was mostly unused now anyway, move the
remaining users to the "prepare" target, which is exactly what is wanted:
Do some work before the actual build gets started.

Now we have three archs and three different prefixes in front of
numbers: #,$,none. We'll see what the others bring...

Switch to a new way of generating a header file defining the offsets
into C structs for use in assembler code.

This method will hopefully be shared by all archs in the future.

The way to do handle things is taken from (or at least inspired by) 
Keith Owens' kbuild-2.5, so credit for this and the following patches
goes to him ;)

net/802/ contained some generated files + partially working
rules on how to rebuild them.

Fix the rules how to rebuild them and remove the generated files
from the tree.

A couple of targets were still in the main part of the Makefile,
even though they did not need .config to exist for execution.

Move them into the noconfig section of the Makefile, allowing them
to be executed before make *config.

by Sam Ravnborg

Up to now, we generated module versions for all objects which
were listed in $(export-objs).

This had one advantage: A changed .config will not affect which
.ver files are built, thus saving recompiles.

However, it is fundamentally broken. To build .ver files, we preprocess
the exporting sources - and the result can obviously depend on
the current .config. Even worse, some files generate errors when
preprocessed with the wrong .config - it doesn't matter a lot that
drivers/sbus/* will generate errors on x86, since it won't be used anyway,
but e.g. kernel/suspend.c cannot be preprocessed unless 
CONFIG_SOFTWARE_SUSPEND is set. - Up to now, we just silently ignore
these errors.

Actually, the whole point behind CONFIG_MODVERSIONS is to make sure
we don't insert modules into a kernel which was configured differently,
and as such the generation of symbols can only work when .config is
known.

So we now only generate symbols for objects which will actually be
compiled - which means less work, and enforce the kernel to be configured
before "make dep".

o When using "make -j<n>", the order in modversions.h could change,
  thus causing unnecessary rebuilds.
o Move a comment in Rules.make which I forgot when I moved the
  associated code.
o When descending into init/ during the final vmlinux link,
  add a '+' do tell make to use its normal "-j" jobserver handling.
o It'd be nice to get the logic between make clean and make mrproper
  clearer. I think make clean should remove all targets used in the
  actual build,
  make mrproper should remove the rest, build-specific files, like
  e.g. the .*.cmd files used to save dependencies and command lines
  and other temporary files.
  A real small step in the direction: Remove .tmpversion/.tmp-export-objs
  at mrproper time.

o Fix a bug in fixdep.c, which could cause segfaults
o Make sure that we build fixdep first of all, since
  we need it to build host programs.

Patch by Keith Owens, ported to 2.5.

If the length of $(VERSION).$(PATCHLEVEL).$(SUBLEVEL)$(EXTRAVERSION)
exceeds 64 characters it silently corrupts the utsname data, resulting
in garbage for uname -r and problems running the kernel and modules.
Abort if KERNELRELEASE is too long.  Truncation is not good enough, it
results in ambiguous /lib/modules/`uname -r` contents.

Ensure that the date/time in uname are always in LANG=C.  Users with
other languages report that 8 bit values cause the boot messages to go
haywire.

- add comment about the vmlinux link components
- get rid of DRIVERS-y - always linking in sound/sound.o doesn't harm
- sort SUBDIRS in link order
- always use := to assign
- remove supeflous $(TOPDIR) for lib/lib.a