From 7a49705a9326a5ded52a51e70fe1d9b2b7260b40 Mon Sep 17 00:00:00 2001
From: "nethack.rankin" <nethack.rankin>
Date: Sat, 23 Sep 2006 05:34:38 +0000
Subject: [PATCH] symbols documentation (trunk only)

     A first cut at adding some user-level documentation to dat/symbols.
It should probably include a brief example (not verbose description) of
how to specify values in the various supported formats (decimal, octal,
hexadecimal, simple string, string including escape sequeces?).  Perhaps
a pointer to the Guidebook too. :-}
---
 dat/symbols | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/dat/symbols b/dat/symbols
index c30f6b2c7..5594da5dc 100644
--- a/dat/symbols
+++ b/dat/symbols
@@ -1,3 +1,17 @@
+# Symbol sets for use in NetHack's text-based display.
+#
+# IBMgraphics works by specifying special characters which reside
+# outside the range of normal printable characters.  It has subsets
+# for use where the internal code page is different than the one
+# used by US ASCII (437) and has some different special characters.
+#
+# DECgraphics works by switching back and forth between two fonts,
+# where the alternate one substitutes special characters in place
+# of ordinary printable characters in the lowercase letter range.
+# NetHack encodes the request to use the alternate font here by
+# having the high bit set (in hexadecimal, \x80 is combined with
+# a character code between \x60 and \x7f).
+
 start: DECgraphics
 	Handling: DEC
 	S_vwall: \xf8			# meta-x, vertical rule
-- 
2.40.0