A newer branch for fixinclude work.

: Modified Files:
:  Tag: fixincl-branch
: 	Makefile.in fixinc.dgux fixinc.irix fixinc.ptx fixinc.sco
: 	fixinc.svr4 fixinc.winnt fixinc.wrap fixincl.c fixincl.sh
: 	fixincl.x hackshell.tpl inclhack.def inclhack.sh inclhack.tpl
: 	mkfixinc.sh regex.c regex.h server.c server.h
: Added Files:
: 	README

[[Split portion of a mixed commit.]]

From-SVN: r24488.2

1 files changed, 47 insertions, 0 deletions

diff --git a/gcc/fixinc/README b/gcc/fixinc/README
new file mode 100644
index 0000000..d061cd6
--- /dev/null
+++ b/gcc/fixinc/README
@@ -0,0 +1,47 @@
+
+The fast-fixincludes system now, to the best of our collective belief,
+correctly implements exactly the same functionality as the previous
+fixincludes/fixinc.* shell scripts.  On most systems where many fixes
+are required, this is accomplished by putting most of the functionality
+into a binary executable.  On systems that had dedicated fixinc.* shell
+scripts, those scripts are still used by default until they can be
+converted.
+
+KNOWN PROBLEMS
+
+There may be some systems on which the fixinc binary program appears
+to be functional, but fails to work.  Current thinking is that this
+is due to some new process limitations (fork() calls) on those
+systems.  If you are experiencing this problem, then copy the script
+${src}/gcc/fixinc/inclhack.sh into ${builddir}/gcc/fixinc.sh and run
+make again.
+
+Oh, yes, please also report the problem with a description of
+the failure mode (symptoms) and the output from:
+
+        egcs/config.guess
+
+TO DO
+
+* fixincl needs to be converted to use gcc's system.h, libiberty, and
+  other portability frameworks.
+
+* FIXME: XXX needs to have tests for file descriptors > 10 or 12 added
+  to detect/solve XXX.
+
+* 
+
+
+
+THEORY OF OPS
+
+inclhack.def contains a list of potential fixes to be applied to the
+system headers.   This file is processed by autogen to make both a
+shell script and a binary to apply those fixes to your headers.
+If the binary cannot be built, the shell version will be used instead.
+
+If mkfixinc.sh determines that your system needs machine-specific
+fixes that have not yet been applied to inclhack.def, it will install
+and use the current fixinc.* for that system instead.
+
+