summaryrefslogtreecommitdiffstats
path: root/crawl-ref/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'crawl-ref/INSTALL')
-rw-r--r--crawl-ref/INSTALL25
1 files changed, 25 insertions, 0 deletions
diff --git a/crawl-ref/INSTALL b/crawl-ref/INSTALL
index c962fd36c6..4114224a28 100644
--- a/crawl-ref/INSTALL
+++ b/crawl-ref/INSTALL
@@ -32,6 +32,7 @@ Crawl can be built with some optional features:
* Sounds
* Regular expressions
* Lua support
+* Unicode characters for the map (Unix only).
Crawl Stone Soup also uses a level compiler to compile special level
definitions; to make changes to the level compiler, you'll need the
@@ -76,6 +77,11 @@ on some Unixes.
flex and bison are optional but highly recommended. Recent versions of
byacc are also fine (edit your makefile appropriately).
+If you have ncursesw and the development headers (usually in the
+/usr/include/ncursesw directory) you can build Crawl with support for
+Unicode display characters in the map by setting UNICODE_GLYPHS = y
+in makefile.unix.
+
Building:
* cd to the source directory (you can safely ignore the dolinks.sh and
@@ -339,3 +345,22 @@ http://gnuwin32.sourceforge.net/packages/pcre.htm
On DOS you get the joy of building PCRE yourself. It's a little more
annoying than building Lua (you have to roll your own makefile), but
not by much.
+
+
+Unicode
+-------
+
+Modern Unixes may support Unicode terminals (particularly xterms). If
+you have a terminal that can display Unicode characters, and an
+ncurses library that can handle Unicode (libncursesw, and its devel
+headers), you can build Crawl to display Unicode in the map: set
+UNICODE_GLYPHS = y in makefile.unix.
+
+NOTE: You may have libncursesw, but not have the header files; check
+that you have the header files installed as well, or you'll get a lot
+of errors. Crawl expects the ncursesw headers to be in
+/usr/include/ncursesw.
+
+After compiling Crawl with Unicode support, you still need to add the
+line "char_set = unicode" in your .crawlrc to tell Crawl to use
+Unicode. \ No newline at end of file