[PATCH] Adding PROBLEMS to the Help Menu.

Many months ago the suggestion was raised that the PROBLEMS file should be included in the installation directories so that it could help users of binary packages. This patch does that and also adds it to the Help Menu as 'Known Problems'. The PROBLEMS file is also updated to clarify the stack size limitations of MacOS X. Malcolm ChangeLog addition: 2005-11-08 Malcolm Purvis <malcolmp(a)xemacs.org&gt; * Makefile.in.in: Install PROBLEMS into .../etc * PROBLEMS: Update description of MacOS X stack size limit. lisp/ChangeLog addition: 2005-11-08 Malcolm Purvis <malcolmp(a)xemacs.org&gt; * help.el: * menubar-items.el (default-menubar): Add 'Known Problems' to the Help menu. xemacs-problems source patch: Diff command: cvs -q diff -u Files affected: lisp/menubar-items.el lisp/help.el PROBLEMS Makefile.in.in Index: Makefile.in.in =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/Makefile.in.in,v retrieving revision 1.26 diff -u -r1.26 Makefile.in.in --- Makefile.in.in 2005/10/04 17:51:13 1.26 +++ Makefile.in.in 2005/11/08 12:15:18 ＠＠ -238,7 +238,7 ＠＠ ## instead, we have written out explicit code in the `install' targets. COPYDIR = ${srcdir}/etc ${srcdir}/lisp COPYDESTS = ${etcdir} ${lispdir} -GENERATED_HEADERS = src/paths.h src/Emacs.ad.h src/config.h lwlib/config.h src/sheap-adjust.h src/xemacs.def +GENERATED_HEADERS = src/paths.h src/Emacs.ad.h src/config.h lwlib/config.h src/sheap-adjust.h src/xemacs.def etc/PROBLEMS ## MAKE_SUBDIR will always be of the form lib-src ... src, where ## `...' includes various other directories that may be inserted by ＠＠ -344,6 +344,9 ＠＠ src/xemacs.def: $(srcdir)/src/xemacs.def.in.in ./config.status && touch $＠ +etc/PROBLEMS: $(srcdir)/PROBLEMS + cp $^ $＠ + ## ==================== Installation ==================== ## If we let lib-src do its own installation, that means we ＠＠ -547,6 +550,7 ＠＠ $(RM) core lisp/auto-autoloads.el* lisp/custom-load.el* $(RM) lisp/mule/auto-autoloads.el* lisp/mule/custom-load.el* $(RM) modules/auto-autoloads.el* modules/custom-load.el* + $(RM) etc/PROBLEMS ## `distclean' ## Delete all files from the current directory that are created by Index: PROBLEMS =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/PROBLEMS,v retrieving revision 1.70 diff -u -r1.70 PROBLEMS --- PROBLEMS 2005/03/10 11:49:00 1.70 +++ PROBLEMS 2005/11/08 12:15:32 ＠＠ -1387,10 +1387,10 ＠＠ *** XEmacs crashes on MacOS within font-lock, or when dealing with large compilation buffers, or in other regex applications. -The default stack size under MacOS/X is rather small (512k as opposed -to Solaris 8M), hosing the regexp code, which uses alloca() -extensively, overflowing the stack when complex regexps are used. -Workarounds: +The default stack size under MacOS/X prior to 10.3 (Panther) is rather +small (512k as opposed to Solaris 8M), hosing the regexp code, which +uses alloca() extensively, overflowing the stack when complex regexps +are used. Workarounds: 1) Increase your stack size, using `ulimit -s 8192' or a (t)csh equivalent; Index: lisp/help.el =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/help.el,v retrieving revision 1.45 diff -u -r1.45 help.el --- lisp/help.el 2005/10/10 02:45:32 1.45 +++ lisp/help.el 2005/11/08 12:15:39 ＠＠ -109,6 +109,7 ＠＠ (define-key help-map "p" 'finder-by-keyword) (define-key help-map "\C-p" 'describe-pointer) +(define-key help-map "P" 'view-xemacs-problems) (define-key help-map "q" 'help-quit) ＠＠ -840,6 +841,11 ＠＠ (interactive) (Help-find-file (expand-file-name "NEWS" data-directory))) +(defun view-xemacs-problems () + "Display known problems with XEmacs." + (interactive) + (Help-find-file (expand-file-name "PROBLEMS" data-directory))) + (defun xemacs-www-page () "Go to the XEmacs World Wide Web page." (interactive) ＠＠ -995,6 +1001,7 ＠＠ " "") " +\\[view-xemacs-problems] Known problems. \\[customize] Customize Emacs options. \\[describe-distribution] How to obtain XEmacs. \\[describe-last-error] Information about the most recent error. Index: lisp/menubar-items.el =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/lisp/menubar-items.el,v retrieving revision 1.47 diff -u -r1.47 menubar-items.el --- lisp/menubar-items.el 2005/05/10 17:35:58 1.47 +++ lisp/menubar-items.el 2005/11/08 12:15:43 ＠＠ -1559,6 +1559,7 ＠＠ ("%_Other" ["%_Current Installation Info" describe-installation :active (boundp 'Installation-string)] + ["%_Known Problems" view-xemacs-problems ] ["%_Obtaining the Latest Version" describe-distribution] ["%_No Warranty" describe-no-warranty] ["XEmacs %_License" describe-copying] -- Malcolm Purvis <malcolmp(a)xemacs.org&gt;