[Emacs-diffs] emacs/doc/lispref ChangeLog frames.texi hash.te...

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/12/25 20:04:07

Modified files:
        doc/lispref    : ChangeLog frames.texi hash.texi minibuf.texi 
                         objects.texi processes.texi 

Log message:
        * frames.texi (Resources): Describe inhibit-x-resources.
        (Size Parameters): Copyedit.
        
        * hash.texi (Creating Hash):
        * objects.texi (Hash Table Type): Document the new hash table
        printed representation.
        
        * minibuf.texi (Basic Completion): 4th arg to all-completions is
        obsolete.
        
        * processes.texi (Process Buffers): Document
        process-kill-buffer-query-function.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.351&r2=1.352
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/frames.texi?cvsroot=emacs&r1=1.37&r2=1.38
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/hash.texi?cvsroot=emacs&r1=1.5&r2=1.6
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/minibuf.texi?cvsroot=emacs&r1=1.26&r2=1.27
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/objects.texi?cvsroot=emacs&r1=1.20&r2=1.21
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/processes.texi?cvsroot=emacs&r1=1.26&r2=1.27

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.351
retrieving revision 1.352
diff -u -b -r1.351 -r1.352
--- ChangeLog   5 Dec 2009 03:07:26 -0000       1.351
+++ ChangeLog   25 Dec 2009 20:04:07 -0000      1.352
@@ -1,3 +1,18 @@
+2009-12-25  Chong Yidong  <address@hidden>
+
+       * frames.texi (Resources): Describe inhibit-x-resources.
+       (Size Parameters): Copyedit.
+
+       * hash.texi (Creating Hash):
+       * objects.texi (Hash Table Type): Document the new hash table
+       printed representation.
+
+       * minibuf.texi (Basic Completion): 4th arg to all-completions is
+       obsolete.
+
+       * processes.texi (Process Buffers): Document
+       process-kill-buffer-query-function.
+
 2009-12-05  Glenn Morris  <address@hidden>
 
        * hooks.texi (Standard Hooks): Remove diary-display-hook, replaced by

Index: frames.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/frames.texi,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -b -r1.37 -r1.38
--- frames.texi 11 Oct 2009 00:07:05 -0000      1.37
+++ frames.texi 25 Dec 2009 20:04:07 -0000      1.38
@@ -610,15 +610,15 @@
 parameters @code{top} and @code{left}.
 
 @item fullscreen
-Specify that width, height or both shall be maximized.
-The value @code{fullwidth} specifies that width shall be as wide as possible.
+Specify that width, height or both shall be maximized.  The value
address@hidden specifies that width shall be as wide as possible.
 The value @code{fullheight} specifies that height shall be as tall as
-possible.  The value @code{fullboth} specifies that both the
-width and the height shall be set to the size of the screen.
-The value @code{maximized} specifies that the frame shall be maximized.
-The difference between @code{maximized} and @code{fullboth} is that
-the first does have window manager decorations but the second does not
-and thus really covers the whole screen.
+possible.  The value @code{fullboth} specifies that both the width and
+the height shall be set to the size of the screen.  The value
address@hidden specifies that the frame shall be maximized.  The
+difference between @code{maximized} and @code{fullboth} is that the
+former still has window manager decorations while the latter really
+covers the whole screen.
 @end table
 
 @node Layout Parameters
@@ -2166,6 +2166,11 @@
 @node Resources
 @section X Resources
 
+This section describes some of the functions and variables for
+querying and using X resources, or their equivalent on your operating
+system.  @xref{X Resources,, X Resources, emacs, The GNU Emacs
+Manual}, for more information about X resources.
+
 @defun x-get-resource attribute class &optional component subclass
 The function @code{x-get-resource} retrieves a resource value from the X
 Window defaults database.
@@ -2219,7 +2224,11 @@
 @end group
 @end example
 
-  @xref{X Resources,, X Resources, emacs, The GNU Emacs Manual}.
address@hidden inhibit-x-resources
+If this variable is address@hidden, Emacs does not look up X
+resources, and X resources do not have any effect when creating new
+frames.
address@hidden defvar
 
 @node Display Feature Testing
 @section Display Feature Testing

Index: hash.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/hash.texi,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- hash.texi   10 Jul 2009 05:03:30 -0000      1.5
+++ hash.texi   25 Dec 2009 20:04:07 -0000      1.6
@@ -30,18 +30,13 @@
 @end itemize
 
   Emacs Lisp provides a general-purpose hash table data type, along
