Remove make preinstall

A speciality of the RTEMS build system was the make preinstall step.  It
copied header files from arbitrary locations into the build tree.  The
header files were included via the -Bsome/build/tree/path GCC command
line option.

This has at least seven problems:

* The make preinstall step itself needs time and disk space.

* Errors in header files show up in the build tree copy.  This makes it
  hard for editors to open the right file to fix the error.

* There is no clear relationship between source and build tree header
  files.  This makes an audit of the build process difficult.

* The visibility of all header files in the build tree makes it
  difficult to enforce API barriers.  For example it is discouraged to
  use BSP-specifics in the cpukit.

* An introduction of a new build system is difficult.

* Include paths specified by the -B option are system headers.  This
  may suppress warnings.

* The parallel build had sporadic failures on some hosts.

This patch removes the make preinstall step.   All installed header
files are moved to dedicated include directories in the source tree.
Let @RTEMS_CPU@ be the target architecture, e.g. arm, powerpc, sparc,
etc.  Let @RTEMS_BSP_FAMILIY@ be a BSP family base directory, e.g.
erc32, imx, qoriq, etc.

The new cpukit include directories are:

* cpukit/include

* cpukit/score/cpu/@RTEMS_CPU@/include

* cpukit/libnetworking

The new BSP include directories are:

* bsps/include

* bsps/@RTEMS_CPU@/include

* bsps/@RTEMS_CPU@/@RTEMS_BSP_FAMILIY@/include

There are build tree include directories for generated files.

The include directory order favours the most general header file, e.g.
it is not possible to override general header files via the include path
order.

The "bootstrap -p" option was removed.  The new "bootstrap -H" option
should be used to regenerate the "headers.am" files.

Update #3254.

33 files changed, 0 insertions, 10 deletions

