annotate lisp/auctex/PROBLEMS @ 100:4be1180a9e89 r20-1b2

Import from CVS: tag r20-1b2
author cvs
date Mon, 13 Aug 2007 09:15:11 +0200
parents 4103f0995bd7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
1 * Your Emacs is missing easymenu.el.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
2
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
3 Please upgrade.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
4
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
5 If that is absolutely impossible, you can try installing
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
6
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
7 <URL:ftp://sunsite.auc.dk/packages/auctex/auc-menu.el>
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
8
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
9 under the name easymenu.el at some place where emacs can find it.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
10 The best place is in the standard Emacs lisp directory, because that
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
11 will automatically be removed when you upgrade.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
12
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
13 * Missing menus or menus containing just the word "Bug".
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
14
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
15 You probably have an old version of easymenu.el or auc-menu.el. Find
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
16 it, delete it, and recompile AUC TeX. If you are using an old Emacs,
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
17 the easymenu.el may have been distributed with it. In that case, see
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
18 the previous point.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
19
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
20 * You are not using UNIX or can't figure out how to install.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
21
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
22 0. Delete any old version you have.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
23
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
24 1. Edit tex-site.el. Read the comments in the file.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
25
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
26 2. Add (load-file "<Path to AUC TeX>/tex-site.el") to your .emacs file.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
27
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
28 If you start a fresh emacs, AUC TeX should be loaded now.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
29 The two next steps are optional:
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
30
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
31 3. Byte compile the files with "M-x byte-compile-file" for speed.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
32
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
33 4. Do a `M-x TeX-auto-generate-global' to get full macro completion.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
34
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
35 Look also for files with names like MSDOS, OS2, or VMS that might be
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
36 applicable for your system.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
37
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
38 * You get errors during byte compilation.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
39
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
40 This often indicates a type in your customizations. If you have
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
41 modified `tex-site.el', try to enter that file from Emacs and type
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
42 `M-x eval-current-buffer RET' to find the error.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
43
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
44 This is can also be because some old version of AUC TeX gets loaded
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
45 during the compilation. Make sure to remove all old versions, and try
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
46 again. The Emacs 19 byte-compiler will give warning about free
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
47 variables and unknown functions. Ignore them.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
48
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
49 tex-jp.el will fail unless you have an emacs that understands japanese.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
50
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
51 NEmacs-3.3.2 cannot `make install-auto', use `M-x TeX-auto-generate-global'
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
52 instead.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
53
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
54 Mule-1.0-KIRITSUBO fails to parse some of the style files.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
55
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
56 * You are using NeXT Emacs.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
57
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
58 NeXT Emacs is broken, a workaround is available by ftp:
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
59
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
60 host: sunsite.auc.dk
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
61 file: /packages/auctex/get-proc-env.el.z (gzip'ed)
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
62
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
63 * You are mixing Emacs 18, FSF Emacs 19, and Lucid Emacs 19.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
64
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
65 Make sure to use the correct byte-compiled files for each version.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
66 You may want to disable the automatic byte compilation by setting
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
67
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
68 (setq TeX-byte-compile nil)
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
69
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
70 in your .emacs file.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
71
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
72 * None if this completion or multifile stuff works...
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
73
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
74 It must be enabled first, insert this in your emacs:
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
75
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
76 (setq-default TeX-master nil)
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
77 (setq TeX-parse-self t)
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
78 (setq TeX-auto-save t)
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
79
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
80 Read also the chapters about parsing and multifile documents in the
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
81 manual.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
82
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
83 * When I save `foo.bib' AUC TeX forgets the information in `foo.tex'.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
84
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
85 For various reasons, AUC TeX ignores the extension when it store
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
86 information about a file, so you should use unique base names for your
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
87 files. E.g. rename `foo.bib' to `foob.bib'.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
88
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
89 * (La)TeX Interactive does not work.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
90
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
91 You need comint.el on Emacs 18. Look at your favorite elisp archive.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
92
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
93 * TeX-save-document does not work.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
94
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
95 Make sure TeX-check-path contains "./" somewhere.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
96
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
97 * Ispell does not ignore TeX macros.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
98
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
99 GNU ispell 4.0 does not understand TeX. Upgrade to International
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
100 Ispell 3.1 which works much better on TeX documents.
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
101
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
102
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
103 % Local Variables:
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
104 % mode: outline-minor
4103f0995bd7 Import from CVS: tag r19-15b95
cvs
parents:
diff changeset
105 % End: