Reformatted.

[chise/xemacs-chise.git.1] / man / lispref / building.texi

diff --git a/man/lispref/building.texi b/man/lispref/building.texi
index f7d0dc6..414ab0a 100644 (file)
--- a/man/lispref/building.texi
+++ b/man/lispref/building.texi
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 @c This is part of the XEmacs Lisp Reference Manual.
 @c -*-texinfo-*-
 @c This is part of the XEmacs Lisp Reference Manual.

-@c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. 
+@c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.

 @c See the file lispref.texi for copying conditions.
 @setfilename ../../info/building.info
 @node Building XEmacs and Object Allocation, Standard Errors, Tips, Top
 @c See the file lispref.texi for copying conditions.
 @setfilename ../../info/building.info
 @node Building XEmacs and Object Allocation, Standard Errors, Tips, Top

@@ -127,10 +127,14 @@ most emphatically @emph{not} call this yourself; it will reinitialize
 your XEmacs process and you'll be sorry.
 @end defun
 
 your XEmacs process and you'll be sorry.
 @end defun
 

-@deffn Command emacs-version
+@deffn Command emacs-version &optional arg

   This function returns a string describing the version of XEmacs that is
 running.  It is useful to include this string in bug reports.
 
   This function returns a string describing the version of XEmacs that is
 running.  It is useful to include this string in bug reports.
 

+When called interactively with a prefix argument, insert string at point.
+Don't use this function in programs to choose actions according
+to the system configuration; look at @code{system-configuration} instead.
+

 @example
 @group
 (emacs-version)
 @example
 @group
 (emacs-version)

@@ -150,7 +154,7 @@ local site.
 @example
 @group
 emacs-build-time "Mon Apr  7 20:28:52 1997"
 @example
 @group
 emacs-build-time "Mon Apr  7 20:28:52 1997"

-     @result{} 
+     @result{}

 @end group
 @end example
 @end defvar
 @end group
 @end example
 @end defvar

@@ -205,10 +209,7 @@ vectors and cons cells.  It does not make copies of other objects such
 as symbols, but just returns them unchanged.  It signals an error if
 asked to copy markers.
 
 as symbols, but just returns them unchanged.  It signals an error if
 asked to copy markers.
 

-This function is a no-op except while XEmacs is being built and dumped;
-it is usually called only in the file
-@file{xemacs/lisp/prim/loaddefs.el}, but a few packages call it just in
-case you decide to preload them.
+This function is a no-op in XEmacs, and its use in new code is deprecated.

 @end defun
 
 @defvar pure-bytes-used
 @end defun
 
 @defvar pure-bytes-used

@@ -310,7 +311,7 @@ information:
  (@var{used-syms} . @var{free-syms})
 @end group
  (@var{used-markers} . @var{free-markers})
  (@var{used-syms} . @var{free-syms})
 @end group
  (@var{used-markers} . @var{free-markers})

- @var{used-string-chars} 
+ @var{used-string-chars}

  @var{used-vector-slots}
  (@var{plist}))
 
  @var{used-vector-slots}
  (@var{plist}))
 

@@ -358,8 +359,8 @@ command-builder-storage 120 devices-used 2 device-storage 344
 frames-used 3 frame-storage 624 image-instances-used 47
 image-instance-storage 3008 windows-used 27 windows-freed 2
 window-storage 9180 lcrecord-lists-used 15
 frames-used 3 frame-storage 624 image-instances-used 47
 image-instance-storage 3008 windows-used 27 windows-freed 2
 window-storage 9180 lcrecord-lists-used 15

-lcrecord-list-storage 360 hashtables-used 631
-hashtable-storage 25240 streams-used 1 streams-on-free-list 3
+lcrecord-list-storage 360 hash-tables-used 631
+hash-table-storage 25240 streams-used 1 streams-on-free-list 3

 streams-freed 12 stream-storage 91))
 @end group
 @end example
 streams-freed 12 stream-storage 91))
 @end group
 @end example

@@ -436,6 +437,7 @@ not apply if XEmacs was configured with @samp{--debug}.  Therefore, be
 careful when setting @code{gc-cons-threshold} in that case!)
 @end defopt
 
 careful when setting @code{gc-cons-threshold} in that case!)
 @end defopt
 

+@ignore

 @c Emacs 19 feature
 @defun memory-limit
 This function returns the address of the last byte XEmacs has allocated,
 @c Emacs 19 feature
 @defun memory-limit
 This function returns the address of the last byte XEmacs has allocated,

@@ -445,6 +447,7 @@ Lisp integer.
 You can use this to get a general idea of how your actions affect the
 memory usage.
 @end defun
 You can use this to get a general idea of how your actions affect the
 memory usage.
 @end defun

+@end ignore

 
 @defvar pre-gc-hook
 This is a normal hook to be run just before each garbage collection.
 
 @defvar pre-gc-hook
 This is a normal hook to be run just before each garbage collection.