# HG changeset patch
# User yuuji
# Date 774115887 0
# Node ID 56f7676ed8ca3ea68542a62d5b68168e49a89905
# Parent  546c4baad92fd0371318d4764e965bb4e0f59c97
Change the document for YaTeX-nervous.

diff -r 546c4baad92f -r 56f7676ed8ca docs/yatexe.tex
--- a/docs/yatexe.tex	Mon Jul 11 14:56:13 1994 +0000
+++ b/docs/yatexe.tex	Wed Jul 13 16:11:27 1994 +0000
@@ -233,7 +233,7 @@
 * Editing %# notation::         
 @end menu
 
-@node Changing typesetter, Static region for typesetting,  , %# notation
+@node Changing typesetter, Static region for typesetting, %# notation, %# notation
 @comment  node-name,  next,  previous,  up
 @section To change the `latex' command or to split a source text.
 @cindex typesetter
@@ -410,7 +410,7 @@
 * Greek letters completion::    
 @end menu
 
-@node Begin-type completion, Section-type completion,  , Completion
+@node Begin-type completion, Section-type completion, Completion, Completion
 @comment  node-name,  next,  previous,  up
 @section Begin-type completion
 @cindex begin-type completion
@@ -622,7 +622,7 @@
 * view-sectioning::             
 @end menu
 
-@node view-sectioning,  ,  , Section-type completion
+@node view-sectioning,  , Section-type completion, Section-type completion
 @comment  node-name,  next,  previous,  up
 @subsection view-sectioning
 @cindex view sectioning
@@ -1017,36 +1017,33 @@
 
 @node Local dictionaries, Updation of @code{\includeonly}, Filling an item, Top
 @comment  node-name,  next,  previous,  up
-@chapter Local dictionaries: For nervous users
+@chapter Local dictionaries
 @cindex local dictionaries
 @cindex nervous users
 
-  If you have had the experience that you couldn't concentrate on editing
-because you typed miss-spelled word on completion and the registration of
-the wrong word to @file{.yatexrc} weighed on your mind.  Or if you have
-thought that you want YaTeX not to register a local newcommand which goes
-only in current text, into the standard user completion dictionary;
-@file{.yatexrc}.  Write this in your @file{~/.emacs}.
+  Tables for completion consist of three dictionaries; `standard
+dictionary' built in @file{yatex.el}, `user dictionary' for your common
+private commands, and `local dictionary' that is effective in a certain
+directory.
+
+  When you input the command unknown to YaTeX at a completion in the
+minibuffer, YaTeX asks you with the following prompt;
+
+@example
+  `foo' is not in table. Register into: U)serTable L)ocal N)one
+@end example
+
+@noindent 
+In this menu, typing `u' updates your `user dictionary', `l' updates your
+local dictionary, and `n' updates no dictionary and throws the word away.
+
+  If you find this switching feature meaningless and bothersome, put the
+next expression into your @file{~/.emacs}
 
 @lisp
- 	(setq YaTeX-nervous t)
+ 	(setq YaTeX-nervous nil)
 @end lisp
 
-  In addition to `standard table' built in yatex.el and `user table' which
-is always saved into @file{~/.yatexrc}, the statement above allows you to
-use `temporary table' for completion.  When you enter a word which is
-never seen in these tables, you can select the table in which you want to
-save the word; `user table'(UserTable), `temporary table'(TempTable) or
-discard it(None).
-
-  But you may want to complete newcommand semi-permanently that is defined
-in rather large text as graduation thesis, even if the newcommand is a
-local declaration.  After setting @code{YaTeX-nervous} to @code{t}, make
-an empty file named @file{.yatexrc} (the same name as your user
-dictionary).  YaTeX will use it as the local dictionary to keep the
-contents of temporary completion table.  This local dictionary will be
-loaded only when you edit the file which exists in the same directory.
-
 @node Updation of @code{\includeonly}, What column?, Local dictionaries, Top
 @comment  node-name,  next,  previous,  up
 @chapter Updation of @code{\includeonly}
@@ -1253,7 +1250,7 @@
 * Add-in functions::            
 @end menu
 
-@node Lisp variables, Add-in functions,  , Customizations
+@node Lisp variables, Add-in functions, Customizations, Customizations
 @comment  node-name,  next,  previous,  up
 @section Lisp variables
 @cindex customizable variables
@@ -1279,7 +1276,7 @@
 * Hook file::                   
 @end menu
 
