1 files changed, 17 insertions, 0 deletions
diff --git a/cflags.SH b/cflags.SH
index a80eb5d6ea..84e3187f02 100755
--- a/cflags.SH
+++ b/cflags.SH
@@ -1,5 +1,17 @@
 #!/bin/sh
 
+# Generate the cflags script, which is used to determine what cflags
+# to pass to the compiler.
+# We create a temporary test c program and repeatedly compile it with
+# various candidate flags, and from the compiler output, determine what
+# flags are supported.
+# From this we initialise the following variables in the cflags script:
+#
+#   $warn
+#   $stdflags
+#   $extra
+#   $_exe
+
 case $PERL_CONFIG_SH in
 '')
 	if test -f config.sh; then TOP=.;
@@ -210,6 +222,11 @@ rm -f cflags
 $spitshell >cflags <<!GROK!THIS!
 $startsh
 
+# !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
+
+# This file is generated by cflags.SH
+
+
 # Extra warnings, used e.g. for gcc.
 warn="$warn"
 # Extra standardness.