GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MAKEDEFS36 (6)

NAME

makedefs - NetHack miscellaneous build-time functions

CONTENTS

Synopsis
Description
Short Commands
Long Commands
Mdgrep Functions
Author

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.
-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 FUNCTIONS section below for information on controlling the filtering operation.
--grep-showvars
  Show the name and value for each variable known to the grep option.
--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 allows 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 conditional 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 anywhere (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 detected; 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 error. Note that --undef or #undef in the NetHack(6) configuration 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)

Search for    or go to Top of page |  Section 6 |  Main Index


--> MAKEDEFS (6) 29 Apr 2010

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.