Generic Unix makefiles: Update makefile headers.

Update purpose of the makefile and add a warning that these makefiles
are only suitable for generation within the native ACPICA directory
structure (which is different than Linux, for example.)

generate/unix/Makefile

@@ -1,6 +1,15 @@
 #
 # Common make for acpica tools and utilities
 #
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
+#
 include Makefile.config
 
 

generate/unix/Makefile.config

@@ -2,11 +2,21 @@
 # Makefile.config
 #
 # Common configuration and setup file to generate the ACPICA tools and
-# utilities: acpiexec, acpisrc, acpixtract, and the iASL compiler.
+# utilities: acpiexec, acpihelp, acpinames, acpisrc, acpixtract,
+# and the iASL compiler.
 #
 # This file is included by the individual makefiles for each tool.
 #
 
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
+#
+
 #
 # Configuration
 # Note: gcc should be version 4 or greater, otherwise some of the

generate/unix/acpiexec/Makefile

@@ -1,5 +1,16 @@
 #
-# AcpiExec utility
+# acpiexec: ACPI execution simulator. Runs ACPICA code in user
+# space. Loads ACPI tables, displays the namespace, and allows
+# execution of control methods.
+#
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
 #
 include ../Makefile.config
 

generate/unix/acpihelp/Makefile

@@ -1,5 +1,15 @@
 #
-# acpihelp utility
+# acpihelp - ACPI Help utility. Displays ASL operator syntax and
+# information about ACPI predefined names.
+#
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
 #
 include ../Makefile.config
 

generate/unix/acpinames/Makefile

@@ -1,5 +1,16 @@
 #
-# AcpiNames utility
+# acpinames - Load ACPI table and dump namespace. This is a subset
+# of the AcpiExec functionality, it is intended to demonstrate
+# the configurability of ACPICA.
+#
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
 #
 include ../Makefile.config
 

generate/unix/acpisrc/Makefile

@@ -1,5 +1,14 @@
 #
-# acpisrc utility
+# acpisrc - ACPICA source code conversion utility
+#
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
 #
 include ../Makefile.config
 

generate/unix/acpixtract/Makefile

@@ -1,5 +1,14 @@
 #
-# acpixtract utility
+# acpixtract - extract binary ACPI tables from acpidump text output
+#
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
 #
 include ../Makefile.config
 

generate/unix/iasl/Makefile

@@ -1,5 +1,14 @@
 #
-# iASL compiler
+# iASL compiler/disassembler
+#
+
+#
+# Note: This makefile is intended to be used from within the native
+# ACPICA directory structure, from under generate/unix. It specifically
+# places all object files in a generate/unix subdirectory, not within
+# the various ACPICA source directories. This prevents collisions
+# between different compilations of the same source file with different
+# compile options, and prevents pollution of the source code.
 #
 include ../Makefile.config
 

generate/unix/readme.txt

@@ -8,6 +8,7 @@ and in the original (git tree) ACPICA directory structure.
 The top level makefile will generate the following utilities:
 
 acpiexec
+acpihelp
 acpinames
 acpisrc
 acpixtract
@@ -18,7 +19,7 @@ Requirements
 ------------
 
 make
-gcc compiler (3+ or 4+)
+gcc compiler (4+)
 bison
 flex
 
@@ -29,7 +30,7 @@ Configuration
 The Makefile.config file contains the configuration information:
 
 HOST =       _CYGWIN            /* Host system, must appear in acenv.h */
-CC =         gcc-4              /* C compiler */
+CC =         gcc                /* C compiler */
 ACPICA_SRC = ../../../source    /* Location of acpica source tree */