Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MAKEDEFS(6)			 Games Manual			   MAKEDEFS(6)

NAME
       makedefs	- NetHack miscellaneous	build-time functions

SYNOPSIS
       makedefs	{ -o | -d | -e | -m | -v | -p |	-q | -r	| -h | -z }

       makedefs	--input	file --output file --command

DESCRIPTION
       Makedefs	 is  a build-time tool used for	a variety of NetHack(6)	source
       file creation and modification tasks.  For historical reasons, makedefs
       takes two types of command lines.  When invoked with  a	short  option,
       the  files  operated on are determined when makedefs is compiled.  When
       invoked with a long option, the --input and --output options  are  used
       to specify the files for	the --command.	Each command is	only available
       in one of the two formats.

SHORT COMMANDS
       Upper and lower case are	both accepted for the short commands.

       -o     Generate onames.h.

       -d     Generate data.base.

       -e     Generate	dungeon.pdf.   The  input  file	 dungeon.def is	passed
	      through the same logic as	that used by the --grep	 command;  see
	      the MDGREP FUNCTIONS section below for details.

       -m     Generate monster.c.

       -v     Generate	date.h and options file. It will read dat/gitinfo.txt,
	      only if it is present, to	obtain githash=	and gitbranch=
	       info and	include	related	preprocessor #defines in date.h	file.

       -p     Generate pm.h

       -q     Generate quest.dat.

       -r     Generate the rumors file.

       -s     Generate the bogusmon , engrave and epitaphfiles.

       -h     Generate the oracles file.

       -z     Generate vis_tab.c and vis_tab.h.

LONG COMMANDS
       --debug
	      Show debugging output.

       --make [command]
	      Execute a	short command.	Command	 is  given  without  preceding
	      dash.

       --input file
	      Specify the input	file for the command (if needed).  If the file
	      is - standard input is read.

       --output	file
	      Specify  the  output  file  for the command (if needed).	If the
	      file is -	standard output	is written.

       --svs [delimiter]
	      Generate a version string	to standard output without a  trailing
	      newline.	 If specified, the delimiter is	used between each part
	      of the version string.

       --grep Filter the input file to the output file.	 See the MDGREP	 FUNC-
	      TIONS section below for information on controlling the filtering
	      operation.

       --grep-showvars
	      Show  the	name and value for each	variable known to the grep op-
	      tion.

       --grep-trace
	      Turn on debug tracing for	the grep function  (  --grep  must  be
	      specified	as well).

       --grep-define symbol
	      Force  the value of symbol to be "defined."  Symbol must already
	      be known to makedefs.

       --grep-undef symbol
	      Force the	definition of symbol to	be "undefined."	  Symbol  must
	      already be known to makedefs.

MDGREP FUNCTIONS
       The  --grep command (and	certain	other commands)	filter their input, on
       a line-by-line basis, according to control lines	embedded in the	 input
       and on information gleaned from the NetHack(6) configuration.  This al-
       lows  certain changes such as embedding platform-specific documentation
       into the	master documentation files.

       Rules:

	      -	  The default conditional state	is printing enabled.

	      -	  Any line NOT starting	with a caret (^) is either  suppressed
		  or  passed through unchanged depending on the	current	condi-
		  tional state.

	      -	  Any line starting with a caret is a control line; as	in  C,
		  zero	or more	spaces may be embedded in the line almost any-
		  where	(except	immediately  after  the	 caret);  however  the
		  caret	must be	in column 1.

	      -	  Conditionals may be nested.

	      -	  Makedefs  will exit with an error code if any	errors are de-
		  tected; processing will continue (if it  can)	 to  allow  as
		  many errors as possible to be	detected.

	      -	  Unknown  identifiers	are treated as both TRUE and as	an er-
		  ror.	Note that --undef or #undef in the NetHack(6) configu-
		  ration are different from unknown.

       Control lines:

	      ^^  a line starting with a (single) literal caret

	      ^#  a comment

	      ^?ID
		  if the ID is defined set the conditional state to TRUE

	      ^!ID
		  if the ID is not defined set the conditional state to	TRUE

	      ^:  else;	invert the conditional state

	      ^.  end the most recent conditional

AUTHOR
       The NetHack Development Team

SEE ALSO
       dgn_comp(6)

COPYRIGHT
       This file is  Copyright	(C)  Kenneth  Lorber  and  was	last  modified
       2018/04/25  (version NetHack-3.6.0:1.10).  NetHack may be freely	redis-
       tributed.  See license for details.

NETHACK				  25 May 2015			   MAKEDEFS(6)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=makedefs36&sektion=6&manpath=FreeBSD+Ports+15.0>

home | help