X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=man%2Flispref%2Ftips.texi;h=0af08d0a243102b012fb32c79ba42c20a47cb224;hb=7ab64bbad77deafc3d7251761292a0edeec74bc6;hp=eb4be94fa3e36b099873e8b8570556ffccc7c559;hpb=98a6e4055a1fa624c592ac06f79287d55196ca37;p=chise%2Fxemacs-chise.git- diff --git a/man/lispref/tips.texi b/man/lispref/tips.texi index eb4be94..0af08d0 100644 --- a/man/lispref/tips.texi +++ b/man/lispref/tips.texi @@ -239,6 +239,13 @@ only for program-generated buffers.) The users will find Emacs more coherent if all libraries use the same conventions. @item +Use names starting with a space for temporary buffers (@pxref{Buffer +Names}), or at least call @code{buffer-disable-undo} on them. Otherwise +they may stay referenced by internal undo variable(s) after getting +killed. If this happens before dumping (@pxref{Building XEmacs}), this +may cause fatal error when portable dumper is used. + +@item Indent each function with @kbd{C-M-q} (@code{indent-sexp}) using the default indentation parameters. @@ -488,7 +495,7 @@ at that point. For example: @end group @end smallexample -Every function that has no documentation string (because it is use only +Every function that has no documentation string (because it is used only internally within the package it belongs to), should have instead a two-semicolon comment right before the function, explaining what the function does and how to call it properly. Explain precisely what each @@ -534,7 +541,7 @@ The indentation commands of the Lisp modes in XEmacs, such as @kbd{M-;} (@code{indent-for-comment}) and @key{TAB} (@code{lisp-indent-line}) automatically indent comments according to these conventions, depending on the number of semicolons. @xref{Comments,, -Manipulating Comments, emacs, The XEmacs Reference Manual}. +Manipulating Comments, xemacs, The XEmacs User's Manual}. @node Library Headers @section Conventional Headers for XEmacs Libraries