makedefs --grep prep, misc cleanup (TRUNK ONLY)

use makedefs --grep in Makefile.doc
call make clean in doc from make clean in top
add commented out rule to produce mdgrep.h from mdgrep.pl
macosx1.5: don't chown/chgrp for single-user install
unixmain.c: work around C90 warning for Mac-specific code, fix last fix
makedefs.c: temporarily disallow blank after control introducer until docs
 catch up
mdgrep.pl: add ALLDOCS, clean up generated file's header

util/mdgrep.pl

@@ -28,6 +28,10 @@
 # Miscellaneous
 @misc = qw/BETA/;
 
+# Meta
+@meta = qw/ALLDOCS/;	# convention: use --grep-define ALLDOCS to notate
+			# items that are conditionally available
+
 # JUNK:
 # MICRO BSD __GNUC__ NHSTDC TERMLIB __linux__ LINUX WIN32CON NO_TERMS
 # ULTRIX_PROTO TERMINFO _DCC DISPMAP OPT_DISPMAP TARGET_API_MAC_CARBON
@@ -52,9 +56,15 @@ $outfile = "mdgrep.h";
 sub start_file {
 	($rev) = ('$Revision$') =~ m/: (.*) .$/;
 	open(OUT, ">$outfile") || die "open $outfile: $!";
+# NB: Date and Revision below will be modified when mdgrep.h is written to
+# cvs - this is correct (but it means you must commit changes to mdgrep.pl
+# before generating mdgrep.h and committing that file.
 	print OUT <<E_O_M;
 /*
- * $outfile
+ * NetHack 3.5  $outfile  $Date$  $Revision$
+ * Copyright (c) Kenneth Lorber, Kensington, Maryland, 2008
+ * NetHack may be freely redistributed.  See license for details.
+ *
  * This file generated by mdgrep.pl version $rev.
  * DO NOT EDIT!  Your changes will be lost.
  */
@@ -107,6 +117,6 @@ sub gen_commands {
 &start_file;
 &gen_magic(0, @const_false);
 &gen_magic(1, @const_true);
-&gen_file(sort(@os,@win,@feature,@misc,@const_false,@const_true));
+&gen_file(sort(@os,@win,@feature,@misc,@meta,@const_false,@const_true));
 &gen_commands;
 &end_file;