Anonymous avatar Anonymous committed a56d080

2003-06-01 Steve Youngs <youngs@xemacs.org>;

* Sync to upstream version 4.5.1.

* Makefile (AUTHOR_VERSION): Bump.

2003-05-31 Steve Youngs <youngs@xemacs.org>;

* man/x-symbol.texi (FAQ Additional Spaces): Fix xref.

* Makefile (DATA_4_FILES): Remove.
(DATA_4_DEST): Remove.
(EXTRA_DOC_FILES): New, use instead of DATA_4_*.
Fixes problem of some tar programs barfing on '../' in the
tarball.

Comments (0)

Files changed (11)

+2003-06-01  Steve Youngs  <youngs@xemacs.org>
+
+	* Sync to upstream version 4.5.1.
+
+	* Makefile (AUTHOR_VERSION): Bump.
+
+2003-05-31  Steve Youngs  <youngs@xemacs.org>
+
+	* man/x-symbol.texi (FAQ Additional Spaces): Fix xref.
+
+	* Makefile (DATA_4_FILES): Remove.
+	(DATA_4_DEST): Remove.
+	(EXTRA_DOC_FILES): New, use instead of DATA_4_*.
+	Fixes problem of some tar programs barfing on '../' in the
+	tarball. 
+
 2003-04-22  Norbert Koch  <viteno@xemacs.org>
 
 	* Makefile (VERSION): XEmacs package 1.04 released.

ChangeLog.upstream

+2003-05-12  Christoph Wedler  <wedler@users.sourceforge.net>
+
+	* X-Symbol 4.5.1-beta.
+
+ * Bug fix: unique decoding would not be unique for TeX
+   accents starting with \c, \k, \v, \u, \H, \r.
+ * Bug fix, Emacs-21.2: Makefile.emacs would not work,
+   variable `image-types' is not defined in -batch Emacs.
+ * Emacs-21.3.50: Would not work with with default value
+   nil for `x-symbol-emacs-has-correct-find-safe-coding'.
+ * Emacs: would issue a warning with value "ASCII" for
+   `current-language-environment'.
+ * Don't provide Emacs bug workaround for images with
+   Emacs-21.3.50.  I want to know why it's necessary, i.e.,
+   write an Emacs bug report...
+ * New variable `x-symbol-set-coding-system-if-undecided'
+   for Emacs, defaults to t.
+
+	Report from Andreas Klein, Eli Tziperman.
+
 2003-03-14  Christoph Wedler  <wedler@users.sourceforge.net>
 
 	* X-Symbol 4.5-beta.
 # Boston, MA 02111-1307, USA.
 
 VERSION = 1.04
