From b40ee659b4b7803237885ad06f0b45a65498d19f Mon Sep 17 00:00:00 2001 From: dshaligram Date: Sun, 10 Jun 2007 10:09:50 +0000 Subject: Updated CREDITS, INSTALL. git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@1569 c06c8d41-db1a-0410-9941-cceddc491573 --- crawl-ref/INSTALL | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) (limited to 'crawl-ref/INSTALL') diff --git a/crawl-ref/INSTALL b/crawl-ref/INSTALL index 4114224a28..45ed8d287f 100644 --- a/crawl-ref/INSTALL +++ b/crawl-ref/INSTALL @@ -50,6 +50,12 @@ Lua support requires liblua, which you can build by downloading the sources from www.lua.org. On most Unixes, you can also use the native package management system to easily install lua. +Unicode support needs libncursesw and its header files; these are +usually available in your operating system's package-management +system. Unicode is not supported on Windows or DOS. Some systems, such +as Mac OS X, may have Unicode support available in libncurses itself +(i.e., without a separate libncursesw). + Makefile system --------------- @@ -347,8 +353,8 @@ annoying than building Lua (you have to roll your own makefile), but not by much. -Unicode -------- +Unicode (Unix only) +------------------- Modern Unixes may support Unicode terminals (particularly xterms). If you have a terminal that can display Unicode characters, and an @@ -356,6 +362,10 @@ 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. +On Mac OS X, libncurses includes Unicode support; makefile.unix should +detect Mac OS automatically and link to libncurses when +UNICODE_GLYPHS=y. + 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 @@ -363,4 +373,13 @@ of errors. Crawl expects the ncursesw headers to be in 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 +Unicode. You may also need to set the locale in your terminal (notably +on Mac OS) if the encoding does not default to UTF-8. To check this, +run "locale charmap", which should say "UTF-8". If your encoding is +not UTF-8, you can force it to UTF-8 on most systems by doing "export +LC_ALL=en_US.UTF-8" or the equivalent, depending on your language +locale and what shell you're using. + +If you're playing Crawl on a remote machine, the character encoding +needs to be UTF-8 on the server, *and* your local terminal (where +you're running telnet/ssh) needs to be able to decode UTF-8. \ No newline at end of file -- cgit v1.2.3-54-g00ecf