%%
%% Q and A on YaTeX
%%
%% C-u C-x $shows only questions. C-x$ shows all.
%%
(New Item
*It is bothering for me to determine I should call bibtex or latex...
*Filling a paragraph doesn't work as I expected.

[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-e: (yatexe). Yet Another tex-mode for Emacs. (English).

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

*I'm a Meadow(Emacs on Win32) user.  I don't have make' utility

Make program is needed only for byte-compiling.  So if you do
not care the subtle speed difference, you don't have to
byte-compile.  You don't have to look for make' utility.  The
simplest way to install yatex without make'.

install' file in this package.

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

Get yourself made root.  If you can't, have them install Mule2

(setq Info-default-directory-list
Info-default-directory-list))

menu when you  invoke info.  By the way,  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 your home or current directory.  Erase or fix that line,
and save the results with C-x C-s, then kill  buffer with C-x k.
Once you make sure the current buffer is your LaTeX source, type

*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. v v 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

%#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

Note that Emacs-19(Mule2) doesn't need gmhist for the feature of
minibuffer history.

*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
feels an ultimate ecstacy with hitting the TAB to indent a line.
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.

*Is it possible to include personal template file template.tex handily?

Try Emacs-19's standard package autoinsert.el' please.  Or its
upper compatible package auto-insert-tkld might also be good.
You can get auto-insert-tkld via anonymous ftp
ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/
ftp://archive.cis.ohio-state.edu/pub/gnu/elisp-archive/

*It is bothering for me to determine I should call bibtex or latex...

Why don't you try latexmk' perl script, which is a TeX specific
tool as make'?  It detects the dependency among the TeX-related
files such as .tex, .bib, and so on, and will execute suitable
commands in a suitable sequence.  You can find latexmk' script
in a directory of supports/latexmk in some CTAN ftp directory.

*Can I inhibit auto-filling against very long  line?

If you use Emacs-19 or later, Yes.  The variable
auto-fill-inhibit-regexp controls the filling behaviour.  To set
this, use yatex-mode-hook as below.

`