-@node All customizable variables, Sample definitions,  , Lisp variables
+@node All customizable variables, Sample definitions, Lisp variables, Lisp variables
 @comment  node-name,  next,  previous,  up
 @subsection All customizable variables
 @cindex all customizable variables
diff -r 546c4baad92f -r 56f7676ed8ca docs/yatexj.tex
--- a/docs/yatexj.tex	Mon Jul 11 14:56:13 1994 +0000
+++ b/docs/yatexj.tex	Wed Jul 13 16:11:27 1994 +0000
@@ -30,7 +30,7 @@
 * Cursor jump - カーソルジャンプ::  
 * Modifying/Deleting - 変更/削除::  
 * Filling item - itemの桁揃え::  
-* Local dictionary - ローカル辞書(神経質な人へ)::  
+* Local dictionary - ローカル辞書::  
 * Includeonly - 勝手にincludeonly::  
 * Where am I? - 今はどこ?::     
 * Intelligent newline - おまかせ改行::  
@@ -151,7 +151,7 @@
 * Print out - プリントアウト用コマンドの起動::  
 @end menu
 
-@node Calling typesetter - タイプセッタ起動, Print out - プリントアウト用コマンドの起動,  , Invocation - 外部コマンドの起動
+@node Calling typesetter - タイプセッタ起動, Print out - プリントアウト用コマンドの起動, Invocation - 外部コマンドの起動, Invocation - 外部コマンドの起動
 @comment  node-name,  next,  previous,  up
 @section タイプセッタ起動
 @cindex タイプセッタ起動
@@ -219,7 +219,7 @@
 * Editing %# notation - %#記法の編集::  
 @end menu
 
-@node Changing typesetter - タイプセット用コマンドの変更, Splitting input files - 入力ファイル分割,  , %#記法
+@node Changing typesetter - タイプセット用コマンドの変更, Splitting input files - 入力ファイル分割, %#記法, %#記法
 @comment  node-name,  next,  previous,  up
 @section タイプセット用コマンド変更
 
@@ -426,7 +426,7 @@
 * Greek letter completion - ギリシャ文字補完::  
 @end menu
 
-@node begin型補完, section型補完,  , Completion - 補完入力
+@node begin型補完, section型補完, Completion - 補完入力, Completion - 補完入力
 @comment  node-name,  next,  previous,  up
 @section begin型補完
 @cindex begin型補完[beginがたほかん]
@@ -604,7 +604,7 @@
 * view-sectioning - セクション区切りのアウトライン表示::  
 @end menu
 
-@node 2個以上の引数をとる section型コマンド, Input argument without copletion - 引数入力時に補完しない,  , section型補完
+@node 2個以上の引数をとる section型コマンド, Input argument without copletion - 引数入力時に補完しない, section型補完, section型補完
 @comment  node-name,  next,  previous,  up
 @subsection 2個以上の引数をとる section型コマンド
 @cindex 引数[ひきすう]
@@ -1072,7 +1072,7 @@
 	        ↑(カーソル位置)
 @end example
 
-@node Filling item - itemの桁揃え, Local dictionary - ローカル辞書(神経質な人へ), Modifying/Deleting - 変更/削除, Top
+@node Filling item - itemの桁揃え, Local dictionary - ローカル辞書, Modifying/Deleting - 変更/削除, Top
 @comment  node-name,  next,  previous,  up
 @chapter itemの桁揃え
 @cindex itemの桁揃え[itemのけたぞろえ]
@@ -1107,41 +1107,42 @@
 この変数の指定の仕方がよく分からない場合は、独自の項目列挙コマンドの名前を
 @code{@code{"\item"}で始まるものにして下さい(例えば"\itembf"})。
 
-@node Local dictionary - ローカル辞書(神経質な人へ), Includeonly - 勝手にincludeonly, Filling item - itemの桁揃え, Top
+@node Local dictionary - ローカル辞書, Includeonly - 勝手にincludeonly, Filling item - itemの桁揃え, Top
 @comment  node-name,  next,  previous,  up
-@chapter 神経質な人へ
+@chapter ローカル辞書
 @cindex ローカル辞書[ろーかるじしょ]
-@cindex 神経質な人へ[しんけいしつなひとへ]
 @cindex .yatexrc
 @cindex へんなたんご[へんなたんご]
 