-AUTHOR_VERSION = 4.5
+AUTHOR_VERSION = 4.5.1
 MAINTAINER = Steve Youngs <youngs@xemacs.org>
 PACKAGE = x-symbol
 PKG_TYPE = regular
 DATA_3_FILES = pcf/*.pcf pcf/fonts.dir
 DATA_3_DEST = $(PACKAGE)/pcf
 
-# Hack to put extra doc sources into xemacs-packages/man/x-symbol/
-DATA_4_FILES = man/$(PACKAGE).css man/$(PACKAGE).init man/Makefile.upstream \
+EXPLICIT_DOCS = man/x-symbol.texi
+
+EXTRA_DOC_FILES = man/$(PACKAGE).css man/$(PACKAGE).init man/Makefile.upstream \
 	man/.ispell_xsymb
-DATA_4_DEST = ../man/$(PACKAGE)
-
-EXPLICIT_DOCS = man/x-symbol.texi
 
 PRELOADS = -l x-symbol.el
 

Makefile.upstream

 ## Copyright (C) 1998-2003 Free Software Foundation, Inc.
 ##
 ## Author: Christoph Wedler <wedler@users.sourceforge.net>
-## Version: 4.5
+## Version: 4.5.X
 ## Keywords: fonts, WYSIWYG, LaTeX, HTML, wp, math
 ## X-URL: http://x-symbol.sourceforge.net/
 
 ### Code:
 
 ## VERSION is a float!
-VERSION = 4.50
-AUTHOR_VERSION = 4.5
+VERSION = 4.51
+AUTHOR_VERSION = 4.5.1
 MAINTAINER = Christoph Wedler <wedler@users.sourceforge.net>
 PACKAGE = x-symbol
 PKG_TYPE = regular
 
 WWW_FILES = www/changes.txt www/style.css www/overview.tex.txt \
 	www/index.html www/related.html www/details.html www/news.html \
+	www/addfonts.html \
 	www/colors.png www/context.png www/grid.png \
 	www/images.png www/key.png www/overview.png www/subscripts.png \
 	www/token.png
 
 ## Author: Christoph Wedler <wedler@users.sourceforge.net>
 ## Maintainer: (Please use `M-x x-symbol-package-bug' to contact the maintainer)
-## Version: 4.4
+## Version: 4.5
 ## Keywords: WYSIWYG, LaTeX, HTML, wp, math, internationalization
 ## X-URL: http://x-symbol.sourceforge.net/
 
 
 The installation of X-Symbol on Emacs can be improved.
 
+The file Makefile.emacs is used to compile the binary package (elc files for
+XEmacs) for Emacs.  For details, see
+
+   http://x-symbol.sourceforge.net/news.html
+
 If you do not want to use the binary distribution and follow the installation
 instructions on the web page, you might want to try "lisp/Makefile".  For the
 info file, check "man/Makefile".

lisp/x-symbol-emacs.el

 ;;
 ;; Authors: Stefan Monnier, Christoph Wedler
 ;; Maintainer: (Please use `M-x x-symbol-package-bug' to contact the maintainer)
-;; Version: 4.5
+;; Version: 4.5.X
 ;; Keywords: WYSIWYG, LaTeX, HTML, wp, math, internationalization
 ;; X-URL: http://x-symbol.sourceforge.net/
 
 ;; \\[x-symbol-package-web]) and read the info (use \\[x-symbol-package-info]).
 
 (provide 'x-symbol-emacs)
+;; TODO: Emacs has `buffer-substring-no-properties'
 
 (unless (fboundp 'emacs-version>=)
-  (defun emacs-version>= (major &optional minor)
-  "Return true if the Emacs version is >= to the given MAJOR, and
-MINOR numbers, MINOR is optional.  MINOR is only used in the test if it
-is non-nil."
+(defun emacs-version>= (major &optional minor patch)
+  "Return true if the Emacs version is >= to the given version.
+The version is provided by the required argument MAJOR, and the optional
+arguments MINOR and PATCH.  Only the non-nil arguments are used in the
+test."
   (cond ((> emacs-major-version major))
 	((< emacs-major-version major) nil)
 	((null minor))
-	((>= emacs-minor-version minor)))))
+	((> emacs-minor-version minor))
+	((< emacs-minor-version minor) nil)
+	((null patch))
+	((string-match "^[0-9]+\\.[0-9]+\\.\\([0-9]+\\)" emacs-version)
+	 (>= (string-to-int (match-string 1 emacs-version)) patch)))))
 
 
 ;;;===========================================================================
 
 ;; src/fileio.c,v 1.447:
 (defvar x-symbol-emacs-has-correct-find-safe-coding
-  (emacs-version>= 21 4))
+  (not (and (boundp 'char-coding-system-table)
+	    (arrayp char-coding-system-table))))
 
 ;; lisp/format.el,v 1.39 (with src/fileio.c,v 1.447):
 ;;   (setq x-symbol-auto-conversion-method 'format)
 
 ;;; Bugs:
 
-(defvar x-symbol-emacs-after-create-image-function 'clear-image-cache)
+(defvar x-symbol-emacs-after-create-image-function
+;; I want to know why `clear-image-cache' is necessary sometimes,
+;; 'redraw-display is not enough
+  (if (emacs-version>= 21 3 50) nil 'clear-image-cache))
 
 ;;; Todo:
 
 (require 'fontset)			;seems not to be loaded in batch mode
 
 ;; temp hack:
+(defvar image-types nil)		; necessary in Emacs-21.2 w/o image
+					; support, still in Emacs-21.3?
 (if (memq 'png image-types) (provide 'png))
 (if (memq 'gif image-types) (provide 'gif))
 
 
 ;;; Char tables ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 
+;; TODO: use 'x-symbol instead 'generic with Emacs
 (put 'generic 'char-table-extra-slots 0)
 (unless (fboundp 'put-char-table)
   (defun put-char-table (range val tab) (set-char-table-range tab range val)))
 			      (< (length x) (length y))))
 	       (or separator ", "))))
 
+;; defined in Emacs-21.3.50
 (unless (fboundp 'file-remote-p)
   (defun file-remote-p (file-name)
     "Test whether FILE-NAME is looked for on a remote system."

lisp/x-symbol-hooks.el

 ;;
 ;; Author: Christoph Wedler <wedler@users.sourceforge.net>
 ;; Maintainer: (Please use `M-x x-symbol-package-bug' to contact the maintainer)
-;; Version: 4.5
+;; Version: 4.5.X
 ;; Keywords: WYSIWYG, LaTeX, HTML, wp, math, internationalization
 ;; X-URL: http://x-symbol.sourceforge.net/
 
 	(when (coding-system-p cs)
 	  (setq name (cdr (assq (coding-system-base cs)
 				'((raw-text . iso-8859-1) ; console
+				  ;; (undecided . iso-8859-1) "-i" is correct
+				  ;; here, see
+				  ;; `x-symbol-set-coding-system-if-undecided'
 				  (iso-latin-1 . iso-8859-1)
 				  (iso-latin-1-with-esc . iso-8859-1)
 				  (iso-latin-2 . iso-8859-2)
 	 (let* ((cs (default-value 'buffer-file-coding-system))
 		(val (cond (cs
 			    (x-symbol-buffer-coding cs))
-			   ((equal current-language-environment "English")
+			   ((member (downcase current-language-environment)
+				    '("english" "ascii"))
 			    'iso-8859-1)))
 		(loc (x-symbol-coding-system-from-locale)))
 	   (and loc
 	       (setq len (- (point-max) (point-min)))))
 	 (lwarn 'x-symbol 'warning
 	   ;; might leed to quite a few warnings with old XEmacs, get those
-	   "Wrong point position provided for function in `after-insert-file-functions'")))
+	   "Wrong point position %d (len: %d, max: %d) provided by Emacs for functions in `after-insert-file-functions'" (point) len (point-max))))
   len)
 
 (defun x-symbol-write-region-annotate-function (start end)
 				      x-symbol-font-directory) nil t)
 	       (not (eq 0 (call-process "xset" nil nil nil "fp+"
 					x-symbol-font-directory))))))
+	 ;; one cause: other dir with X-Symbol fonts already exists (old
+	 ;; installation)
 	 (lwarn 'x-symbol 'error
 	   "Couldn't add %s to X font path" x-symbol-font-directory))
     ;; Package fast-lock -----------------------------------------------------

lisp/x-symbol-tex.el

 ;;
 ;; Author: Christoph Wedler <wedler@users.sourceforge.net>
 ;; Maintainer: (Please use `M-x x-symbol-package-bug' to contact the maintainer)
-;; Version: 4.5
+;; Version: 4.5.X
 ;; Keywords: WYSIWYG, LaTeX, wp, math, internationalization
 ;; X-URL: http://x-symbol.sourceforge.net/
 
 	    ;; here instead using an complicated regexp for the main search
 	     (when (looking-at " [A-Za-z]\\|{}")
 	       (goto-char (setq end (match-end 0)))
-	       (when (setq token (buffer-substring beg end)
-			   token (symbol-value
-				 (intern-soft (buffer-substring beg end)
-					      decode-obarray)))
-		 (goto-char end)
-		 (insert-before-markers (gethash (car token)
-						 x-symbol-cstring-table))
-		 (delete-region beg end))))))))
+	       (when (setq token (symbol-value
+				  (intern-soft (buffer-substring beg end)
+					       decode-obarray)))
+		 (unless (x-symbol-decode-unique-test token unique)
+		   (goto-char end)
+		   (insert-before-markers (gethash (car token)
+						   x-symbol-cstring-table))
+		   (delete-region beg end)))))))))
 
 (defun x-symbol-tex-token-input (input-regexp decode-obarray command-char)
   (let ((res (x-symbol-match-token-before

lisp/x-symbol-vars.el

 ;;
 ;; Author: Christoph Wedler <wedler@users.sourceforge.net>
 ;; Maintainer: (Please use `M-x x-symbol-package-bug' to contact the maintainer)
-;; Version: 4.5
+;; Version: 4.5.X
 ;; Keywords: WYSIWYG, LaTeX, HTML, wp, math, internationalization
 ;; X-URL: http://x-symbol.sourceforge.net/
 
 (require 'x-symbol-hooks)
 (eval-when-compile (require 'cl))
 
-(defconst x-symbol-version "4.5"
+(defconst x-symbol-version "4.5.1"
   "Current development version of package X-Symbol.
 Check <http://x-symbol.sourceforge.net/> for the newest.")
 
     (iso-8859-15 . "-l9")
     (info . "-i")
     (error . "-err"))
+  ;; TODO: describe none, info, error
   "*Alist of codings with their names in the modeline.
 The elements look like (CODING . NAME) where CODING is a valid value for
 `x-symbol-coding' and NAME is used by `x-symbol-coding-modeline-text'."
 			       (sexp :tag "With argument")
 			       function))))
 
+;; Emacs only?
+(defcustom x-symbol-set-coding-system-if-undecided t ; TODO: nil?
+  "*If non-nil, set coding system if undecided when turning on X-Symbol.
+If this variable is non-nil, `x-symbol-default-coding' is non-nil, and
+`buffer-file-coding-system' specifies an undecided coding system, set
+`buffer-file-coding-system' according to `x-symbol-default-coding'."
+  :group 'x-symbol-mode
+  :type 'boolean)
+
 
 ;;;===========================================================================
 ;;;  Minor mode control
 ;;
 ;; Author: Christoph Wedler <wedler@users.sourceforge.net>
 ;; Maintainer: (Please use `M-x x-symbol-package-bug' to contact the maintainer)
-;; Version: 4.5
+;; Version: 4.5.X
 ;; Keywords: WYSIWYG, LaTeX, HTML, wp, math, internationalization
 ;; X-URL: http://x-symbol.sourceforge.net/
 
 	    (progn
 	      (decode-coding-region (point-min) (point-max) 'undecided)
 	      (set-buffer-multibyte t))
-	  (set-buffer-modified-p modified)))))
+	  (set-buffer-modified-p modified))))
+    (and x-symbol-mode
+	 x-symbol-set-coding-system-if-undecided
+	 x-symbol-default-coding
+	 (let ((cs (car (rassq x-symbol-default-coding
+			       '((iso-latin-1 . iso-8859-1)
+				 (iso-latin-2 . iso-8859-2)
+				 (iso-latin-3 . iso-8859-3)
+				 (iso-latin-9 . iso-8859-9)
+				 (iso-latin-15 . iso-8859-15))))))
+	   (if cs (set-buffer-file-coding-system cs)))))
   (if x-symbol-mode (x-symbol-init-font-lock))
   (if conversion
       (let ((modified (buffer-modified-p))
 ;;		     (setq cw2 quail-overlay)))
 ;;		     ;;(quail-point-in-conversion-region)))
 	   (setq info (x-symbol-point-info after before))
-	   (display-message 'no-log info)))))
+	   (if (featurep 'xemacs)
+	       (display-message 'no-log info)
+	     (let ((resize-mini-windows nil))
+	       (display-message 'no-log info)
+	       ;;(sit-for 0.01) ; does not work, resizes after 0.01s
+	       ))))))
 
 (defun x-symbol-start-itimer-once ()
   "Start idle timer for function `x-symbol-show-info-and-invisible'.

man/x-symbol.texi

 @settitle X-Symbol Manual
 @setchapternewpage odd
 
-@set edition 4.5
-@set version 4.5
-@set update March 2003
+@set edition 4.5.1
+@set version 4.5.1
+@set update May 2003
 @set url http://x-symbol.sourceforge.net
 @set maintainer wedler@@users.sourceforge.net
 @set listdevel x-symbol-devel@@lists.sourceforge.net
 changes, see @ref{News}.
 
 Bug fixes, bug reports, improvements, and suggestions are strongly
-appreciated.  Please read section @ref{Bug Reports} if you want to
-contact the maintainer of package X-Symbol.
+appreciated.  If you want to contact the maintainer of package X-Symbol,
+please read @ref{Bug Reports}.
 @end ifinfo
 
 @menu
 * FAQ 8bit Chars::              I do not want 8bit characters in the file.
 * FAQ Hyphen::                  I cannot distinguish @code{hyphen} from @samp{-}.
 * FAQ Spell Check::             I have problems with spell-checking.
-* FAQ News and Mail::           I want to use X-Symbol in Gnus or VM.
+* FAQ News and Mail::           I want to use X-Symbol in Gnus or @sc{vm}.
 
 History and Projects
 
 
 News: Changes in Recent Versions of X-Symbol
 
+* Changes New::                 To be announced.
 * Changes 4.5::                 Released Mar 2003 as beta.
 * Changes 4.4::                 Released June 2002 as beta.
 * Changes 4.1::                 Released Mar 2002 as beta.
 but it does not describes the technical format of possible values of
 each option.
 
-Section @ref{X-Symbol Internals} is for the curious reader and for
-people who want to define their own token language.
+If you want to learn something about X-Symbol's internals, e.g., if you
+want to define your own token language, see @ref{X-Symbol Internals}.
 
 This manual does not explain Emacs in general or some optional programs
 used by this package such as @code{convert} (used to produce the image
 
 @item latin-unity
 @pindex latin-unity
-Can be used with package X-Symbol, functionality is already provided by
+This XEmacs package can be used with package X-Symbol, functionality is already provided by
 X-Symbol for Latin-@{1,2,3,5,9@} characters: remapping (@pxref{Char
 Aliases}) and recoding (@pxref{File Coding}).  Has some safe-encoding
 mechanism, but the test comes currently too early (@pxref{Wishlist
 Emacs}).
 
-@c also ucs-tables.el? should be no problem@dots{}
+@c TODO: test mule-ucs.el with Emacs-21.4
+@item ucs-tables
+@pindex ucs-tables
+@findex unify-8859-on-decoding-mode
+@findex unify-8859-on-encoding-mode
+The Emacs minor modes @code{unify-8859-on-decoding-mode} and
+@code{unify-8859-on-encoding-mode} can be used with package X-Symbol.
 
 @item vc
 @pindex vc
 @pindex ispell
 The package @code{ispell} assumes the buffer contents to be the same as
 the file contents and does not provide any hook to fix this.  This
-should be fixed in @code{ispell}, @ref{Wishlist Emacs}.  @xref{FAQ
+should be fixed in @code{ispell}, see @ref{Wishlist Emacs}.  @xref{FAQ
 Spell Check}.
 
 @pindex ProofGeneral
 @item x-symbol-mule-change-default-face
 Package X-Symbol does not change the fonts of pre-defined Mule charsets
 (this can be changed by this variable).  Thus, the variables from
-Section @ref{Installing Fonts Lisp} might have no influence if Emacs
+@ref{Installing Fonts Lisp} might have no influence if Emacs
 already has defined fonts for the corresponding charsets.
 @end vtable
 
 
 This chapter describes the concepts of package X-Symbol.  It contains
 quite a few forward references to feature which are based on these
-concepts, such as @ref{Input Methods} and @ref{Features}.
+concepts, such as @ref{Input Methods}, and @ref{Features}.
 
 @menu
 * Token Language::              What does a X-Symbol character represent.
 ``@TeX{}info command'' (@code{texi}), see @ref{Supported Languages}.
 
 The token language determines the conversion between X-Symbol characters
-and tokens (@ref{Conversion}), the input methods (@pxref{Input
+and tokens (@pxref{Conversion}), the input methods (@pxref{Input
 Methods}), and various other features (@pxref{Features}).
 
 The token language is defined by the following buffer-local variable:
 If the normal file encoding is unsupported (any file encoding is invalid
 in this case) or if the normal file encoding is supported and the file
 does not contain 8bit characters, we always encode all X-Symbol
-character @xref{Controlling 8bit Coding}.  The modeline includes
+character (@pxref{Controlling 8bit Coding}).  The modeline includes
 @samp{-i} to represent the file encoding (@pxref{Minor Mode}), except if
 the default encoding is @code{nil}, the normal file encoding is
 unsupported, and the variable @code{x-symbol-coding} is not specified.
 @cindex Latin in File
 
 You can specify that 8bit characters (according to the coding in your
-file, @ref{File Coding}), are not encoded to tokens (when saving a
+file, see @ref{File Coding}), are not encoded to tokens (when saving a
 file), by setting the following buffer-local variable:
 
 @vtable @code
 happen.  That means: only decode canonical tokens, and, if
 @code{x-symbol-8bits} is non-@code{nil} (@pxref{Controlling 8bit
 Coding}), do not decode tokens which would be decoded to 8bit characters
-(according to the coding in your file, @ref{File Coding}).
+(according to the coding in your file, see @ref{File Coding}).
 
 You can set this variable in the ``local variables list'' near the end
 of the file (@pxref{File Variables,,,@value{emacs},@value{emacsman}}),
 Encode all characters in buffer to tokens.  No recoding will be
 performed since 8bit characters will always be encoded if the file
 coding is different to the default coding, since @code{x-symbol-8bits}
-is relative to the file coding, @ref{Controlling 8bit Coding}.
+is relative to the file coding, see @ref{Controlling 8bit Coding}.
 @end table
 
 All commands work on the region if it is active, or the (narrowed part
 @end itemize
 
 The token classes for individual token languages are explained in the
-corresponding sections of chapter @ref{Supported Languages}:
+corresponding sections of @ref{Supported Languages}:
 
 @vtable @code
 @item x-symbol-@var{lang}-header-groups-alist
 
 @item @key{button3}
 @kindex @key{button3}
-Pops up the X-Symbol menu, @ref{Input Method Menu}).
+Pops up the X-Symbol menu, see @ref{Input Method Menu}).
 @end table
 
 When using the keyboard to select a character, the following command
 Input method Electric (@pxref{Input Method Electric}) is disabled if the
 character is not of the correct @TeX{} mode, i.e., it only produces a
 math-mode character in a math area and a text-mode character in a text
-area (this test requires package @code{texmathp}, @ref{LaTeX Packages}).
+area (this test requires package @code{texmathp}, see @ref{LaTeX Packages}).
 Postfix tilde is not electric, because @samp{~} produces a space in
 @TeX{}.
 
 If we have exactly one blank, the blank is a space, and it is not
 followed by a @samp{%} (comment character), replace the macro by the
 corresponding character and delete the space.  (The character following
-the space must be a letter with unique decoding, @ref{Unique Decoding}.)
+the space must be a letter with unique decoding, see @ref{Unique Decoding}.)
 
 @item
 Otherwise, do @emph{not decode} the macro!
 
 @itemize @bullet
 @item
+In general, escape sequences use the digits of the current font.  Thus,
+you should probably define the encodings 48 to 57 as digits @samp{0} to
+@samp{9}.
+
+@item
 In La@TeX{} buffers, characters in @samp{$%\@{@}} have a special
-syntax.  Thus, you should you should probably not use encodings 36, 37,
+syntax.  Thus, you should probably not use encodings 36, 37,
 92, 123 and 125 for characters which could also be useful with token
 languages @code{tex} and @code{utex}.
 
 @item
 In HTML buffers, characters in @samp{&<>} have a special syntax.  Thus,
-you should you should probably not use encodings 38, 60 and 62 for
+you should probably not use encodings 38, 60 and 62 for
 characters which could also be useful with token language @code{sgml}.
 @end itemize
 
 * FAQ 8bit Chars::              I do not want 8bit characters in the file.
 * FAQ Hyphen::                  I cannot distinguish @code{hyphen} from @samp{-}.
 * FAQ Spell Check::             I have problems with spell-checking.
-* FAQ News and Mail::           I want to use X-Symbol in Gnus or VM.
+* FAQ News and Mail::           I want to use X-Symbol in Gnus or @sc{vm}.
 @end menu
 
 
 You use some version control commands.  You have probably noticed that
 these versions control commands also turn off @code{font-lock} in modes
 where you don't use X-Symbol, i.e., this is not a problem of package
-X-Symbol.  @pxref{Wishlist Emacs} and @ref{Spurious Encodings}.
+X-Symbol.  @xref{Wishlist Emacs}.  @xref{Spurious Encodings}.
 @end itemize
 
 
 would be to delete the space which other people won't like.
 @end itemize
 
-@xref{TeX Macro Conversion}, for an exact description.
+For an exact description, @xref{TeX Macro Conversion}.
 
 
 @node FAQ 8bit Chars, FAQ Hyphen, FAQ Additional Spaces, FAQ
 
 @node FAQ News and Mail,  , FAQ Spell Check, FAQ
 @comment  node-name,  next,  previous,  up
-@subsection How to Use X-Symbol with Gnus or VM
+@subsection How to Use X-Symbol with Gnus or @sc{vm}
 @cindex News Reader
 @cindex Mail Reader
 @pindex Gnus
 
 You can also use X-Symbol to read and write your News and Mails.  This
 sections includes coding for your @file{~/.emacs} if you want to do so.
-It has been tested for Gnus-5.8.8 and VM-6.96; if you use RMAIL or MH-E,
-you have to try to find a solution yourself (please send it to me).
-Support for @sc{Gnus} might become a standard part of X-Symbol.
+It has been tested for Gnus-5.8.8 and @sc{vm}-6.96; if you use
+@sc{rmail} or @sc{mh-e}, you have to try to find a solution yourself
+(please send it to me).  Support for Gnus might become a standard
+part of X-Symbol.
 
 @lisp
 (custom-set-variables
 (add-hook 'gnus-article-prepare-hook 'x-symbol-x-gnus-prepare)
 @end lisp
 
-Since @sc{Gnus} reuses the @file{*Article*} buffer, where X-Symbol could
+Since Gnus reuses the @file{*Article*} buffer, where X-Symbol could
 have been turned on previously, we must make sure that X-Symbol is
 turned off with the new article.
 
 (add-hook 'vm-select-message-hook 'x-symbol-x-gnus-prepare)
 @end lisp
 
-The same thing for VM, although the hook is not as nice as Gnus' one;
-the function therefore might depend a bit too much on VM's internals.
+The same thing for @sc{vm}, although the hook is not as nice as
+Gnus' one; the function therefore might depend a bit too much on
+@sc{vm}'s interna.
 
 @findex vm-mode
 @findex vm-presentation-mode
 (custom-set-variables '(vm-fill-paragraphs-containing-long-lines 80))
 @end lisp
 
-You cannot use X-Symbol in VM Mode, only in VM Presentation Mode
-(X-Symbol would change your @file{INBOX}).  The first (optional)
-Emacs Lisp expression gives you a better error message when you try
-to turn on X-Symbol Mode in VM Mode.  The second line makes sure that
-VM always uses VM Presentation Mode to display the articles.
+You cannot use X-Symbol in @sc{vm} Mode, only in @sc{vm} Presentation Mode
+(X-Symbol would change your @file{INBOX}).  The first (optional) Emacs
+Lisp expression gives you a better error message when you try to turn on
+X-Symbol Mode in @sc{vm} Mode.  The second line makes sure that @sc{vm}
+always uses @sc{vm} Presentation Mode to display the articles.
 
 @c ===========================================================================
 
 This might look tedious to you, but it actually saves a lot of time
 (your time, too).
 
+The @strong{general recommendation} for bug/problem reports is: give the
+impression that your really have tried to find the necessary information
+yourself and make your report precise while including all information
+you have.
+
 For each bug/problem report or question you want to send to the
 maintainer, please use the following sequence:
 
 X-Symbol @value{version}.
 
 @item
-Read the manual, especially @ref{Checking Installation}, @ref{Problems}
+Read the manual, especially @ref{Checking Installation}, @ref{Problems},
 and @ref{FAQ}.  The four indexes (@pxref{Indexes}) might also lead you
 to an answer to your question.
 
 If @kbd{M-x x-symbol-package-bug} fails to work, you have a problem with
 your installation and your report should be about this problem.  In this
 case, use @samp{x-symbol @var{version}; @var{summary}} as Subject header
-where @var{version} is the version of X-Symbol and @var{summary} is a
-brief summary of your installation problem.
+where @var{version} is the version of X-Symbol (it should be
+@value{version}) and @var{summary} is a brief summary of your
+installation problem.
 
 (@emph{Rationale}: This command automatically extracts some essential
 information without any work by you.  Don't waste your time pondering whether
 problem:
 @end quotation
 
-The sections @var{section1}, @var{section2}, etc are names (not
-numbers!) of the sections (not whole chapters!) in the manual where you
-would expect an answer to your question/problem/bug.
+The sections @var{section1}, @var{section2}, etc are names of the
+sections (not whole chapters) in the manual where you would expect an
+answer to your question/problem/bug.
 
 If you didn't know which sections to inspect, please check the indexes.
 If they are not helpful, send me words/terms which should be included in
 
 @item
 If the problem is not reproducible with an @emph{arbitrary}
-(@file{.tex}, @file{.html}, @dots{}) file, try to minimize the file such that
-the problem can be still reproducible, and include the file with its
-full file name into your bug report.
+(@file{.tex}, @file{.html}, @dots{}) file, include the file with its full file
+name into your bug report.  (If you like, you can try to minimize the
+file if the problem is still reproducible.)
 
 (@emph{Rationale}: Most problems are only reproducible with specific
 files.)
 changes before Version 3.0.
 
 @menu
+* Changes New::                 To be announced.
 * Changes 4.5::                 Released Mar 2003 as beta.
 * Changes 4.4::                 Released June 2002 as beta.
 * Changes 4.1::                 Released Mar 2002 as beta.
 @end menu
 
 
-@c * Changes New::                 To be announced.
-
-@c @node Changes New, Changes 4.4, News, News
-@c @comment  node-name,  next,  previous,  up
-@c @subsection Changes in X-Symbol @value{version}
-
-@c Version @value{version} has not yet been announced.
-
-
-@node Changes 4.5, Changes 4.4, News, News
+
+@node Changes New, Changes 4.5, News, News
+@comment  node-name,  next,  previous,  up
+@subsection Changes in X-Symbol @value{version}
+
+Version @value{version} has not yet been announced.
+
+@itemize @bullet
+@item
+Various bug fixes and minor changes.
+@end itemize
+
+
+@node Changes 4.5, Changes 4.4, Changes New, News
 @comment  node-name,  next,  previous,  up
 @subsection Changes in X-Symbol 4.5
 
 
 @item
 Token language @code{sgml}: always encode characters to entity
-references by default (not possible with most Latin-N characters, where
-we still use character entities).  Include @code{hm--html-mode},
-@code{html-helper-mode}, remove @code{sgml-mode} as typical major modes.
+references by default (where defined by the HTML standard).  Include
+@code{hm--html-mode}, @code{html-helper-mode}, remove @code{sgml-mode}
+as typical major modes which use X-Symbol.
 
 @item
 Token language @code{tex}: support some symbols of package
 The package @code{ispell} assumes the buffer contents to be the same as
 the file contents and does not provide any hook to fix this.  This
 should be fixed in @code{ispell} (it will be better in Emacs-21.4),
-@ref{Miscellaneous Packages}.
+see @ref{Miscellaneous Packages}.
 
 @item
 @pindex vc
 He also proved that it is faster.
 
 Solofo Ramangalahy is working on scripts to generate X-Symbol fonts from
-other sources.  This has various advantages and is discussed at
-@ref{Wishlist Fonts} in more detail.  His work is now available at the
+other sources.  This has various advantages and is discussed in more detail at
+@ref{Wishlist Fonts}.  His work is now available at the
 X-Symbol download area.
 
 Package @code{math-mode} by Renaud Marlet and the extension of it by
 Jan-Ake Larsson, Bernhard Lehner, Stefan Monnier, Harald Muehlboeck,
 Karsten Muehlmann, Jakub Narebski, Peter M@o{}ller Neergaard, Raymond
 Nijssen, David von Oheimb, Alex Ott, Sudeep Kumar Palat, Arshak
-Petrosyan, Jim Radford, Christophe Raffalli, Solofo Ramangalahy,
-Marciano Siniscalchi, Richard M. Stallman, Alex Russell, Eli Tziperman,
-Jan Vroonhof, Markus Wenzel, Sabine Wetzel, Pierre-Henri Wuillemin,
-Roland Zumkeller, Marco Zunino, Gerard Zwaan.
+Petrosyan, Jim Radford, Christophe Raffalli, Solofo Ramangalahy, Alex
+Russell, Marciano Siniscalchi, Richard M. Stallman, Axel Thimm, Eli
+Tziperman, Jan Vroonhof, Markus Wenzel, Sabine Wetzel, Pierre-Henri
+Wuillemin, Roland Zumkeller, Marco Zunino, Gerard Zwaan.
 
 @i{Thanks for general information to:} Per Abrahamsen, Steve L. Baur,
 Kenichi Handa, David Kastrup, Gerd Moellmann, Stefan Monnier, Primoz
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.