Be more charitable and more equitable.

diff --git a/src/PORTING b/src/PORTING
index 8430b25e890fdcc91fc07baaf4bbf5c62f769370..e247f0a9073e203f0e9f9cbf776449dacf1d4467 100644 (file)
--- a/src/PORTING
+++ b/src/PORTING
@@ -1,17 +1,31 @@
-Portability of the new file(1) command:
+Portability of the new file(1) command.
+@(#) $Header: /home/glen/git/file/cvs/file/src/Attic/PORTING,v 1.5 1987/11/08 23:03:41 ian Exp $
 
 Read this file only if the program doesn't compile on your system.
 
-I had hoped to be able to make a file command that
-didn't have any system-dependant #ifdefs, no special libraries,
-etc., etc. I went to some lengths to include all the non-portable
-library routines I used (getopt, str*).  Well, System V shot me down.
-They moved the definition of major() and minor() out of <sys/types.h>
-into <sys/sysmacros.h>.  So, if major isn't defined after including types.h,
-I AUTOMATICALLY include sys/sysmacros.h. ONLY if you have a system in which 
-neither types.h nor sysmacros.h defines `major' will this automatic include
-fail (I hope). On such systems, you will get a compilation
-error in trying to compile a warning message. Please do the following:
+I have tried to make a file command that doesn't need any command-line
+defines (-D) to specify what version of UNIX is in use. I do
+this by using the definitions available in the system #include
+files. For example, the lstat(2) call is normally found in
+4BSD systems, but might be grafted into some other variant
+of UNIX. If it's done right (ie., using the same definitions),
+my program will compile and work correctly. Look at the #ifdefs
+to see how it's done. 
+
+I've also tried to include all the non-portable library routines
+I used (getopt, str*).   Non-portable here means `not in every
+reasonably standard UNIX out there: V7, System V, 4BSD'.
+
+There is one area that just might cause problems. On System
+V, they moved the definition of major() and minor() out of
+<sys/types.h> into <sys/sysmacros.h>.  Hence, if major isn't
+defined after including types.h, I automatically include sys/sysmacros.h.
+This will work for 99% of the systems out there. ONLY if you
+have a system in which  neither types.h nor sysmacros.h defines
+`major' will this automatic include fail (I hope). On such
+systems, you will get a compilation error in trying to compile
+a warning message. Please do the following: 
+
        1) change the appropriate (2nd) #include at the start of 
                fsmagic.c
 and    2) let me know the name of the system, the release number,