diff --git a/cpukit/libmisc/bspcmdline/bspcmdline.h b/cpukit/include/rtems/bspcmdline.h
index 51916ff26a..51916ff26a 100644
--- a/cpukit/libmisc/bspcmdline/bspcmdline.h
+++ b/cpukit/include/rtems/bspcmdline.h
diff --git a/cpukit/libmisc/capture/capture-cli.h b/cpukit/include/rtems/capture-cli.h
index 55749b7cb1..55749b7cb1 100644
--- a/cpukit/libmisc/capture/capture-cli.h
+++ b/cpukit/include/rtems/capture-cli.h
diff --git a/cpukit/libmisc/capture/capture.h b/cpukit/include/rtems/capture.h
index f847ee0424..f847ee0424 100644
--- a/cpukit/libmisc/capture/capture.h
+++ b/cpukit/include/rtems/capture.h
diff --git a/cpukit/libmisc/capture/captureimpl.h b/cpukit/include/rtems/captureimpl.h
index 4c4cbe66c3..4c4cbe66c3 100644
--- a/cpukit/libmisc/capture/captureimpl.h
+++ b/cpukit/include/rtems/captureimpl.h
diff --git a/cpukit/libmisc/cpuuse/cpuuse.h b/cpukit/include/rtems/cpuuse.h
index 23f58faf1b..23f58faf1b 100644
--- a/cpukit/libmisc/cpuuse/cpuuse.h
+++ b/cpukit/include/rtems/cpuuse.h
diff --git a/cpukit/libmisc/devnull/devnull.h b/cpukit/include/rtems/devnull.h
index 39081f478b..39081f478b 100644
--- a/cpukit/libmisc/devnull/devnull.h
+++ b/cpukit/include/rtems/devnull.h
diff --git a/cpukit/libmisc/devnull/devzero.h b/cpukit/include/rtems/devzero.h
index bc47d3ea09..bc47d3ea09 100644
--- a/cpukit/libmisc/devnull/devzero.h
+++ b/cpukit/include/rtems/devzero.h
diff --git a/cpukit/libmisc/dumpbuf/dumpbuf.h b/cpukit/include/rtems/dumpbuf.h
index d714879ab4..d714879ab4 100644
--- a/cpukit/libmisc/dumpbuf/dumpbuf.h
+++ b/cpukit/include/rtems/dumpbuf.h
diff --git a/cpukit/libmisc/fb/fb.h b/cpukit/include/rtems/fb.h
index bb5cb23805..bb5cb23805 100644
--- a/cpukit/libmisc/fb/fb.h
+++ b/cpukit/include/rtems/fb.h
diff --git a/cpukit/libmisc/fsmount/fsmount.h b/cpukit/include/rtems/fsmount.h
index 441b0d68ef..441b0d68ef 100644
--- a/cpukit/libmisc/fsmount/fsmount.h
+++ b/cpukit/include/rtems/fsmount.h
diff --git a/cpukit/libmisc/monitor/monitor.h b/cpukit/include/rtems/monitor.h
index 6ecd903c63..6ecd903c63 100644
--- a/cpukit/libmisc/monitor/monitor.h
+++ b/cpukit/include/rtems/monitor.h
diff --git a/cpukit/libmisc/mouse/mouse_parser.h b/cpukit/include/rtems/mouse_parser.h
index 27bea1bbbc..27bea1bbbc 100644
--- a/cpukit/libmisc/mouse/mouse_parser.h
+++ b/cpukit/include/rtems/mouse_parser.h
diff --git a/cpukit/libmisc/fb/mw_uid.h b/cpukit/include/rtems/mw_uid.h
index aa88392d26..aa88392d26 100644
--- a/cpukit/libmisc/fb/mw_uid.h
+++ b/cpukit/include/rtems/mw_uid.h
diff --git a/cpukit/libmisc/rtems-fdt/rtems-fdt-shell.h b/cpukit/include/rtems/rtems-fdt-shell.h
index 74e9a44aaf..74e9a44aaf 100644
--- a/cpukit/libmisc/rtems-fdt/rtems-fdt-shell.h
+++ b/cpukit/include/rtems/rtems-fdt-shell.h
diff --git a/cpukit/libmisc/rtems-fdt/rtems-fdt.h b/cpukit/include/rtems/rtems-fdt.h
index ebc222e4c9..ebc222e4c9 100644
--- a/cpukit/libmisc/rtems-fdt/rtems-fdt.h
+++ b/cpukit/include/rtems/rtems-fdt.h
diff --git a/cpukit/libmisc/serdbg/serdbg.h b/cpukit/include/rtems/serdbg.h
index fe106bce44..fe106bce44 100644
--- a/cpukit/libmisc/serdbg/serdbg.h
+++ b/cpukit/include/rtems/serdbg.h
diff --git a/cpukit/libmisc/serdbg/serdbgcnf.h b/cpukit/include/rtems/serdbgcnf.h
index 9d4087ae69..9d4087ae69 100644
--- a/cpukit/libmisc/serdbg/serdbgcnf.h
+++ b/cpukit/include/rtems/serdbgcnf.h
diff --git a/cpukit/libmisc/mouse/serial_mouse.h b/cpukit/include/rtems/serial_mouse.h
index 174fcfb909..174fcfb909 100644
--- a/cpukit/libmisc/mouse/serial_mouse.h
+++ b/cpukit/include/rtems/serial_mouse.h
diff --git a/cpukit/libmisc/shell/shell.h b/cpukit/include/rtems/shell.h
index 98ddf0a958..98ddf0a958 100644
--- a/cpukit/libmisc/shell/shell.h
+++ b/cpukit/include/rtems/shell.h
diff --git a/cpukit/libmisc/shell/shellconfig.h b/cpukit/include/rtems/shellconfig.h
index 9f68b313fb..9f68b313fb 100644
--- a/cpukit/libmisc/shell/shellconfig.h
+++ b/cpukit/include/rtems/shellconfig.h
diff --git a/cpukit/libmisc/stackchk/stackchk.h b/cpukit/include/rtems/stackchk.h
index 16fc4f9b9d..16fc4f9b9d 100644
--- a/cpukit/libmisc/stackchk/stackchk.h
+++ b/cpukit/include/rtems/stackchk.h
diff --git a/cpukit/libmisc/redirector/stdio-redirect.h b/cpukit/include/rtems/stdio-redirect.h
index 6f1d4cdd98..6f1d4cdd98 100644
--- a/cpukit/libmisc/redirector/stdio-redirect.h
+++ b/cpukit/include/rtems/stdio-redirect.h
diff --git a/cpukit/libmisc/stringto/stringto.h b/cpukit/include/rtems/stringto.h
index 878814da54..878814da54 100644
--- a/cpukit/libmisc/stringto/stringto.h
+++ b/cpukit/include/rtems/stringto.h
diff --git a/cpukit/libmisc/serdbg/termios_printk.h b/cpukit/include/rtems/termios_printk.h
index dcb183533a..dcb183533a 100644
--- a/cpukit/libmisc/serdbg/termios_printk.h
+++ b/cpukit/include/rtems/termios_printk.h
diff --git a/cpukit/libmisc/serdbg/termios_printk_cnf.h b/cpukit/include/rtems/termios_printk_cnf.h
index 03c3090c38..03c3090c38 100644
--- a/cpukit/libmisc/serdbg/termios_printk_cnf.h
+++ b/cpukit/include/rtems/termios_printk_cnf.h
diff --git a/cpukit/libmisc/testsupport/test.h b/cpukit/include/rtems/test.h
index 3dbdb9e32e..3dbdb9e32e 100644
--- a/cpukit/libmisc/testsupport/test.h
+++ b/cpukit/include/rtems/test.h
diff --git a/cpukit/libmisc/capture/rtems-trace-buffer-vars.h b/cpukit/include/rtems/trace/rtems-trace-buffer-vars.h
index 8f0ff08587..8f0ff08587 100644
--- a/cpukit/libmisc/capture/rtems-trace-buffer-vars.h
+++ b/cpukit/include/rtems/trace/rtems-trace-buffer-vars.h
diff --git a/cpukit/libmisc/untar/untar.h b/cpukit/include/rtems/untar.h
index bc0a97c103..bc0a97c103 100644
--- a/cpukit/libmisc/untar/untar.h
+++ b/cpukit/include/rtems/untar.h
diff --git a/cpukit/libmisc/utf8proc/utf8proc.h b/cpukit/include/utf8proc/utf8proc.h
index 24a891b6c6..24a891b6c6 100644
--- a/cpukit/libmisc/utf8proc/utf8proc.h
+++ b/cpukit/include/utf8proc/utf8proc.h
diff --git a/cpukit/libmisc/uuid/uuid.h b/cpukit/include/uuid/uuid.h
index ca846da0f0..ca846da0f0 100644
--- a/cpukit/libmisc/uuid/uuid.h
+++ b/cpukit/include/uuid/uuid.h
diff --git a/cpukit/libmisc/xz/xz.h b/cpukit/include/xz.h
index 0a4b38d33c..0a4b38d33c 100644
--- a/cpukit/libmisc/xz/xz.h
+++ b/cpukit/include/xz.h
diff --git a/cpukit/libmisc/Makefile.am b/cpukit/libmisc/Makefile.am
index e1343ddf11..ca4686a954 100644
--- a/cpukit/libmisc/Makefile.am
+++ b/cpukit/libmisc/Makefile.am
@@ -208,5 +208,4 @@ libxz_a_SOURCES = xz/xz/h xz/xz_crc32.c \
 EXTRA_DIST += xz/README xz/COPING
 
 ## ---
-include $(srcdir)/preinstall.am
 include $(top_srcdir)/automake/local.am
diff --git a/cpukit/libmisc/preinstall.am b/cpukit/libmisc/preinstall.am
deleted file mode 100644
index f6a7e763d2..0000000000
--- a/cpukit/libmisc/preinstall.am
+++ /dev/null
@@ -1,9 +0,0 @@
-## Automatically generated by ampolish3 - Do not edit
-
-if AMPOLISH3
-$(srcdir)/preinstall.am: Makefile.am
-	$(AMPOLISH3) $(srcdir)/Makefile.am > $(srcdir)/preinstall.am
-endif
-
-if LIBSHELL
-endif