[xemacs-hg @ 2001-05-31 12:45:27 by ben] xemacs-faq.texi: Major rewrite. Update all MS Windows info to current. Redo section 6.1 almost completely. Incorporate sections 1 and 2 of Hrvoje's FAQ. etags.el: Fix infloop when going up to the root. s\cygwin32.h: Don't unilaterally include ntplay, but only when we're compiling with native sound (look in configure now). event-msw.c: Fix yet more problems with C-g handling. Implement debug-mswindows-events. event-stream.c, events.h, signal.c, sysdep.h: Rearrange the signal-handling code to eliminate the former spaghetti logic paths in it. Document clearly what "low-level" and "high-level" timeouts are. Rename some functions with unclear names (e.g. "...alarm...") to names that reflect what they actually do (e.g. "...async_timeout..."). Fix numerous bugs discovered in the process. console-x.h, event-Xt.c, event-msw.c, frame-x.c: Hopefully make XEmacs properly maintain the "iconified" state on frames at all times. This should fix the "can't delete a frame with C-x 5 0 when there's another iconified frame out there" bug. Put a notice in of further changes that should probably be made to clean up the frame-visibility support. (especially directed at Jan Vroonhof) lisp.h, miscplay.c: Rename SBufbyte to CBufbyte to avoid a misleading name. Eliminate UChar, which is not used anywhere and contributes no semantic info. Add a comment about the documentation-only properties of the char/unsigned char typedefs. Add SChar_Binary as an explicitly `signed' version of Char_Binary and put back the `signed' declarations in miscplay.c. alloc.c: Use char typedefs. console-msw.c, device-msw.c, dialog-msw.c, editfns.c, fileio.c, glyphs-eimage.c, menubar-msw.c, ntplay.c, objects-msw.c, realpath.c, redisplay-msw.c, select-msw.c, syswindows.h, win32.c: Eliminate numerous C++ errors. frame-msw.c: Eliminate numerous C++ errors and Mule-ize. glyphs-msw.c: Eliminate numerous C++ errors and use char typedefs. configure.in: Fix problems detecting both native and Linux sound on Cygwin when compiled with --with-msw=no. Rearrange file-coding handling a bit to avoid warning when compiling with Mule. configure.in, configure.usage, INSTALL: Document XEMACS_CC and corresponding compiler option --xemacs-compiler. Explain how to build xemacs using a C++ compiler.

--- a/src/lisp.h	Thu May 31 12:03:39 2001 +0000
+++ b/src/lisp.h	Thu May 31 12:45:41 2001 +0000
@@ -318,18 +318,20 @@
    be interpreted as text. [A fifth possible type "e) a general pointer
    to memory" should be replaced with void *.]  Using these more specific
    types rather than the general ones helps avoid the confusions that
-   occur when the semantics of a char * argument being studied are unclear. */
-
-typedef unsigned char UChar;
+   occur when the semantics of a char * argument being studied are unclear.
+
+   Note that these typedefs are purely for documentation purposes; from
+   the C code's perspective, they are exactly equivalent to `char *',
+   `unsigned char *', etc., so you can freely use them with library
+   functions declared as such. */
 
 /* The data representing the text in a buffer is logically a set
    of Bufbytes, declared as follows. */
 
-typedef UChar Bufbyte;
-
-/* Explicitly signed or unsigned versions: */
-typedef UChar UBufbyte;
-typedef char  SBufbyte;
+typedef unsigned char Bufbyte;
+/* The following should only be used when you have to apply a stdlib
+   string function to internal data */
+typedef char CBufbyte;
 
 /* The data representing a string in "external" format (binary or any
    external encoding) is logically a set of Extbytes, declared as
@@ -341,13 +343,14 @@
 
 /* A byte in a string in binary format: */
 typedef char Char_Binary;
-typedef UChar UChar_Binary;
+typedef signed char SChar_Binary;
+typedef unsigned char UChar_Binary;
 
 /* A byte in a string in entirely US-ASCII format: (Nothing outside
  the range 00 - 7F) */
 
 typedef char Char_ASCII;
-typedef UChar UChar_ASCII;
+typedef unsigned char UChar_ASCII;
 
 
 /* To the user, a buffer is made up of characters, declared as follows.
@@ -2361,7 +2364,8 @@
 extern int find_file_use_truenames;
 
 /* Defined in bytecode.c */
-DOESNT_RETURN invalid_byte_code (const char *reason, Lisp_Object frob);
+DECLARE_DOESNT_RETURN (invalid_byte_code
+		       (const char *reason, Lisp_Object frob));
 
 /* Defined in callproc.c */
 char *egetenv (const char *);