empserver/doc
Markus Armbruster dc58018cd7 nsc: Replace NSC_EXTRA, NSC_CONST by enum ca_dump
struct castr ca_flag NSC_EXTRA was introduced in commit 3e5c064
(v4.2.18) to permit selectors that aren't in xdump.

Flag NSC_CONST was introduced in commit 445dfec, and put to use in
commit d8422ca (both v4.3.0) to protect certain table elements that
should not be changed in customized tables.

Both flags apply only to xdump, not to other uses of struct castr,
such as conditionals.

Combining NSC_EXTRA | NSC_CONST makes no sense.

I'll shortly need a way to keep selectors out of configuration tables
for conditional selector and xdump command forward compatibility.
Doing it as a third flag would add more nonsensical combinations.

Convert the flags to a separate enum ca_dump instead:

    neither   -> CA_DUMP
    NSC_CONST -> CA_DUMP_CONST
    NSC_EXTRA -> CA_DUMP_NONE

Bonus: unlike the flags it replaces, ca_dump is not visible in xdump.

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
2017-08-06 19:59:56 +02:00
..
backups Coding style, comments, spelling... 2006-05-26 18:46:50 +00:00
bug-reports Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
CHANGES Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
CHANGES2.3 Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
CHANGES3.0 Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
CHANGES4.X Update change log timestamp for 4.3.33 2015-05-20 20:20:40 +02:00
clients-howto doc/clients-howto: Document use of bell character 2013-08-17 17:57:36 +02:00
coding docs/coding: Explain function/struct/union comment conventions 2015-12-05 12:41:15 +01:00
configuration Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
contributing doc/contributing: Fix git format-patch topic branch example 2015-12-13 10:46:58 +01:00
debugging Update doc/debugging for recent commit a9611a57 2011-07-10 21:17:01 +02:00
econfig doc/econfig: Belatedly drop paragraph on holes in tables 2015-02-01 16:53:00 +01:00
files Update for new build process. 2006-01-21 20:06:16 +00:00
pthreads Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
README doc/README: Clarify description of file coding 2013-05-25 16:20:10 +02:00
schedule New utility program empsched. 2007-07-13 16:49:13 +00:00
threads Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
unicode Put URIs and e-mail addresses in <angle brackets> 2013-05-26 09:48:16 +02:00
WACKY_IDEAS Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
WISH_LIST Import of Empire 4.2.12 2003-08-23 12:23:04 +00:00
xdump nsc: Replace NSC_EXTRA, NSC_CONST by enum ca_dump 2017-08-06 19:59:56 +02:00

    Documentation is like sex: when it is good, it is very, very good;
    and when it is bad, it is better than nothing.
        --- Dick Brandon

These files should be better than nothing:

files
	What's where.

backups
	Recommendations for how to do backups when running a game.

clients-howto
	Material useful for client writers.

troubleshooting
	Some common problems and solutions.

configuration
	How to turn options on and off, change game parameters, etc...

debugging
	Hints on debugging.

econfig
	Details about the syntax of data/econfig.

bug-reports
	What to do if you find a bug.

threads
	Dave Pare explains how lwp threads work.

pthreads
	Sasha Mikheev's notes on Empire's threading abstraction, and
	its LWP and POSIX threads implementation.

coding
	Guidelines for writing Empire code

contributing
	How to contribute to Empire

unicode
	Design and implementation of Empire's Unicode support.

CHANGES
	Revision history for all the changes that were coded in the Empire2
	project.  A much more readable version of this may be found in
	"info History" (brief) or "info Empire2" (detailed).

CHANGES2.3
	All changes since revision 2.3

CHANGES3.0
	All changes since revision 3.0

CHANGES4.X
	All changes since revision 4.0

WISH_LIST
	things which maybe should be coded sometime.

WACKY_IDEAS
	things which shouldn't be coded except possibly as an option.