%%
%% Q and A on YaTeX
%%
%% C-u C-x $ shows only questions.  C-x $ displays the questions.
%%

[Installation]
*Installing the manual
	Copy yatexe to the info directory where your Emacs is installed, and
	add the next line to the dir file of the same directory.
	
	* YaTeX: (yatexj). Yet Another tex-mode for Emacs. (Japanese).

	(After that, M-x info [RET] m yatex [RET] will give you Wild Bird's
	manual.  Hitting ? will show how to use info)

*I ain't got the privilege to write in the Info directory...

    Get yourself made root.  If you can't, have them install mule2 and
	add
	
		(setq Info-default-directory-list
		      (cons "YOUR INFO DIRECTORY"
			    Info-default-directory-list))
	
	to your ~/.emacs.  Now your personal files will be added to the menu
	when you invoke info.  mule1 will not release memories, so processes
	will pile up and be heavier on the system compared to mule2.  Nemacs
	has already become obsolete by the developers, so no further comments
	for usage of Nemacs.  Get yourself mule2 with flying colors :-)
	
*Emacs can't find the help file.

	The help file is set to be placed in $EMACS/etc/ for Nemacs, Mule1
	and $EMACS/site-lisp/ for Mule2.  If you don't have the privilege to
	put them in a public location, copy it to your home directory and
	set YaTeX-help-file to that file name.
	
*I can't read info on Nemacs
	
	The info file was formatted on Mule, so it can't be read correctly on
	Nemacs (or Demacs based on Nemacs) because the internal Japanese
	processing is different.  Read it on Mule.  Use the Emacs-Lisp
	package in texinfo-3.1.tar.gz to format the Texinfo file.

	
[Operations]
*I accidentally learned in a wrong LaTeX command.
	
	There should be a line with the wrong command in the .yatexrc file
	in you home or current directory.  Erase that line, do M-x
	eval-current-buffer and save the results with C-x C-s.

*I can't comment out the region.
	
	Probably the point is on a line withe \begin{} or \end{}.  Go up or
	down a line and do C-c >.
	
*I was asked for a parent file when typesetting, and answered the wrong file.
	
	Re-read the child file with C-x C-v RET or re-type the parent file
	with	C-u C-c ^.
	
*The typeset buffer is not shown when I get a typeset buffer on Demacs.
	
	This happens on Demacs 1.2.0, when the child process returns an
	error level of 1 or more.  If you are calling jlatex from a batch
	file, call a dummy command that always returns errorlevel 0 at the
	end.
	
*How can I enter "\underline{\makebox[4em][l]{x y}{\tt z}}" more easily?
	
	Recursive completion can be used for inputting arguments in the
	mini-buffer of a section type completion.  Following is an example
	showing the command in question.

	PROMPT				   								KEYs ENTERED
														C-c s und SPC RET
	\underline{???}:									C-c s makeb SPC RET
	Width:												4em RET
	makebox position (`lr'): -							l RET
	\makebox{???}:										x y RET
	\underline{???}: \makebox[4em][l]{x y}				C-c l tt RET
	\underline{???}: \makebox[4em][l]{x y}{\tt }		z RET
	
*How can I kill \footnote{} from \footnote{HOGE}
	
	Put the point to \footnote and do C-c k.  This will kill the
	\footnote{}.  If you want to kill the whole thing including HOGE, do
	C-u C-c k.

*I want to make HONYARA into a footnote.
	
	Mark HONYARA and do C-c S footnote RET.  (S in uppercase)
	
*I want to make the verbatim environment I have now into verbatim*.
	
	Do C-c c on the line with \begin{verbatim} or \end{verbatim}.
	
*I want to enclose a region with \verb.
	
	\verb isn't a maketitle-type, so there aren't any quick commands.
	But you can use C-c $ to do the same thing.

	     WHAT YOU NEED to make \verb
		 \verbWHAT YOU NEED to make \verb	(insert \verb)
		      ^(C-@)						(mark W)
		 \verbWHAT YOU NEED to make \verb	
		                   ^C-c $			(move point to end enclose
											 with $)
		 \verb$WHAT YOU NEED$ to make \verb	(done!)
	
*I want to have commands defined on a upper level file to be read in
 when doing a typeset-region on a child file.
	
	When you are editing child files broken into sections and some
	macros to be used are defined in upper level files, you'll need them
	to do typeset-region.  The macros needed will be copied to the
	temporary file if you add %#REQUIRE to the end of the macro's
	definition.
	
	Say you had a grand-child file
	+-- main.tex --+  +---- sub.tex ----+  +-- subsub.tex --+
	| :            |  |%#jlatex main    |  |%#jlatex main   |
	|\include{sub} |  |\include{macros} |  |.....           |
	| :            |<-| :               |<-|%#BEGIN         |
	| :            |  | :               |  |TEXT YOU WANT   |
	| :            |  +-----------------+  |TYPESET IS      |
	+--------------+          ^            |HERE            |
	                  +-- macros.tex ---+  |%#END           |
			          |\def\foo{bar}    |  |:               |
			          |\def\hoge{hero}  |  +----------------+
			          +-----------------+
	
	In this case you change the \include{macros} line in sub.tex to

		\include{macros} %#REQUIRE
	
	and add to subsub.tex
	
		%#REQUIRE \include{macros}
	
	If %#REQUIRE is at the top of the line, the following will be copied
	to the temporary file.  So, macros.tex will be included only once
	whether you are typesetting all the files, or doing a typeset-region
	on sub.tex or subsub.tex.
	
*I want to reuse ARGUMENTS I used in the last \foo{ARGUMENTS}
	
	Use the gmhist package.  YaTeX works fine with gmhist.  When you are
	asked \foo{???}: in the mini-buffer, hitting M-p (ESC p) will get
	you a history of what you have inputted in reverse.  M-n will go
	forward in the history.  This input history can be used for
	begin-type completion, section-type completion, evoking the
	previewer, and print out commands.
	
	gmhist can be found at many Emacs-Lisp archive sights. For example,
	ftp.ae.keio.ac.jp:pub/emacs-lisp/util/gmhist.tar.gz
	
*ref<->label jump doesn't work.
	
	C-c g will start a forward search of ref/label.  C-u C-c g will
	start a backward search.  If you want to continue searching for
	\ref, hit C-s (C-r) twice and use the repeated search feature of the
	incremental search.  If the point to jump is in another file, that
	file must be already opened.  YaTeX-display-hierarchy (C-c d) can be
	used to open all files at once.
	
*I get a % at the end of the line when I do a fill-paragraph or auto-fill.
	
	NTT-jTeX will add an unnecessary space in the print out image if the
	japanese paragraph is written with an indent.  To avoid this, you
	need to put a % at the end of the line.  YaTeX will automatically
	put a % so you can input indented text for NTT-jTeX.  But there may
	be a bug in the routine so please report if you find any %s otherwise
	than at the end of a line.
		
*Isn't the indentation too deep in itemize environments?
	
	Think so too?  An alias Mr. K thought this was better and he's
	the only one delighted hitting the TAB key.  Wasn't my idea! (still
	have a bit of a grudge)  If you also think it's too deep, hit TAB at
	the end of the line with \begin{itemize} within the environment.
	Now it's too shallow?  Umm... time for me to take a break.

	
[About Mule2]
*Equations are too dark to read when I use Mule2+hilit19.
	
	The default coloring of hilit19.el is too dark.  Try putting the
	next code in ~/.emacs or yatexhks.el.

	(if (and (featurep 'hilit19) (eq hilit-background-mode 'dark))
	       (hilit-translate
	     string 'mediumspringgreen
	     formula 'khaki
	     label 'yellow-underlined))

*Can't I use font-lock?
	
	The document says, "pattern must be specified within a line".  So it
	seems you can't chose a pattern like from \begin to \end that laps
	more than one line.  But on the other hand, multiple line comments
	in C seems to work fine...  So what's the real story?  Anybody know
	the answer?  If so, teach me, or try sending a fan letter to our
	font-lock investigator-in-depress Taguchi (tagu@ae.keio.ac.jp)

*It's sooo slow when I click YaTeX on the menu bar.
	
	I don't know why.  Probably a problem with Emacs-19.  You'll just
	have to bear with it.  It won't be so slow the second time.
	Anyway, you probably won't use the menu at all, do you?  
	
[Customization]
*I don't use C-c b i much, so it would be better if I can start
 completion after hitting C-c b.
	
	Put (setq YaTeX-no-begend-shortcut t) in your ~/.emacs.
	
*An open parenthesis always get entered in pairs.
	
	This should be better, once you get used to it.  If you still don't
	like it, turn on modify-mode using C-c w m.  Setting
	YaTeX-close-paren-always to nil will give this feature from the start.
	
*Funny things happen when I hit ;.
	
	YaTeX think you are in math mode and evokes math-mode-image
	completion.  If you are writing a equation that TeX will not give an
	error and YaTeX mistakes what mode you are in, report it back to the
	author.  For mistaken judgements or if you want to enter a literal
	;, hit ; twice.  C-u ; to use ; as a image-completion prefix.
	
*I want YaTeX to enter the option arguments for a newenvironment.
	
	Read yatexadd.doc.  If that's not enough, read yatexgen.doc and try
	M-x YaTeX-generate.
	
*I first defined \foo as a macro taking 3 arguments.  Later I changed it
 to take 4 arguments, but the section-type completion will ask me for
 only 3 arguments.
	
  	Use C-u 4 C-c s and tell it will take 4 arguments.  You can change
	the number of arguments anytime you want.
	
*I made a argument-type addin function, but can't do completion after
 the first two arguments.
	
	If you made a addin function like \foo{x}{y}{z} that takes 3
	arguments, then you need to learn in the dictionary that \foo will
	take 3 arguments.  This can be done by C-u 3 C-c s foo.  You only
	need to do it once.
	
*My addin functions are overwritten by yatexadd.
	
	Formally, all private functions were written in your own yatexadd.el.
	Now, all private functions are put in yatexhks.el.  yatexhks.el will
	be read in at the end of YaTeX's initialization, so you can overwrite
	definitions in yatexadd.el.
	
[ETC]
*Mailing lists?
	
	A question, so an answer.  The mailing list for YaTeX(Wild Bird) and
	it's implementation to Vz, Raicho (by katsura@prc.tsukuba.ac.jp) is
	"fj Wild Bird Society".  Send a mail like
	
		To: yatex-control@harvest.jaist.ac.jp
		Subject: append
		-----
		Hi!  See any birds fly by?

	and you're in.  The text will be used as your profile. (you can
	change it later)  Once you're in, you'll get a reply with lists of
	commands used in the mailing list.  Join along and help adding new
	feathers to Wild Bird.  BTW, if you haven't guessed it yet, yes,
	this mailing list is in Japanese.  But give us a try anyway.  You're
	always welcome.
	
*Help, help HELP!!
	
	Ways of getting answers in fastest order.

	*Look for someone near you who knows what's he/she's doing.
	*Post a question to the mailing list.
	*Send mail to yuuji@ae.keio.ac.jp
	
	take a pick.
	
*Picking a question in this file with C-u C-x $ and hitting C-x $ takes
 me to a weird world.
	
	You too?  Try marking the question before C-x $ and to C-x C-x to
	take you back to it.  (mule2 doesn't seem to have the same problem)


Local Variables:
mode: indented-text
fill-column: 72
fill-prefix: "	"
End: