diff man/lispref/hash-tables.texi @ 4820:e6dec75ded0e

Use keywords, not ordinary symbols, in the structure syntax for hash tables. lisp/ChangeLog addition: 2010-01-09 Aidan Kehoe <kehoea@parhasard.net> * descr-text.el (describe-char-unihan-field-descriptions): * cl-macs.el: Use keywords, not ordinary symbols, in the hash table read syntax, for compatibility with Common Lisp and recent GNU Emacs. man/ChangeLog addition: 2010-01-09 Aidan Kehoe <kehoea@parhasard.net> * lispref/objects.texi (Hash Table Type): * lispref/hash-tables.texi (Introduction to Hash Tables): Use keywords, not ordinary symbols, in the hash table read syntax; document that we do accept the ordinary symbols for the sake of backward-compatiblity. 2010-01-09 Aidan Kehoe <kehoea@parhasard.net> * elhash.c: (print_hash_table, print_hash_table_data) (hash_table_instantiate) (structure_type_create_hash_table_structure_name): (syms_of_elhash): Use keywords, not ordinary symbols, in the hash table read syntax, for compatibility with Common Lisp and recent GNU Emacs. Accept the non-keyword syntax, but don't allow mixing of the two styles.
author Aidan Kehoe <kehoea@parhasard.net>
date Sat, 09 Jan 2010 17:28:51 +0000
parents abe6d1db359e
children 71ee43b8a74d
line wrap: on
line diff
--- a/man/lispref/hash-tables.texi	Sat Jan 09 17:35:51 2010 +0100
+++ b/man/lispref/hash-tables.texi	Sat Jan 09 17:28:51 2010 +0000
@@ -65,12 +65,15 @@
 Hash tables can also be created by the lisp reader using structure
 syntax, for example:
 @example
-#s(hash-table size 20 data (foo 1 bar 2))
+#s(hash-table :size 20 :data (foo 1 bar 2))
 @end example
 
-The structure syntax accepts the same keywords as @code{make-hash-table}
-(without the @code{:} character), as well as the additional keyword
-@code{data}, which specifies the initial hash table contents.
+The structure syntax accepts the same keywords as
+@code{make-hash-table}, as well as the additional keyword @code{data},
+which specifies the initial hash table contents.  Older versions of
+XEmacs required that the keywords not have the initial ``:'' in the
+structure syntax, and this version of XEmacs still supports that syntax,
+but you cannot mix the two styles within one structure.
 
 @defun make-hash-table &key @code{test} @code{size} @code{rehash-size} @code{rehash-threshold} @code{weakness}
 This function returns a new empty hash table object.