===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/file/Attic/MAINT,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- src/usr.bin/file/Attic/MAINT	1996/06/26 05:32:52	1.2
+++ src/usr.bin/file/Attic/MAINT	2006/07/18 15:03:25	1.3
@@ -1,4 +1,4 @@
-$OpenBSD: MAINT,v 1.2 1996/06/26 05:32:52 deraadt Exp $
+$OpenBSD: MAINT,v 1.3 2006/07/18 15:03:25 ian Exp $
 
 Maintenance notes:
 
@@ -18,16 +18,38 @@
 - Do not distribute changed versions.
 
 People trying to be helpful occasionally put up their hacked versions
-of the file command for FTP, then the "archie" server finds and publishes
-the hacked version, and people all over the world get copies of it.
-Within a day or two I am getting email from around the world
-asking me why "my" file command won't compile!!! Needless to say this
-detracts from the limited time I have available to work on the actual
-software.  Therefore I ask you again to please NOT distribute
-your changed version.
+of the file command for anonymous FTP, and people all over the
+world get copies of the hacked versions.  Within a day or two I am
+getting email from around the world asking me why "my" file command
+won't compile!!! Needless to say this detracts from the limited
+time I have available to work on the actual software. Therefore I
+ask you again to please NOT distribute your changed version. If
+you need to make changes, please add a patch file next to the
+distribution tar, and a README file that clearly explains what you
+are trying to fix.
 
-
 Thank you for your assistance and cooperation.
 
-Mark Moraes		Christos Zoulas
-moraes@deshaw.com	christos@deshaw.com
+Code Overview
+
+This is a rough idea of the control flow from the main program:
+
+file.c	main()
+file.c	process (called for each file)
+		printf file name
+magic.c		magic_file()
+fsmagic.c		file_fsmagic()
+				(handles statbuf modes for DEV)
+			(handles statbuf modes for executable &c.
+			reads data from file.
+funcs.c:		file_buffer()
+compress.c			file_zmagic()
+is_tar.c			file_is_tar()
+softmagic.c			file_softmagic()
+						match() - looks for match against main magic database
+ascmagic.c			file_ascmagic()
+				"unknown"
+readelf.c		file_tryelf()
+
+Christos Zoulas
+christos@astron.com