-with a series of functions for operating on them.  Hash tables have no
-read syntax, and print in hash notation, like this:
-
address@hidden
-(make-hash-table)
-     @result{} #<hash-table 'eql nil 0/65 0x83af980>
address@hidden example
-
address@hidden
-(The term ``hash notation'' refers to the initial @samp{#}
address@hidden Representation}---and has nothing to do with
-the term ``hash table.'')
+with a series of functions for operating on them.  Hash tables have a
+special printed representation, which consists of @samp{#s} followed
+by a list specifying the hash table properties and contents.
address@hidden Hash}.  (Note that the term ``hash notation'', which
+refers to the initial @samp{#} character used in the printed
+representations of objects with no read representation, has nothing to
+do with the term ``hash table''.  @xref{Printed Representation}.)
 
   Obarrays are also a kind of hash table, but they are a different type
 of object and are used only for recording interned symbols
@@ -164,6 +159,35 @@
 This function is obsolete. Use @code{make-hash-table} instead.
 @end defun
 
+You can also create a new hash table using the printed representation
+for hash tables.  The Lisp reader can read this printed
+representation, provided each element in the specified hash table has
+a valid read syntax (@pxref{Printed Representation}).  For instance,
+the following specifies a new hash table containing the keys
address@hidden and @code{key2} (both symbols) associated with @code{val1}
+(a symbol) and @code{300} (a number) respectively.
+
address@hidden
+#s(hash-table size 30 data (key1 val1 key2 300))
address@hidden example
+
address@hidden
+The printed representation for a hash table consists of @samp{#s}
+followed by a list beginning with @samp{hash-table}.  The rest of the
+list should consist of zero or more property-value pairs specifying
+the hash table's properties and initial contents.  The properties and
+values are read literally.  Valid property names are @code{size},
address@hidden, @code{weakness}, @code{rehash-size},
address@hidden, and @code{data}.  The @code{data} property
+should be a list of key-value pairs for the initial contents; the
+other properties have the same meanings as the matching
address@hidden keywords (@code{:size}, @code{:test}, etc.),
+described above.
+
+Note that you cannot specify a hash table whose initial contents
+include objects that have no read syntax, such as buffers and frames.
+Such objects may be added to the hash table after it is created.
+
 @node Hash Access
 @section Hash Table Access
 

Index: minibuf.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/minibuf.texi,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- minibuf.texi        2 Nov 2009 02:30:04 -0000       1.26
+++ minibuf.texi        25 Dec 2009 20:04:07 -0000      1.27
@@ -769,10 +769,11 @@
 @var{string}.  The arguments to this function (aside from
 @var{nospace}) are the same as those of @code{try-completion}.  Also,
 this function uses @code{completion-regexp-list} in the same way that
address@hidden does.  The optional argument @var{nospace} only
-matters if @var{string} is the empty string.  In that case, if
address@hidden is address@hidden, completions that start with a space
-are ignored.
address@hidden does.
+
+The optional argument @var{nospace} is obsolete.  If it is
address@hidden, completions that start with a space are ignored unless
address@hidden starts with a space.
 
 If @var{collection} is a function, it is called with three arguments:
 @var{string}, @var{predicate} and @code{t}; then @code{all-completions}

Index: objects.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/objects.texi,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -b -r1.20 -r1.21
--- objects.texi        13 Aug 2009 18:08:25 -0000      1.20
+++ objects.texi        25 Dec 2009 20:04:07 -0000      1.21
@@ -1219,14 +1219,18 @@
 
     A hash table is a very fast kind of lookup table, somewhat like an
 alist in that it maps keys to corresponding values, but much faster.
-Hash tables have no read syntax, and print using hash notation.
address@hidden Tables}, for functions that operate on hash tables.
+The printed representation of a hash table specifies its properties
+and contents, like this:
 
 @example
 (make-hash-table)
-     @result{} #<hash-table 'eql nil 0/65 0x83af980>
+     @result{} #s(hash-table size 65 test eql rehash-size 1.5
+                             rehash-threshold 0.8 data ())
 @end example
 
address@hidden
address@hidden Tables}, for more information about hash tables.
+
 @node Function Type
 @subsection Function Type
 

Index: processes.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/processes.texi,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- processes.texi      27 Aug 2009 04:24:02 -0000      1.26
+++ processes.texi      25 Dec 2009 20:04:07 -0000      1.27
@@ -1161,6 +1161,14 @@
 updated to point to the end of the text just inserted.  Usually, but not
 always, the @code{process-mark} is at the end of the buffer.
 
address@hidden process-kill-buffer-query-function
+  Killing the associated buffer of a process also kills the process.
+Emacs asks for confirmation first, if the process's
address@hidden is address@hidden (@pxref{Query
+Before Exit}).  This confirmation is done by the function
address@hidden, which is run from
address@hidden (@pxref{Killing Buffers}).
+
 @defun process-buffer process
 This function returns the associated buffer of the process
 @var{process}.