yatex

view docs/qanda.eng @ 57:18f4939986e6

(j)LaTeX2e supported yatex19.el fixed a lot
author yuuji
date Sat, 02 Dec 1995 18:35:28 +0000
parents a9653fbd1c1c
children 3a7c0c2bf16d
line source
1 %%
2 %% Q and A on YaTeX
3 %%
4 %% C-u C-x $ shows only questions. C-x $ shows all.
5 %%
7 [Installation]
8 ==============
9 *Installing the manual
11 Copy yatexe to the info directory where your Emacs is installed,
12 and add the next line to the dir file of the same directory.
14 * YaTeX: (yatexj). Yet Another tex-mode for Emacs. (Japanese).
16 (After that, M-x info [RET] m yatex [RET] will give you Wild
17 Bird's manual. Hitting ? will show how to use info)
19 *I ain't got the privilege to write in the Info directory...
21 Get yourself made root. If you can't, have them install Mule2
22 and add
24 (setq Info-default-directory-list
25 (cons "YOUR INFO DIRECTORY"
26 Info-default-directory-list))
28 to your ~/.emacs. Now your personal files will be added to the
29 menu when you invoke info. By the way, Mule1 will not release
30 memories, so processes will pile up and be heavier on the system
31 compared to Mule2. Nemacs has already become obsolete by the
32 developers, so no further comments for usage of Nemacs. Get
33 yourself Mule2 with flying colors :-)
35 *Emacs can't find the help file.
37 The help file is set to be placed in $EMACS/etc/ for Nemacs,
38 Mule1 and $EMACS/site-lisp/ for Mule2. If you don't have the
39 privilege to put them in a public location, copy it to your home
40 directory and set YaTeX-help-file to that file name.
42 *I can't read info on Nemacs
44 The info file was formatted on Mule, so it can't be read
45 correctly on Nemacs (or Demacs based on Nemacs) because the
46 internal Japanese processing is different. Read it on Mule.
47 Use the Emacs-Lisp package in texinfo-3.1.tar.gz to format the
48 Texinfo file.
51 [Operations]
52 ============
53 *I accidentally learned in a wrong LaTeX command.
55 There should be a line with the wrong command in the .yatexrc
56 file in you home or current directory. Erase that line, do M-x
57 eval-current-buffer and save the results with C-x C-s.
59 *I can't comment out the region.
61 Probably the point is on a line withe \begin{} or \end{}. Go up
62 or down a line and do C-c >.
64 *I was asked for a parent file when typesetting, and answered the wrong file.
66 Re-read the child file with C-x C-v RET or re-type the parent
67 file with C-u C-c ^.
69 *The typeset buffer is not shown when I get a typeset buffer on Demacs.
71 This happens on Demacs 1.2.0, when the child process returns an
72 error level of 1 or more. If you are calling jlatex from a
73 batch file, call a dummy command that always returns errorlevel
74 0 at the end.
76 *How can I enter "\underline{\makebox[4em][l]{x y}{\tt z}}" more easily?
78 Recursive completion can be used for inputting arguments in the
79 mini-buffer of a section type completion. Following is an
80 example showing the command in question.
82 PROMPT KEYs ENTERED
83 C-c s und SPC RET
84 \underline{???}: C-c s makeb SPC RET
85 Width: 4em RET
86 makebox position (`lr'): - l RET
87 \makebox{???}: x y RET
88 \underline{???}: \makebox[4em][l]{x y} C-c l tt RET
89 \underline{???}: \makebox[4em][l]{x y}{\tt } z RET
91 *How can I kill \footnote{} from \footnote{HOGE}
93 Put the point to \footnote and do C-c k. This will kill the
94 \footnote{}. If you want to kill the whole thing including
95 HOGE, do C-u C-c k.
97 *I want to make HONYARA into a footnote.
99 Mark HONYARA and do C-c S footnote RET. (S in uppercase)
101 *I want to make the verbatim environment I have now into verbatim*.
103 Do C-c c on the line with \begin{verbatim} or \end{verbatim}.
105 *I want to enclose a region with \verb.
107 \verb isn't a maketitle-type, so there aren't any quick commands.
108 But you can use C-c $ to do the same thing.
109 v v
110 WHAT YOU NEED to make \verb
111 \verbWHAT YOU NEED to make \verb (insert \verb)
112 ^(C-@) (mark W)
113 \verbWHAT YOU NEED to make \verb
114 ^C-c $ (move point to end enclose with $)
115 \verb$WHAT YOU NEED$ to make \verb (done!)
117 *I want to have commands defined on a upper level file to be read in
118 when doing a typeset-region on a child file.
120 When you are editing child files broken into sections and some
121 macros to be used are defined in upper level files, you'll need
122 them to do typeset-region. The macros needed will be copied to
123 the temporary file if you add %#REQUIRE to the end of the
124 macro's definition.
126 Say you had a grand-child file
127 +-- main.tex --+ +---- sub.tex ----+ +-- subsub.tex --+
128 | : | |%#jlatex main | |%#jlatex main |
129 |\include{sub} | |\include{macros} | |..... |
130 | : |<-| : |<-|%#BEGIN |
131 | : | | : | |TEXT YOU WANT |
132 | : | +-----------------+ |TYPESET IS |
133 +--------------+ ^ |HERE |
134 +-- macros.tex ---+ |%#END |
135 |\def\foo{bar} | |: |
136 |\def\hoge{hero} | +----------------+
137 +-----------------+
139 In this case you change the \include{macros} line in sub.tex to
141 \include{macros} %#REQUIRE
143 and add to subsub.tex
145 %#REQUIRE \include{macros}
147 If %#REQUIRE is at the top of the line, the following will be
148 copied to the temporary file. So, macros.tex will be included
149 only once whether you are typesetting all the files, or doing a
150 typeset-region on sub.tex or subsub.tex.
152 *I want to reuse ARGUMENTS I used in the last \foo{ARGUMENTS}
154 Use the gmhist package. YaTeX works fine with gmhist. When you
155 are asked \foo{???}: in the mini-buffer, hitting M-p (ESC p)
156 will get you a history of what you have inputted in reverse.
157 M-n will go forward in the history. This input history can be
158 used for begin-type completion, section-type completion, evoking
159 the previewer, and print out commands.
161 gmhist can be found at many Emacs-Lisp archive sights. For
162 example, ftp.ae.keio.ac.jp:pub/emacs-lisp/util/gmhist.tar.gz
164 Note that Emacs-19(Mule2) doesn't need gmhist for the feature of
165 minibuffer history.
167 *ref<->label jump doesn't work.
169 C-c g will start a forward search of ref/label. C-u C-c g will
170 start a backward search. If you want to continue searching for
171 \ref, hit C-s (C-r) twice and use the repeated search feature of
172 the incremental search. If the point to jump is in another
173 file, that file must be already opened. YaTeX-display-hierarchy
174 (C-c d) can be used to open all files at once.
176 *I get a % at the end of the line when I do a fill-paragraph or auto-fill.
178 NTT-jTeX will add an unnecessary space in the print out image if
179 the japanese paragraph is written with an indent. To avoid
180 this, you need to put a % at the end of the line. YaTeX will
181 automatically put a % so you can input indented text for
182 NTT-jTeX. But there may be a bug in the routine so please
183 report if you find any %s otherwise than at the end of a line.
185 *Isn't the indentation too deep in itemize environments?
187 Think so too? An alias Mr. K thought this was better and he
188 feels an ultimate ecstacy with hitting the TAB to indent a line.
189 Wasn't my idea! (still have a bit of a grudge) If you also
190 think it's too deep, hit TAB at the end of the line with
191 \begin{itemize} within the environment. Now it's too shallow?
192 Umm... time for me to take a break.
194 *Is it possible to include personal template file template.tex handily?
196 Try Emacs-19's standard package `autoinsert.el' please. Or its
197 upper compatible package auto-insert-tkld might also be good.
198 You can get auto-insert-tkld via anonymous ftp
199 ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/
200 ftp://archive.cis.ohio-state.edu/pub/gnu/elisp-archive/
202 [About Emacs-19/Mule2]
203 ======================
204 *Equations are too dark to read when I use hilit19.
206 The default coloring of hilit19.el is too dark. Try putting the
207 next code in ~/.emacs or yatexhks.el.
209 (if (and (featurep 'hilit19) (eq hilit-background-mode 'dark))
210 (hilit-translate
211 string 'mediumspringgreen
212 formula 'khaki
213 label 'yellow-underlined))
215 *Can't I use font-lock?
217 The document says, "pattern must be specified within a line".
218 So it seems you can't chose a pattern like from \begin to \end
219 that laps more than one line. But on the other hand, multiple
220 line comments in C seems to work fine... So what's the real
221 story? Anybody know the answer? If so, teach me, or try
222 sending a fan letter to our font-lock investigator-in-depress
223 Taguchi (tagu@ae.keio.ac.jp)
225 *It's sooo slow when I click YaTeX on the menu bar.
227 I don't know why. Probably a problem with Emacs-19. You'll
228 just have to bear with it. It won't be so slow the second time.
229 Anyway, you probably won't use the menu at all, do you?
231 *Is there any way of displaying `\it' strings in the italic font?
233 First, you should find the available italic font on your
234 system. In, *scratch* buffer,
235 (set-face-font 'italic "-*-*-medium-i-*--*-*-*-*-*-*-*-*")
236 or
237 (set-face-font 'italic "-*-*-medium-o-*--*-*-*-*-*-*-*-*")
238 and C-j (It takes very very long time!!).
239 If you get `No matches found', no way. (;_;)/~
240 If you get some font name,
241 "-adobe-courier-medium-i-normal--12-120-75-75-m-0-iso8859-1"
242 for example, write
243 (set-face-font 'italic
244 "-adobe-courier-medium-i-normal--12-120-75-75-m-0-iso8859-1")
245 in your `yatexhks.el'.
247 [Customization]
248 ===============
249 *I don't use C-c b i much, so it would be better if I can start
250 completion after hitting C-c b.
252 Put (setq YaTeX-no-begend-shortcut t) in your ~/.emacs.
254 *An open parenthesis always get entered in pairs.
256 This should be better, once you get used to it. If you still
257 don't like it, turn on modify-mode using C-c w m. Setting
258 YaTeX-close-paren-always to nil will give this feature from the
259 start.
261 *Funny things happen when I hit ;.
263 YaTeX think you are in math mode and evokes math-mode-image
264 completion. If you are writing a equation that TeX will not
265 give an error and YaTeX mistakes what mode you are in, report it
266 back to the author. For mistaken judgements or if you want to
267 enter a literal ;, hit ; twice. C-u ; to use ; as a
268 image-completion prefix.
270 *I want YaTeX to enter the option arguments for a newenvironment.
272 Read yatexadd.doc. If that's not enough, read yatexgen.doc and
273 try M-x YaTeX-generate.
275 *I first defined \foo as a macro taking 3 arguments. Later I changed it
276 to take 4 arguments, but the section-type completion will ask me for
277 only 3 arguments.
279 Use C-u 4 C-c s and tell it will take 4 arguments. You can
280 change the number of arguments anytime you want.
282 *I made a argument-type addin function, but can't do completion after
283 the first two arguments.
285 If you made a addin function like \foo{x}{y}{z} that takes 3
286 arguments, then you need to learn in the dictionary that \foo
287 will take 3 arguments. This can be done by C-u 3 C-c s foo.
288 You only need to do it once.
290 *My addin functions are overwritten by yatexadd.
292 Formally, all private functions were written in your own
293 yatexadd.el. Now, all private functions are put in yatexhks.el.
294 yatexhks.el will be read in at the end of YaTeX's
295 initialization, so you can overwrite definitions in yatexadd.el.
297 [ETC]
298 =====
299 *Mailing lists?
301 A question, so an answer. The mailing list for YaTeX (Wild
302 Bird) and it's implementation to Vz, Raicho (by KATSURAGAWA,
303 Naoki; katsura@prc.tsukuba.ac.jp) is "fj Wild Bird Society".
304 Send a mail like
306 To: yatex-control@jaist.ac.jp
307 Subject: append
308 -----
309 Hi! See any birds fly by?
311 and you're in. The text will be used as your profile. (you can
312 change it later) Once you're in, you'll get a reply with lists
313 of commands used in the mailing list. Join along and help
314 adding new feathers to Wild Bird. BTW, if you haven't guessed
315 it yet, yes, this mailing list is in Japanese. But give us a
316 try anyway. You're always welcome.
318 *Help, help HELP!!
320 Ways of getting answers in fastest order.
322 *Look for someone near you who knows what's he/she's doing.
323 *Post a question to the mailing list.
324 *Send mail to yuuji@ae.keio.ac.jp
326 take a pick.
328 *Picking a question in this file with C-u C-x $ and hitting C-x $ takes
329 me to a weird world.
331 You too? Try marking the question before C-x $ and to C-x C-x
332 to take you back to it. (Mule2 doesn't seem to have the same
333 problem)
336 Local Variables:
337 mode: indented-text
338 fill-column: 72
339 fill-prefix: " "
340 End: