changeset 1549:bc9eadea35cf

[xemacs-hg @ 2003-06-30 09:30:58 by stephent] doc improvements <87isqn9aly.fsf@tleepslib.sk.tsukuba.ac.jp> <8765mo9cmp.fsf@tleepslib.sk.tsukuba.ac.jp>
author stephent
date Mon, 30 Jun 2003 09:31:01 +0000
parents 5365af805d4c
children 6e7ace1ab32d
files man/ChangeLog man/lispref/lists.texi man/lispref/objects.texi man/xemacs-faq.texi
diffstat 4 files changed, 52 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/man/ChangeLog	Mon Jun 30 09:24:47 2003 +0000
+++ b/man/ChangeLog	Mon Jun 30 09:31:01 2003 +0000
@@ -1,3 +1,17 @@
+2003-06-30  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* xemacs-faq.texi (Q3.2.2): Fix typo.
+
+2003-06-20  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* lispref/objects.texi (Character Type): Document ?\x00 read
+	syntax and range limitations on ?\000 and ?\x00 read syntaxes.
+
+2003-06-16  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* lispref/lists.texi (List-related Predicates): Document
+	`true-list-p', and reference it from `listp'.
+
 2003-06-01  Steve Youngs  <youngs@xemacs.org>
 
 	* XEmacs 21.5.14 "cassava" is released.
--- a/man/lispref/lists.texi	Mon Jun 30 09:24:47 2003 +0000
+++ b/man/lispref/lists.texi	Mon Jun 30 09:31:01 2003 +0000
@@ -170,7 +170,8 @@
 
 @defun listp object
 This function returns @code{t} if @var{object} is a cons cell or
-@code{nil}.  Otherwise, it returns @code{nil}.
+@code{nil}.  Otherwise, it returns @code{nil}.  @code{true-list-p} is
+slower, but in some circumstances it is more appropriate.
 
 @example
 @group
@@ -193,6 +194,11 @@
 @end example
 @end defun
 
+@defun true-list-p object
+This function returns @code{t} if @var{object} is an acyclic,
+@code{nil}-terminated (ie, not dotted), list.  Otherwise it returns
+@code{nil}.  @code{listp} is faster.
+
 @defun null object
 This function returns @code{t} if @var{object} is @code{nil}, and
 returns @code{nil} otherwise.  This function is identical to @code{not},
--- a/man/lispref/objects.texi	Mon Jun 30 09:24:47 2003 +0000
+++ b/man/lispref/objects.texi	Mon Jun 30 09:31:01 2003 +0000
@@ -613,24 +613,48 @@
 @cindex @samp{\} in character constant
 @cindex backslash in character constant
 @cindex octal character code
-  Finally, the most general read syntax consists of a question mark
+@cindex hexadecimal character code
+  Finally, there are two read syntaxes involving character codes.
+It is not possible to represent multibyte or wide characters in this
+way; the permissible range of codes is from 0 to 255 (@emph{i.e.},
+@samp{0377} octal or @samp{0xFF} hexadecimal).  If you wish to convert
+code points to other characters, you must use the @samp{make-char} or
+@samp{unicode-to-char} primitives in Mule.  (Non-Mule XEmacsen cannot
+represent codes out of that range at all, although you can set the font
+to a registry other than ISO 8859/1 to get the appearance of a greater
+range of characters.)  Although these syntaxes can represent any
+@sc{ascii} or Latin-1 character, they are preferred only when the
+precise integral value is more important than the @sc{ascii}
+representation.
+
+  The first consists of a question mark
 followed by a backslash and the character code in octal (up to three
 octal digits); thus, @samp{?\101} for the character @kbd{A},
 @samp{?\001} for the character @kbd{C-a}, and @code{?\002} for the
-character @kbd{C-b}.  Although this syntax can represent any @sc{ascii}
-character, it is preferred only when the precise octal value is more
-important than the @sc{ascii} representation.
+character @kbd{C-b}.
+
+  The second consists of a question mark followed by a backslash, the
+character @samp{x}, and the character code in hexadecimal (up to two
+hexadecimal digits); thus, @samp{?\x41} for the character @kbd{A},
+@samp{?\x1} for the character @kbd{C-a}, and @code{?\x2} for the
+character @kbd{C-b}.
+
+In both cases, the reader will finalize the character when a non-digit
+is encountered or the maximum length of a character code is reached.  It
+then starts reading the next token.
 
 @example
 @group
 ;; @r{Under XEmacs 20:}
 ?\012 @result{} ?\n        ?\n @result{} ?\n        ?\C-j @result{} ?\n
-?\101 @result{} ?A         ?A @result{} ?A
+?\101 @result{} ?A         ?A @result{} ?A          ?\x0A @result{} ?\n
+?\x41 @result{} ?A     '(?\xAZ) @result{} '(?\n Z)  '(?\0123) @result{} (?\n 3)
 @end group
 @group
 ;; @r{Under XEmacs 19:}
 ?\012 @result{} 10         ?\n @result{} 10         ?\C-j @result{} 10
 ?\101 @result{} 65         ?A @result{} 65
+;; ?\x41 @r{is a syntax error.}
 @end group
 @end example
 
--- a/man/xemacs-faq.texi	Mon Jun 30 09:24:47 2003 +0000
+++ b/man/xemacs-faq.texi	Mon Jun 30 09:31:01 2003 +0000
@@ -7,7 +7,7 @@
 @finalout
 @titlepage
 @title XEmacs FAQ
-@subtitle Frequently asked questions about XEmacs @* Last Modified: $Date: 2003/05/22 07:41:21 $
+@subtitle Frequently asked questions about XEmacs @* Last Modified: $Date: 2003/06/30 09:30:58 $
 @sp 1
 @author Tony Rossini <rossini@@biostat.washington.edu>
 @author Ben Wing <ben@@xemacs.org>
@@ -3013,7 +3013,7 @@
 This is confusing because @samp{default} and @samp{modeline} are face
 names, and can be found listed with all faces in the current mode by
 using @kbd{M-x set-face-font (enter) ?}.  They use the face-specific
-resource @samp{attributeFont}
+resource @samp{attributeFont}.
 
 On the other hand, @samp{menubar} is a normal X thing that uses the
 resource @samp{font}.  With Motif it @emph{may be} necessary to use