Mercurial > hg > xemacs-beta
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