Table of Contents

1. Introduction

1.1 X-Symbol's Copying Conditions: GPL
1.2 Brief Summary of X-Symbol
1.3 About this Manual

2. Installation

2.1 Requirements
2.2 Put the Files into your Home Directory
2.3 System-wide Installation: Put the Files into the XEmacs Directory
2.4 Make XEmacs Initialize X-Symbol During Startup
2.5 Installing the Image Converter from ImageMagick
2.6 Package Integration

2.6.1 LaTeX Packages
2.6.2 Syntax Highlighting Packages (font-lock and add-ons)
2.6.3 File I/O Packages
2.6.4 Miscellaneous Packages

2.7 Installing Additional Fonts
2.8 Installing Fonts for Exceed (X-server on Windows)
2.9 Lisp Coding when Using Other Fonts
2.10 Installing Info, Postscript and HTML Files
2.11 Checking the Correct Installation of Package X-Symbol

3. Concepts of Package X-Symbol

3.1 Token Language
3.2 Conversion: Decoding and Encoding

3.2.1 Normal File and Default Encoding
3.2.2 File Coding of 8bit Characters
3.2.3 Store or Encode 8bit Characters
3.2.4 Unique Decoding
3.2.5 Conversion Commands
3.2.6 Copy & Paste with Conversion
3.2.7 Character Aliases

3.3 Minor Mode
3.4 Poor Man's Mule: Running Under XEmacs/no-Mule
3.5 The Role of font-lock
3.6 Character Group and Token Classes

4. X-Symbol's Input Methods

4.1 Common Behavior of All Input Methods
4.2 Input Method Token: Replace Token by Character
4.3 Input Method Read Token: Minibuffer Completion
4.4 Input Method Menu: Select a Menu Item
4.5 Input Method Grid: Choose Highlighted Character
4.6 Input Method Keyboard: Compose Key Sequence
4.7 Input Method Context: Replace Char Sequence
4.8 Input Method Electric: Automatic Context
4.9 Input Method Quail: a Mule Input Method
4.10 Customizing Input Methods

5. Features of Package X-Symbol

5.1 Super- and Subscripts
5.2 Images at the end of Image Insertion Commands

5.2.1 Display of Images
5.2.2 Image Conversion
5.2.3 Image Caching
5.2.4 Special Images for Specific Situations
5.2.5 Image Editor

5.3 Info in Echo Area
5.4 Ascii Representation of Strings
5.5 X-Symbol Package Information

6. Supported Token Languages

6.1 Pseudo Token Language "x-symbol charsym"
6.2 Token Language "TeX macro" (tex)

6.2.1 Basics of Language "TeX macro"
6.2.2 Super-/Subscripts and Images in LaTeX
6.2.3 Problems with TeX Macros
6.2.4 The Conversion of TeX Macros
6.2.5 Extra Symbols of Language "TeX Macro"

6.3 Token Language "SGML entity" (sgml)

6.3.1 Basics of Language "SGML entity"
6.3.2 Super-/Subscripts and Images in HTML
6.3.3 The Conversion of SGML Entities

6.4 Token Language "BibTeX macro" (bib)
6.5 Token Language "TeXinfo command" (texi)
6.6 Languages Defined in Other Emacs Packages

7. X-Symbol Internals

7.1 Internal Representation of X-Symbol Characters
7.2 Defining X-Symbol Charsets
7.3 Defining Input Methods

7.3.1 Defining Input Methods: Objectives
7.3.2 X-Symbol Character Descriptions: Example
7.3.3 Defining Input Methods by Character Descriptions
7.3.4 Defining Input Methods: Example
7.3.5 Customizing Input Methods

7.4 Extending Package X-Symbol

7.4.1 Extending X-Symbol with New Fonts
7.4.2 Guidelines for Input Definitions
7.4.3 Emacs Lisp File Defining a New Font
7.4.4 Emacs Lisp File Extending a Token Language
7.4.5 Emacs Lisp File Defining a New Token Language

7.5 Various Internals

7.5.1 Tagging Insert Commands for Token and Electric
7.5.2 Avoiding Hide/Show-Invisible Flickering

7.6 Design Alternatives

7.6.1 Alternative Token Representations
7.6.2 Alternative Ways to Turn on X-Symbol Globally
7.6.3 Alternative Auto Conversion Methods

7.7 Language Internals
7.8 Miscellaneous Internals

8. Problems, Troubleshooting

8.1 Problems under XEmacs/no-Mule
8.2 Spurious Encodings
8.3 The Encoding Does Not Work
8.4 Frequently Asked Questions

8.4.1 XEmacs Crashes when using Input Method Token
8.4.2 X-Symbol's Fontification does Not Work
8.4.3 The Buffer Contains Strange Characters
8.4.4 I Cannot See any/some Super- or Subscripts
8.4.5 I See Super- and Subscripts where I Don't Want Them.
8.4.6 The Characters are Too Small or Too Big
8.4.7 The Conversion Changes Some Tokens
8.4.8 A Space is Added During the Encoding
8.4.9 I Don't Want 8bit Characters in the File
8.4.10 I Cannot Distinguish Character hyphen from `-'
8.4.11 Problems with Spell-checking
8.4.12 How to Use X-Symbol with Gnus or VM

8.5 How to Send a Bug/Problem Report

9. History and Projects

9.1 News: Changes in Recent Versions of X-Symbol

9.1.1 Changes in X-Symbol 4.5.1
9.1.2 Changes in X-Symbol 4.5
9.1.3 Changes in X-Symbol 4.2 to 4.4
9.1.4 Changes in X-Symbol 4.1
9.1.5 Changes in X-Symbol 3.4
9.1.6 Changes in X-Symbol 3.3
9.1.7 Changes in X-Symbol 3.2
9.1.8 Changes in X-Symbol 3.1
9.1.9 Changes in X-Symbol 3.0
9.1.10 Changes in Old Releases.

9.2 Wishlist: Projects for X-Symbol

9.2.1 Wishlist: Additional Token Languages
9.2.2 Wishlist: Generated Fonts
9.2.3 Wishlist: Changes in Emacs/XEmacs
9.2.4 Wishlist: Changes in LaTeX
9.2.5 Various Projects for X-Symbol
9.2.6 Rejected Suggestions for X-Symbol

9.3 Open Questions
9.4 Acknowledgments

Indexes

Key Index
Program and Package Index
Command, Function and Variable Index
Concept Index