-  補完入力で間違った単語を入れてしまい、@file{.yatexrc} に変な単語が記録さ
-れるのが気になってしまって、もはや編集に集中できないあなた。学習させたコマ
-ンドは、今書いている文書中で定義しているローカルなものなので、やはり標準の 
-@file{.yatexrc} には保存して欲しくない、と思ったことのあるあなた。そんなあ
-なたは、@file{~/.emacs} に次の一行を足してください。
+  補完入力用の候補は三種類の辞書から構成されています。一つは
+@file{yatex.el}に組み込まれた「標準辞書」、もう一つはユーザが個人的に常用
+するコマンドを保存する「ユーザ辞書」、そしてもうひとつはあるディレクトリで
+のみ有効なコマンドを保存する「ローカル辞書」です。
+
+  補完入力時に新しい単語を入れた場合に、その単語をどの辞書に入れるか聞いて
+来ます。
+
+@example
+  `foo' is not in table. Register into: U)serTable L)ocal N)one
+@end example
+
+@noindent 
+というプロンプトに対し、@kbd{u}と答えると「ユーザ辞書」を、@kbd{l}と答える
+とローカル辞書を更新することになり、@kbd{n}と答えると新たな単語を学習せず
+に捨てることになります。
+
+  もし、ローカル辞書の機能はいらず、全てユーザ辞書の更新のみでよいと言う場
+合には@file{~/.emacs}などで、
 
 @lisp
- 	(setq YaTeX-nervous t)
+ 	(setq YaTeX-nervous nil)
 @end lisp
 @cindex YaTeX-nervous
 
-  通常の、@file{yatex.el} に組み込まれた「標準テーブル」と 
-@file{~/.yatexrc} に保存される「ユーザテーブル」に加え、「一時テーブル」が
-使えるようになります。これら補完テーブルにない単語を入れた時に、ユーザテー
-ブル(UserTable)、その日だけ有効な一時テーブルに保存するか(TempTable)、覚え
-ずに捨てる(None)かが選べるようになります。
+@noindent 
+として下さい。
 
-  ところが、卒論などのように長期に渡って書く大きなものになると、その論文で
-定義しているローカルなコマンドであっても「その日だけ」ではなく、その論文を
-書いている間は補完してもらいたいものです。そんなときは、上記の変数
-@code{YaTeX-nervous} を@code{t}にセットしたうえで、その論文を置いているディ
-レクトリに@file{.yatexrc}(ユーザ辞書と同じ名前で中身は空)を作ってください。
-すると、そのファイルをローカル辞書として一時テーブルの内容を保存するために
-用います。以後、このローカル辞書の存在するディレクトリのファイルを編集する
-時のみ、その辞書に含まれる補完候補が有効になります。
-
-@node Includeonly - 勝手にincludeonly, Where am I? - 今はどこ?, Local dictionary - ローカル辞書(神経質な人へ), Top
+@node Includeonly - 勝手にincludeonly, Where am I? - 今はどこ?, Local dictionary - ローカル辞書, Top
 @comment  node-name,  next,  previous,  up
 @chapter 勝手にincludeonly
 @cindex 勝手にincludeonly[かってにincludeonly]
@@ -1341,7 +1342,7 @@
 * Add-in functions - 付加関数(アドイン関数)::  
 @end menu
 
-@node Lisp variables - lisp 変数, Add-in functions - 付加関数(アドイン関数),  , Customizations - カスタマイズ
+@node Lisp variables - lisp 変数, Add-in functions - 付加関数(アドイン関数), Customizations - カスタマイズ, Customizations - カスタマイズ
 @comment  node-name,  next,  previous,  up
 @section lisp 変数
 @cindex prefixキー変更[prefixきーへんこう]
@@ -1362,7 +1363,7 @@
 * Hook file - hook用ファイル::  
 @end menu
 
-@node All customizable variables - カスタマイズ変数一覧, Sample definitions - カスタマイズ変数設定例,  , Lisp variables - lisp 変数
+@node All customizable variables - カスタマイズ変数一覧, Sample definitions - カスタマイズ変数設定例, Lisp variables - lisp 変数, Lisp variables - lisp 変数
 @comment  node-name,  next,  previous,  up
 @subsection カスタマイズ変数一覧
 @cindex カスタマイズ変数一覧[かすたまいずへんすういちらん]
@@ -1470,7 +1471,7 @@
 
 @item YaTeX-nervous
 
-ローカル辞書を用いる時 @code{t} (@code{nil})
+ローカル辞書を用いる時 @code{t} (@code{t})
 
 @item YaTeX-sectioning-regexp