Mercurial > hg > xemacs-beta
diff man/internals/internals.texi @ 298:70ad99077275 r21-0b47
Import from CVS: tag r21-0b47
author | cvs |
---|---|
date | Mon, 13 Aug 2007 10:39:40 +0200 |
parents | c42ec1d1cded |
children | afd57c14dfc8 |
line wrap: on
line diff
--- a/man/internals/internals.texi Mon Aug 13 10:38:47 2007 +0200 +++ b/man/internals/internals.texi Mon Aug 13 10:39:40 2007 +0200 @@ -1695,11 +1695,12 @@ the @file{temacs} phase. @cindex copy-on-write - @strong{Note:} This kludge only works on a few systems nowadays, and is -rapidly becoming irrelevant because most modern operating systems provide -@dfn{copy-on-write} semantics. All data is initially shared between -processes, and a private copy is automatically made (on a page-by-page -basis) when a process first attempts to write to a page of memory. + @strong{Please note:} This kludge only works on a few systems +nowadays, and is rapidly becoming irrelevant because most modern +operating systems provide @dfn{copy-on-write} semantics. All data is +initially shared between processes, and a private copy is automatically +made (on a page-by-page basis) when a process first attempts to write to +a page of memory. Formerly, there was a requirement that static variables not be declared inside of functions. This had to do with another hack along @@ -1984,15 +1985,15 @@ @code{obarray} to a different value [although this is likely to make XEmacs crash!].) - @strong{Note:} It is potentially deadly if you declare a @samp{Q...} -variable in two different modules. The two calls to @code{defsymbol()} -are no problem, but some linkers will complain about multiply-defined -symbols. The most insidious aspect of this is that often the link will -succeed anyway, but then the resulting executable will sometimes crash -in obscure ways during certain operations! To avoid this problem, -declare any symbols with common names (such as @code{text}) that are not -obviously associated with this particular module in the module -@file{general.c}. + @strong{Please note:} It is potentially deadly if you declare a +@samp{Q...} variable in two different modules. The two calls to +@code{defsymbol()} are no problem, but some linkers will complain about +multiply-defined symbols. The most insidious aspect of this is that +often the link will succeed anyway, but then the resulting executable +will sometimes crash in obscure ways during certain operations! To +avoid this problem, declare any symbols with common names (such as +@code{text}) that are not obviously associated with this particular +module in the module @file{general.c}. Global variables whose names begin with @samp{V} are variables that contain Lisp objects. The convention here is that all global variables @@ -2048,7 +2049,7 @@ To get started debugging XEmacs, take a look at the @file{gdbinit} and @file{dbxrc} files in the @file{src} directory. -@xref{Q2.1.15: How to Debug an XEmacs problem with a debugger,,, +@xref{Q2.1.15 - How to Debug an XEmacs problem with a debugger,,, xemacs-faq, XEmacs FAQ}. @@ -4326,9 +4327,9 @@ consequently should be the most heavily nested sub-object, such as a long list.) -@strong{Note}: When the mark method is called, garbage collection -is in progress, and special precautions need to be taken -when accessing objects; see section (B) above. +@strong{Please note:} When the mark method is called, garbage collection +is in progress, and special precautions need to be taken when accessing +objects; see section (B) above. If your mark method does not need to do anything, it can be @code{NULL}.