X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;f=doc%2Fluatexja.dtx;h=0bc8a28273f3ae602ede1b3d1806475010a944e3;hb=79a3cd02a15808ab4620153674d15ba3f059ae5e;hp=e8cbcf496f63d7d070577c24bcb626a19e1e2710;hpb=8156de215f4e7adf80d97612780d98aca0a924de;p=luatex-ja%2Fluatexja.git

diff --git a/doc/luatexja.dtx b/doc/luatexja.dtx
index e8cbcf4..0bc8a28 100644
--- a/doc/luatexja.dtx
+++ b/doc/luatexja.dtx
@@ -16,6 +16,31 @@
 \makeatletter
 %%%%%%%%
 \directlua{if jit then jit.on() end}
+
+\usepackage{amsmath,array,tikz,pict2e,multienum,float}
+\usepackage{booktabs,multicol,luatexja-ruby}
+\usepackage[all]{xy}
+\usepackage{lltjext,alltt}
+
+%%%%%%%% fonts
+\usepackage{luatexja-otf}
+\directlua{luatexja.otf.enable_ivs()}
+\usepackage[match]{luatexja-fontspec}
+\usepackage[kozuka-pr6n]{luatexja-preset}
+\usepackage{unicode-math}
+\setmainfont[Ligatures=TeX]{Linux Libertine O}
+\setsansfont[Scale=0.95,Ligatures=TeX]{TeX Gyre Heros}
+\setmonofont[Scale=MatchLowercase, ItalicFont=lmmono10-italic.otf,
+  BoldFont=lmmonolt10-bold.otf, BoldItalicFont=lmmonolt10-boldoblique.otf
+]{lmmono10-regular.otf}
+\setmonojfont{KozGoPr6N-Regular.otf}
+\setmathfont[Scale=MatchLowercase]{xits-math.otf}
+%<*ja>
+\def\emph#1{\textbf{\textgt{#1}}}
+\def\headfont{\normalfont\bfseries\gtfamily}\normalsize
+%</ja>
+%<en>\frenchspacing
+
 %<*en>
 \usepackage[margin=25mm,lmargin=30mm,rmargin=30mm,footskip=6mm]{geometry}
 \usepackage{luatexja-adjust}\ltjdisableadjust
@@ -31,11 +56,6 @@
 \advance\leftmargini-1\zw\advance\leftmarginii-1\zw
 %</ja>
 
-\usepackage{amsmath,array,tikz,pict2e,multienum,float}
-\usepackage{booktabs,multicol,luatexja-ruby}
-\usepackage[all]{xy}
-\usepackage{lltjext,alltt}
-
 %%%%%%%% listings
 
 %%%%%%%% IVS
@@ -104,26 +124,6 @@
 %<en>\newtheorem{defn}{Definition}
 %<ja>\newtheorem{defn}{定義}
 
-%%%%%%%% fonts
-\usepackage{luatexja-otf}
-%<ja>\usepackage{lmodern}
-\directlua{luatexja.otf.enable_ivs()}
-\usepackage[match]{luatexja-fontspec}
-\usepackage[kozuka-pr6n]{luatexja-preset}
-\setmonojfont{KozGoPr6N-Regular.otf}
-%<*ja>
-\def\emph#1{\textbf{\textgt{#1}}}
-\def\headfont{\normalfont\bfseries\gtfamily}
-\usepackage{amssymb}
-%</ja>
-%<*en>
-\usepackage{unicode-math}
-\setmainfont[Ligatures=TeX]{TeX Gyre Termes}
-\setsansfont[Scale=0.95,Ligatures=TeX]{TeX Gyre Heros}
-\setmathfont{xits-math.otf}
-\frenchspacing
-%</en>
-
 %%%%%%%% logo
 \usepackage{metalogo}
 \DeclareRobustCommand\eTeX{\ensuremath{\varepsilon}-\kern-.125em\TeX}
@@ -133,7 +133,7 @@
 \DeclareRobustCommand\upTeX{up\kern-.15em\TeX}
 \DeclareRobustCommand\pLaTeX{p\kern-.05em\LaTeX}
 \DeclareRobustCommand\pLaTeXe{p\kern-.05em\LaTeXe}
-\DeclareRobustCommand\epTeX{\ensuremath{\varepsilon}-\kern-.125em\pTeX}
+\DeclareRobustCommand\epTeX{\ensuremath{\varepsilon}-\pTeX}
 
 %%%%%%%% other macros
 \newlist{cslist}{description}{1}
@@ -275,13 +275,16 @@ scripts for appropriate callbacks.
 
 %<*en>
 The \LuaTeX-ja package is under much influence of \pTeX\ engine. The initial
-target of development was to implement features of \pTeX. However,
-\emph{\LuaTeX-ja is not a just porting of \pTeX; unnatural
+target of development was to implement features of \pTeX. However, 
+implementing all feature of \pTeX\ is impossible, 
+since all process of \LuaTeX-ja must be implemented only by Lua and \TeX\ macros.
+Hence \emph{\LuaTeX-ja is not a just porting of \pTeX; unnatural
 specifications/behaviors of \pTeX\ were not adopted}.
 %</en>
 %<*ja>
 \LuaTeX-jaは，\pTeX に多大な影響を受けている．初期の開発目標は，\pTeX の機
-能をLuaコードにより実装することであった．しかし，開発が進むにつれ，\pTeX
+能をLuaコードにより実装することであった．しかし，（\pTeX はエンジン拡張であったのに対し）
+\LuaTeX-jaはLuaコードと\TeX マクロを用いて全てを実装していなければならないため，\pTeX
 の完全な移植は不可能であり，また\pTeX における実装がいささか不可解になっ
 ているような状況も発見された．そのため，\emph{\LuaTeX-jaは，もはや
 \pTeX の完全な移植は目標とはしない．\pTeX における不自然な仕様・挙動があ
@@ -289,34 +292,25 @@ specifications/behaviors of \pTeX\ were not adopted}.
 %</ja>
 
 %<*en>
-The followings are major changes from \pTeX:
+The followings are major changes from \pTeX.
+For more detailed information, see Part~\ref{part-imp} or other sections of this manual.
 %</en>
 %<*ja>
 以下は \pTeX からの主な変更点である．
+より詳細については第\ref{part-imp}部など本文書の残りを参照．
 %</ja>
 
-\begin{itemize}
-%<*en>
-\item \emph{\LuaTeX-ja does all process only with Lua and \TeX\ macros},
-while \pTeX\  is an engine extension of \TeX82.
-This means that several features of \pTeX\ are not completely implemented
-in \LuaTeX-ja.
-%</en>
-%<*ja>
-\item \pTeX はエンジン拡張であったのに対し，
-\emph{\LuaTeX-jaはLuaコードと\TeX マクロを用いて全てを実装している}．
-そのため，\pTeX のいくつかの機能は\LuaTeX-ja に（そのままの形では）実装していない．
-%</ja>
-\begin{itemize}
 %<*en>
- \item \pTeX\ addes several primitives, such as \cs{kanjiskip}, 
+\paragraph{Command names} \pTeX\ addes several primitives, such as \cs{kanjiskip}, 
 \cs{prebreakpenalty},~and,~\cs{ifydir}. They can be used as follows:
 %</en>
 %<*ja>
- \item 例えば\pTeX で追加された次のようなプリミティブ
+\paragraph{命令の名称} 例えば\pTeX で追加された次のようなプリミティブ
 %</ja>
 \begin{verbatim}
 \kanjiskip=10pt  \dimen0=kanjiskip
+\tbaselineshift=0.1zw
+\dimen0=\tbaselineshift
 \prebreakpenalty`ぁ=100
 \ifydir ... \fi
 \end{verbatim}
@@ -324,37 +318,48 @@ in \LuaTeX-ja.
 %<en> Instead of them, we have to write as the following.
 %<ja> は\LuaTeX-jaには存在しない．\LuaTeX-jaでは以下のように記述することになる．
 \begin{verbatim}
-\ltjsetparameter{kanjiskip}  \dimen0=\ltjgetparameter{kanjiskip}
+\ltjsetparameter{kanjiskip=10pt}  \dimen0=\ltjgetparameter{kanjiskip}
+\ltjsetparameter{talbaselineshift=0.1\zw}
+\dimen0=\ltjgetparameter{talbaselineshift}
 \ltjsetparameter{prebreakpenalty={`ぁ,100}}
 \ifnum\ltjgetparemeter{direction}=4 ... \fi
 \end{verbatim}
+%<*en> 
+Note that \pTeX\ adds new two useful units, namely \texttt{zw}~and~\texttt{zh}.
+As shown above, they are changed by \cs{zw}~and\cs{zh} respectively, in \LuaTeX-ja.
+%</en>
+%<*ja>
+特に注意してほしいのは，\pTeX で追加された \texttt{zw} と \texttt{zh} という単位を
+\LuaTeX-ja で扱うには，\cs{zw}, \cs{zh} と制御綴の形にしないといけないという点である．
+%</ja>
 
 %<*en>
-\item In \pTeX, a line break after Japanese character is ignored (and
+\paragraph{Linebreak after a Japanese character}
+In \pTeX, a line break after Japanese character is ignored (and
       doesn't yield a space), since line breaks (in source files) are
       permitted almost everywhere in Japanese texts. However, \LuaTeX-ja
       doesn't have this feature completely, because of a specification
       of \LuaTeX. For the detail, see Section~\ref{sec-lbreak}.
 %</en>
 %<*ja>
-\item 日本語の文書中では改行はほとんどどこでも許されるので，\pTeX では和文文字
+\paragraph{和文文字直後の改行}
+日本語の文書中では改行はほとんどどこでも許されるので，\pTeX では和文文字
       直後の改行は無視される（スペースが入らない）ようになっていた．しかし，
       \LuaTeX-ja では \LuaTeX の仕様のためにこの機能は完全には実装されていない．
       詳しくは\ref{sec-lbreak}章を参照．
 %</ja>
 
-\end{itemize}
-
-
-
 %<*en>
-\item The insertion process of glues/kerns between two Japanese
+
+\paragraph{Spaces related to Japanese characters}
+The insertion process of glues/kerns between two Japanese
       characters and between a Japanese character and other characters
       (we refer glues/kerns of both kinds as \textbf{JAglue}) is rewritten from
       scratch.
 %</en>
 %<*ja>
-\item 2つの和文文字の間や，和文文字と欧文文字の間に入るグルー／カーン
+\paragraph{和文関連の空白}
+2つの和文文字の間や，和文文字と欧文文字の間に入るグルー／カーン
       （両者をあわせて\textbf{JAglue}と呼ぶ）の挿入処理が0から書き直されている．
 %</ja>
 
@@ -402,7 +407,6 @@ in \LuaTeX-ja.
 ちょ\hbox{}っと
 \end{lstlisting}
 
-
 %<*en>
 \item In the process, two Japanese fonts which only differ in their ``real''
       fonts are identified.
@@ -413,28 +417,34 @@ in \LuaTeX-ja.
 %</ja>
 \end{itemize}
 
-%<*ja>
-\item ****版からは，不安定ながらも\LuaTeX-ja における縦組みをサポートしている．
-\LuaTeX のコールバックの制限などにより，特に異なった組方向のボックスを扱う場合には
-仕様が異なるので注意．
-%</ja>
-
 %<*en>
-\item Japanese characters in discretionary break (\cs{discretionary}) is not supported.
+\paragraph{Directions}
+From this version, \LuaTeX-ja supports vertical writing;
+but this feature must \emph{not} be confused with $\Omega$-style direction support of \LuaTeX\
+itself. ...
 %</en>
 %<*ja>
-\item \cs{discretionary} 内に直接和文文字を記述することはサポートされない．和文文字をどう
-      しても使いたい場合は \cs{hbox} で括ること．
+\paragraph{組方向}
+本版からは，不安定ながらも\LuaTeX-ja における縦組みをサポートしている．
+なお，\LuaTeX 本体も，$\Omega$流の組方向をサポートしているが，それとは全くの別物であること
+に注意してほしい．
+\LuaTeX のコールバックや実装により，特に異なった組方向のボックスを扱う場合には
+\cs{wd}, \cs{ht}, \cs{dp}等の仕様が異なるので注意．詳細は第\ref{sec-direction}節を参照．
 %</ja>
-\end{itemize}
 
 %<*en>
-For detailed information, see Part~\ref{part-imp}.
+\paragraph{\cs{discretionary}}
+Japanese characters in discretionary break (\cs{discretionary}) is not supported.
 %</en>
 %<*ja>
-詳細については第\ref{part-imp}部を参照．
+\paragraph{\cs{discretionary}}
+ \cs{discretionary} 内に直接和文文字を記述することは，\pTeX においても想定されていなかった
+ 感があるが．\LuaTeX-jaにおいても想定していない．和文文字をどう
+      しても使いたい場合は \cs{hbox} で括ること．
 %</ja>
 
+
+
 %<en>\subsection{Notations}
 %<ja>\subsection{用語と記法}
 
@@ -451,12 +461,12 @@ In this document, the following terms and notations are used:
       (see Subsection~\ref{ssec-setrange}).
 %</en>
 %<*ja>
-\item 文字は次の2種類に分けられる．この類別はユーザが後から変更可能である
+\item 文字は次の2種類に分けられる．この類別は固定されているものではなく，ユーザが後から変更可能である
       （\ref{ssec-setrange}節を参照）．
 %</ja>
 \begin{itemize}
 %<*en>
-\item \textbf{JAchar}: standing for characters which used in Japanese typesetting,
+\item \textbf{JAchar}: standing for characters which is used in Japanese typesetting,
       such as Hiragana,~Katakana, Kanji, and~other Japanese punctuation marks.
 %</en>
 %<*ja>
@@ -557,11 +567,11 @@ and \emph{Japanese fonts} for fonts used in \textbf{JAchar}.
 %<en>The following packages are needed for the \LuaTeX-ja\ package.
 %<ja>\LuaTeX-jaパッケージには，次のパッケージ類が必要である．
 \begin{itemize}
-\item \LuaTeX\ snapshot rev~5024 (or later)
+\item \LuaTeX\ beta-0.80.0 (or later)
 \item \Pkg{luaotfload} v2.5 (or later)
 \item \Pkg{adobemapping} (Adobe cmap and pdfmapping files)
 \item \Pkg{everysel} (if you want to use \LuaTeX-ja with \LaTeXe)
-%<en>\item \emph{IPAex fonts(\url{http://ipafont.ipa.go.jp/})}
+%<en>\item \emph{IPAex fonts}(\url{http://ipafont.ipa.go.jp/})
 %<ja>\item \emph{IPAexフォント(\url{http://ipafont.ipa.go.jp/})}
 \end{itemize}
 
@@ -717,9 +727,15 @@ Note that \texttt{*.\{dtx,ins\}} and \texttt{ltj-kinsoku\_make.tex} are not need
 %</ja>
 \end{enumerate}
 
-%<en>\subsection{Cautions}
-%<ja>\subsection{注意点}
-
+%<*en>
+\subsection{Cautions}
+For changes from \pTeX, see Subsection~\ref{ssec:chgptex}.
+%</en>
+%<*ja>
+\subsection{注意点}
+\pTeX からの変更点として，\ref{ssec:chgptex}節も熟読するのが望ましい．
+ここでは一般的な注意点を述べる．
+%</ja>
 \begin{itemize}
 %<*en>
 \item The encoding of your source file must be UTF-8. No other
@@ -1010,11 +1026,43 @@ Okumura), namely, \Pkg{ltjclasses}\footnote{%
 脚注とボトムフロートの順序は\LaTeX 通りとした．もし\pLaTeX の出力順序が好みならば，
 \Pkg{stfloats}パッケージを利用して
 \begin{lstlisting}
- \usepackage{stfloats} \fnbelowfloat
+ \usepackage{stfloats}\fnbelowfloat
 \end{lstlisting}
 のようにすればよい．\Pkg{footmisc}パッケージを \texttt{bottom}\ オプションを指定して
 読み込むという方法もあるが，それだとボトムフロートと脚注の間が開いてしまう．
 %</ja>
+%%% ↑は英訳しない
+
+%<*en>
+\paragraph{\Pkg{geometry} package and classes for vertical writing}
+It is well-known that the \Pkg{geometry} package produces the following error, when classes for
+vertical writing is used:
+%</en>
+%<*ja>
+\paragraph{縦組での\Pkg{geometry}パッケージ}
+\pLaTeX の縦組用標準クラスファイルでは\Pkg{geometry}パッケージを利用することは出来ず，
+%</ja>
+\begin{lstlisting}
+! Incompatible direction list can't be unboxed.
+\@begindvi ->\unvbox \@begindvibox 
+                                   \global \let \@begindvi \@empty 
+\end{lstlisting}
+%<*en>
+Now, \LuaTeX-ja automatically applies the patch \Pkg{lltjp-geometry} to the
+\Pkg{geometry} package, when the direction of the document is \emph{tate} (vertical
+writing).
+This patch \Pkg{lltjp-geometry} also can be used in \pLaTeX; for the detail, please refer 
+\url{lltjp-geometry.pdf}~(Japanese).
+%</en>
+%<*ja>
+というようなエラーが発生することが知られている．
+\LuaTeX-jaでは， \texttt{ltjtarticle.cls} といった縦組クラスの下でも
+\Pkg{geometry}パッケージが利用できるようにパッチ\Pkg{lltjp-geometry}パッケージを自動的に当てている．
+
+なお，\Pkg{lltjp-geometry}パッケージは\pTeX 系列でも明示的に読み込むことによって
+使用可能である．詳細や注意事項は \url{lltjp-geometry.pdf} を参照のこと．
+%</ja>
+
 
 %<en>\section{Changing Fonts}
 %<ja>\section{フォントの変更}
@@ -1038,8 +1086,7 @@ plain \TeX で和文フォントを変更するためには，
 For \LaTeXe, \LuaTeX-ja adopted most of the font selection system of \pLaTeXe\ (in \texttt{plfonts.dtx}).
 %</en>
 %<*ja>
-\LaTeXe については，\LuaTeX-jaではフォント選択システムを\pLaTeXe\ (\texttt{plfonts.dtx})
-の大部分をそのまま採用している．
+\LaTeX で用いる際には，\pLaTeXe\ (\texttt{plfonts.dtx})用のフォント選択機構の大部分を流用している．
 %</ja>
 \begin{itemize}
 %<*en>
@@ -1048,8 +1095,8 @@ For \LaTeXe, \LuaTeX-ja adopted most of the font selection system of \pLaTeXe\ (
       attributes of Japanese fonts.
 %</en>
 %<*ja>
-\item \cs{fontfamily}, \cs{fontseries}, \cs{fontshape}, そして
-      \cs{selectfont} が和文フォントの属性を変更するために使用できる．
+\item 和文フォントの属性を変更するには，\cs{fontfamily}, \cs{fontseries}, \cs{fontshape},
+      そしてそれらを反映させるために \cs{selectfont} を用いればよい．
 %</ja>
 
 %<*en>
@@ -1196,17 +1243,17 @@ this chapter. For the method, please see Subsection~\ref{ssec-math}.
 \label{ssec-fontspec}
 %<*en>
 To coexist with the \Pkg{fontspec} package, it is needed to load
-\Pkg{luatexja-fontspec} package in the preamble, as follows:
+the \Pkg{luatexja-fontspec} package in the preamble, as follows:
 \begin{quote}
 \ttfamily \textbackslash usepackage[<options>]\{luatexja-fontspec\}
 \end{quote}
 This \Pkg{luatexja-fontspec} package
 automatically loads \Pkg{luatexja} and \Pkg{fontspec}
-package, if needed.
+packages, if needed.
 %</en>
 %<*ja>
 \Pkg{fontspec}パッケージと同様の機能を和文フォントに対しても用いる場合，
-\Pkg{luatexja-fontspec}パッケージを読み込む：
+\Pkg{luatexja-fontspec}パッケージを読み込めばよい．
 \begin{quote}
 \ttfamily \textbackslash usepackage[<options>]\{luatexja-fontspec\}
 \end{quote}
@@ -1215,7 +1262,7 @@ package, if needed.
 %</ja>
 
 %<*en>
-In \Pkg{luatexja-fontspec} package, the following seven~commands are defined as
+In the \Pkg{luatexja-fontspec} package, the following seven~commands are defined as
 counterparts of original commands in the \Pkg{fontspec} package:
 %</en>
 %<*ja>
@@ -1282,6 +1329,8 @@ widths.  Also note that kerning information in a font is not used
 (that is, \texttt{kern} feature is set off) by default in these seven (or~eight) commands.
 This is because of the compatibility with previous versions of \LuaTeX-ja
 (see \ref{para-kern}).
+
+Below is an example of \cs{jfontspec}.
 %</en>
 %<*ja>
 \Pkg{luatexja-fontspec} パッケージのオプションは以下の通りである：
@@ -1302,13 +1351,13 @@ This is because of the compatibility with previous versions of \LuaTeX-ja
 また，これらの和文用のコマンドではフォント内のペアカーニング情報は標準では使用されない，
 言い換えれば \texttt{kern} featureは標準では無効化となっている．
 これは以前のバージョンの\LuaTeX-jaとの互換性のためである（\ref{para-kern}節を参照）．
+
+以下に\cs{jfontspec}の使用例を示す．
 %</ja>
 
 \begin{LTXexample}[width=0.4\textwidth]
-\fontspec[Numbers=OldStyle]{LMSans10-Regular}
 \jfontspec[CJKShape=NLC]{KozMinPr6N-Regular}
-JIS~X~0213:2004→辻
-
+JIS~X~0213:2004→辻\par
 \jfontspec[CJKShape=JIS1990]{KozMinPr6N-Regular}
 JIS~X~0208:1990→辻
 \end{LTXexample}
@@ -1318,20 +1367,35 @@ JIS~X~0208:1990→辻
 \label{ssec-preset}
 
 %<*en>
-To use standard Japanese font settings easily, one can load \Pkg{luatexja-preset}
+To use standard Japanese font settings easily, one can load the \Pkg{luatexja-preset}
 package with several options. This package provides functions in a part of
-\Pkg{japanese-otf} package and a part of \Pkg{PXchfon} package by Takayuki Yato,
-and loads \Pkg{luatexja-fontspec}, hence \Pkg{fontspec} internally.
-
-If you need to pass some options to \Pkg{fontspec}, load \Pkg{fontspec} manually
-before \Pkg{luatexja-preset}:
+\Pkg{japanese-otf} package and a part of \Pkg{PXchfon} package by Takayuki Yato.
 %</en>
 %<*ja>
 よく使われている和文フォント設定を一行で指定できるようにしたのが
 \Pkg{luatexja-preset}パッケージである．このパッケージは，
 \Pkg{otf}パッケージの一部機能と八登崇之氏による\Pkg{PXchfon}パッケージの一部機能とを
-合わせたような格好をしており，内部で\Pkg{luatexja-fontspec}，従って
-\Pkg{fontspec}を読み込んでいる．
+合わせたような格好をしている．
+%</ja>
+
+%<en>\paragraph{General options}
+%<ja>\paragraph{一般的なオプション}
+\begin{cslist}[before*=]
+
+\item[fontspec]
+%<*en>
+With this option, Japanese fonts are selected using functionality of 
+the \Pkg{luatexja-fontspec} package. This means that the \Pkg{fontspec} package is
+	     automatically loaded by this package.
+\emph{This option is enabled by default.}
+
+If you need to pass some options to \Pkg{fontspec}, load \Pkg{fontspec} manually
+before \Pkg{luatexja-preset}:
+%</en>
+%<*ja>
+\Pkg{luatexja-fontspec}パッケージの機能を用いて和文フォントを選択する．
+これは，\Pkg{fontspec}パッケージが自動で読み込まれることを意味する．
+\emph{このオプションは標準で有効になっている．}
 
 もし\Pkg{fontspec}パッケージに何らかのオプションを渡す必要がある
 \footnote{例えば，数式フォントまで置換されてしまい，\cs{mathit}によってギリシャ文字の
@@ -1343,9 +1407,23 @@ before \Pkg{luatexja-preset}:
 \usepackage[...]{luatexja-preset}
 \end{lstlisting}
 
-%<en>\paragraph{General options}
-%<ja>\paragraph{一般的なオプション}
-\begin{cslist}[before*=]
+\item[nfssonly]
+%<*ja>
+\LaTeX 標準のフォント選択機構(NFSS2)を用いて
+\texttt{ltjpm}（明朝），\texttt{ltjpg}（ゴシック），それに後に述べる \texttt{deluxe} オプ
+	     ションが指定された場合には \texttt{ltjpmg}（丸ゴシック）という
+3つの和文フォントファミリを定義し，これらを用いる．
+
+欧文フォントの指定で\Pkg{fontspec}パッケージを読み込んでいる場合でも
+\begin{lstlisting}
+\usepackage{fontspec}
+\usepackage[hiragino-pron,nfssonly]{luatexja-preset}
+\end{lstlisting}
+のように「和文側では\Pkg{fontspec}の機能は使わない，つまり\Pkg{luatexja-fontspec}は読み込
+	     まない」ことは可能である．一方，，
+パッケージ読み込み時に既に\Pkg{luatexja-fontspec}パッケージが読み込まれて
+	     いる場合は \texttt{nfssonly} オプションは無視される．
+%</ja>
 
 \item[nodeluxe]
 %<*en>
@@ -1355,7 +1433,7 @@ This means that \verb+\mcfamily\bfseries+, \verb+\gtfamily\bfseries+ and
 \emph{This option is enabled by default.}
 %</en>
 %<*ja>
-\LaTeXe 環境下での標準設定のように，明朝体・ゴシック体を各1ウェイトで使用する．
+\LaTeXe 環境下の標準設定のように，明朝体・ゴシック体を各1ウェイトで使用する．
 より具体的に言うと，この設定の下では
 \ \verb+\mcfamily\bfseries+, \verb+\gtfamily\bfseries+,
 \verb+\gtfamily\mdseries+はみな同じフォントとなる．
@@ -1369,23 +1447,32 @@ Use \textit{mincho} with two weights (medium~and~bold),
 because \textit{rounded gothic} is called \textit{maru gothic} (丸ゴシック) in Japanese.}.
 The heavy weight of \textit{gothic} can be used by ``changing the family'' \cs{gtebfamily},
 or \verb+\textgteb{...}+.
-This is because \Pkg{fontspec} package can handle only medium (\cs{mdseries}) and
+This is because the \Pkg{fontspec} package can handle only medium (\cs{mdseries}) and
 bold (\cs{bfseries}).
 %</en>
 %<*ja>
 明朝体2ウェイト・ゴシック体3ウェイトと，
 丸ゴシック体 (\cs{mgfamily}, \verb+\textmg{...}+) を使用可能とする．
-ゴシック体は細字・太字・極太の3ウェイトがあるが，
-極太ゴシック体はファミリの切り替え (\cs{gtebfamily}, \verb+\textgteb{...}+) %
-で実現している．\Pkg{fontspec}では通常 (\cs{mdseries}) と太字 (\cs{bfseries}) しか扱えないために
-このような中途半端な実装になっている．
+ゴシック体は中字・太字・極太の3ウェイトがあるが，
+極太ゴシック体を使う場合，
+\begin{itemize}
+ \item \cs{gtebfamily}, \verb+\textgteb{...}+
+ \item \cs{ebseries} （周囲がゴシック体のとき，\texttt{nfssonly} オプション指定時のみ）
+\end{itemize}
+のいずれかを用いる．標準で \cs{ebseries} が準備されていないのは，バージョンが古い
+\Pkg{fontspec}では中字(\cs{mdseries})と太字(\cs{bfseries})しか扱えなかった名残である．
 %</ja>
 \item[expert]
 %<*en>
 Use horizontal/vertical kana alternates, and define a command \cs{rubyfamily} to use kana
 characters designed for ruby.
 %</en>
-%<ja>横組・縦組専用仮名を用いる．また，\cs{rubyfamily} でルビ用仮名が使用可能となる．
+%<*ja>
+横組・縦組専用仮名を用いる．また，\cs{rubyfamily} でルビ用仮名が使用可能となる\footnote{%
+  \cs{rubyfamily}とはいいつつ，実際にはフォントファミリを切り替えるのではない（通常では
+  font featureの追加，\texttt{nfssonly} 指定時にはシェイプを \texttt{rb} に切り替え）．
+}．
+%</ja>
 \item[bold]
 %<en>Substitute bold series of \textit{gothic} for  bold series of \textit{mincho}.
 %<ja>「明朝の太字」をゴシック体の太字によって代替する．
@@ -1421,10 +1508,14 @@ We didn't taken account of  when both \texttt{90jis} and \texttt{jis2004} are sp
 %<*en>
 Besides \texttt{morisawa-pro}~and~\texttt{morisawa-pr6n} presets,
 fonts are specified by font name, not by file name.
+In following tables, starred fonts (e.g.~KozGo\dots-Regular) are used for medium series of \textit{gothic},
+\emph{if and only if \texttt{deluxe} option is specified}.
 %</en>
 %<*ja>
 \texttt{morisawa-pro}, \texttt{morisawa-pr6n}以外はフォントの指定は
 （ファイル名でなく）フォント名で行われる．
+以下の表において，*\,つきのフォント(e,g,~KozGo\dots-Regular)は，\emph{\texttt{deluxe}オプション指定時に}
+ゴシック体細字として用いられるものを示している．
 %</ja>
 \begin{cslist}[style=standard]
  \item[kozuka-pro] Kozuka Pro (Adobe-Japan1-4) fonts.
@@ -1467,16 +1558,7 @@ There is not rounded gothic family in Kozuka fonts.
 \end{tabular}
 \end{center}
 
-%<*en>
-In above table, starred fonts (KozGo\dots-Regular) are used for medium series of \textit{gothic},
-\emph{if and only if \texttt{deluxe} option is specified}.
-%</en>
-%<*ja>
-上の表において，*つきのフォント(KozGo\dots-Regular)は，\emph{\texttt{deluxe}オプション非指定時に}
-ゴシック体細字として用いられる．
-%</ja>
-
-%<ja>\medskip
+%<ja>\newpage
 
  \item[hiragino-pro]  Hiragino Pro (Adobe-Japan1-5) fonts.
 %<en>    \\*[-\dimexpr\medskipamount+\baselineskip\relax]
@@ -1519,7 +1601,7 @@ Std/StdNフォントであり，その他はAdobe-Japan1-5対応である．
 \end{tabular}
 \end{center}
 
-%<ja>\newpage
+%<ja>\medskip
 
  \item[morisawa-pro]  Morisawa Pro (Adobe-Japan1-4) fonts.
 %<en>    \\*[-\dimexpr\medskipamount+\baselineskip\relax]
@@ -1579,18 +1661,46 @@ Std/StdNフォントであり，その他はAdobe-Japan1-5対応である．
 \end{tabular}
 \end{center}
 
+ \item[moga-mobo]  MogaMincho, MogaGothic, and MoboGothic.
+These fonts can be downloaded from
+\url{http://yozvox.web.fc2.com/82A882B782B782DF8374834883938367.html}.
+
+\begin{center}\small
+\begin{tabular}{clll}
+\toprule
+\bf family&\bf series&\bf default, \texttt{90jis}~option&\bf \texttt{jis2004} option\\
+\midrule
+ &medium&Moga90Mincho&MogaMincho\\
+%<en>\smash{\raisebox{1.5ex}{\textit{mincho}}}%
+%<ja>\smash{\raisebox{1.5ex}{\gt 明朝}}%
+ &bold&Moga90Mincho Bold&MogaMincho Bold\\
+\midrule
+ &&Moga90Gothic&MogaGothic\\
+ &\smash{\raisebox{1.5ex}{medium}}
+ &Moga90Gothic&MogaGothic\\
+\cmidrule(l){2-4}
+%<en>\textit{gothic}%
+%<ja>\gt ゴシック
+ &bold&Moga90Gothic Bold&MogaGothic Bold\\
+ &heavy&Moga90Gothic Bold&MogaGothic Bold\\
+\midrule
+%<en>\textit{rounded gothic}
+%<ja>\gt 丸ゴシック
+&&Mobo90Gothic&MoboGothic\\
+\bottomrule
+\end{tabular}
+\end{center}
+
+
 \end{cslist}
 %<en>\paragraph{Presets for single weight}
 %<ja>\paragraph{単ウェイト用プリセット一覧}
 %<*en>
 Next, we describe settings for using only single weight.
-In four settings below, we use same fonts for medium and bold (and heavy) weights.
-(Hence \verb+\mcfamily\bfseries+ and \verb+\mcfamily\mdseries+ yields same Japanese fonts,
-even if \texttt{deluxe} option is also specified).
 %</en>
 %<*ja>
-次に，単ウェイト用の設定を述べる．この4設定では「細字」「太字」の区別はない．
-また，丸ゴシック体はゴシック体と同じフォントを用いる．
+次に，単ウェイト用の設定を述べる．この4設定では
+明朝体太字・丸ゴシック体はゴシック体と同じフォントが用いられる．
 %</ja>
 \par\nobreak\medskip
 {\centering\small
@@ -1649,11 +1759,11 @@ We can use HG~fonts bundled with Microsoft~Office for realizing multiple weights
 \multicolumn{3}{c}{HG Maru Gothic PRO}\\
 %</en>
 %<*ja>
-\gtfamily 明朝体細字
+\gtfamily 明朝体中字
 &IPA明朝&IPAex明朝&MS明朝\\\midrule
 \gtfamily 明朝体太字&
 \multicolumn{3}{c}{HG明朝E}\\\midrule
-\gtfamily ゴシック体細字\\
+\gtfamily ゴシック体中字\\
 　単ウェイト時
 &IPAゴシック&IPAexゴシック&MSゴシック\\
 　{\tt jis2004}指定時
@@ -1681,7 +1791,6 @@ are internally specified by:
 \end{description}
 %</en>
 %<*ja>
-\newpage
 なお，HG明朝E・HGゴシックE・HG創英角ゴシックUB・HG丸ゴシック体PROの4つについては，内部で
 \begin{description}
 \item[標準] フォント名（\texttt{HGMinchoE} など）
@@ -1699,16 +1808,15 @@ are internally specified by:
 Under \pLaTeX, \Pkg{japanese-otf} package (developed by Shuzaburo Saito) is
 used for typesetting characters which is in Adobe-Japan1-6 CID but not
 in JIS~X~0208. Since this package is widely used, \LuaTeX-ja
-supports some of functions in \Pkg{japanese-otf} package.
-If you want to use these functions, load \Pkg{luatexja-otf} package.
+supports some of functions in the \Pkg{japanese-otf} package, 
+as an external package \Pkg{luatexja-otf}.
 %</en>
 %<*ja>
 \subsection{\cs{CID}, \cs{UTF}と\Pkg{otf}パッケージのマクロ}
 \pLaTeX では，JIS~X~0208にないAdobe-Japan1-6の文字を出力するために，
 齋藤修三郎氏による\Pkg{otf}パッケージが用いられていた．このパッケージは
 広く用いられているため，\LuaTeX-jaにおいても\Pkg{otf}パッケージの機能の
-一部をサポートしている．これらの機能を用いるためには\Pkg{luatexja-otf}パッケージ
-を読み込めばよい．
+一部を（\Pkg{luatexja-otf}という別のパッケージとして）実装した．
 %</ja>
 
 \begin{LTXexample}
@@ -1725,7 +1833,7 @@ If you want to use these functions, load \Pkg{luatexja-otf} package.
 %<*ja>
 \Pkg{otf}パッケージでは，それぞれ次のようなオプションが存在した：
 \begin{cslist}
-\item[deluxe] 明朝体・ゴシック体各2ウェイトと，丸ゴシック体を扱えるようになる．
+\item[deluxe] 明朝体・ゴシック体各3ウェイトと，丸ゴシック体を扱えるようになる．
 \item[expert] 仮名が横組・縦組専用のものに切り替わり，ルビ用仮名も
 \ \cs{rubyfamily}\ によって扱えるようになる．
 \item[bold] ゴシック体を標準で太いウェイトのものに設定する．
@@ -1913,12 +2021,12 @@ these eight ranges belongs to the character range~217.
 \begin{description}
 %<*en>
 
-\item[Range~8${}^{\text{J}}$] The intersection of the upper half of ISO~8859-1
+\item[Range~8${}^{\kern.1em\text{J}}$] The intersection of the upper half of ISO~8859-1
 	 (Latin-1 Supplement) and JIS~X~0208 (a basic character set for Japanese). This character range
 	 consists of the following characters:
 %</en>
 %<*ja>
-\item[範囲8${}^{\text{J}}$] ISO~8859-1の上位領域（ラテン1補助）と
+\item[範囲8${}^{\kern.1em\text{J}}$] ISO~8859-1の上位領域（ラテン1補助）と
                              JIS~X~0208の共通部分．この文字範囲は
                              以下の文字で構成される：
 %</ja>
@@ -1958,11 +2066,11 @@ This range consists of the following Unicode ranges, \emph{except characters in
 \end{itemize}
 \end{multicols}
 %<*en>
-\item[Range~2${}^{\text{J}}$] Greek and Cyrillic letters. JIS~X~0208 (hence most of Japanese
+\item[Range~2${}^{\text{\kern.1emJ}}$] Greek and Cyrillic letters. JIS~X~0208 (hence most of Japanese
 	   fonts) has some of these characters.
 %</en>
 %<*ja>
-\item[範囲2${}^{\text{J}}$] ギリシャ文字とキリル文字．JIS~X~0208（したがってほとんどの
+\item[範囲2${}^{\text{\kern.1emJ}}$] ギリシャ文字とキリル文字．JIS~X~0208（したがってほとんどの
                              和文フォント）はこれらの文字を持つ．
 %</ja>
 \begin{multicols}{2}
@@ -1974,11 +2082,11 @@ This range consists of the following Unicode ranges, \emph{except characters in
 \end{itemize}
 \end{multicols}
 %<*en>
-\item[Range~3${}^{\text{J}}$] Punctuations and Miscellaneous symbols. The block list is
+\item[Range~3${}^{\text{\kern.1emJ}}$] Punctuations and Miscellaneous symbols. The block list is
 	   indicated in Table~\ref{table-rng3}.
 %</en>
 %<*ja>
-\item[範囲3${}^{\text{J}}$] 句読点と記号類．ブロックのリストは表\ref{table-rng3}%
+\item[範囲3${}^{\text{\kern.1emJ}}$] 句読点と記号類．ブロックのリストは表\ref{table-rng3}%
                              に示してある．
 %</ja>
 \begin{table}[!tb]
@@ -2028,8 +2136,8 @@ This range consists of the following Unicode ranges, \emph{except characters in
 \end{lstlisting}
 %<en>\item[Range~5${}^{\text{A}}$] Surrogates and Supplementary Private Use Areas.
 %<ja>\item[範囲5${}^{\text{A}}$] 代用符号と補助私用領域．
-%<en>\item[Range~6${}^{\text{J}}$] Characters used in Japanese. The block list is indicated in Table~\ref{table-rng6}.
-%<ja>\item[範囲6${}^{\text{J}}$] 日本語で用いられる文字．ブロックのリストは表\ref{table-rng6}に示す．
+%<en>\item[Range~6${}^{\text{\kern.1emJ}}$] Characters used in Japanese. The block list is indicated in Table~\ref{table-rng6}.
+%<ja>\item[範囲6${}^{\text{\kern.1emJ}}$] 日本語で用いられる文字．ブロックのリストは表\ref{table-rng6}に示す．
 \begin{table}[!tb]
 %<en>\caption{Unicode blocks in predefined character range~6.}\medskip
 %<ja>\caption{文字範囲6に指定されているUnicodeブロック．}
@@ -2057,11 +2165,11 @@ This range consists of the following Unicode ranges, \emph{except characters in
 \end{tabular}
 \end{table}
 %<*en>
-\item[Range~7${}^{\text{J}}$] Characters used in CJK languages, but not included in  Adobe-Japan1-6.
+\item[Range~7${}^{\text{\kern.1emJ}}$] Characters used in CJK languages, but not included in  Adobe-Japan1-6.
 The block list is indicated in Table~\ref{table-rng7}.
 %</en>
 %<*ja>
-\item[範囲7${}^{\text{J}}$] CJK言語で用いられる文字のうち，Adobe-Japan1-6に
+\item[範囲7${}^{\text{\kern.1emJ}}$] CJK言語で用いられる文字のうち，Adobe-Japan1-6に
                             含まれていないもの．
                             ブロックのリストは表\ref{table-rng7}に示す．
 %</ja>
@@ -2267,7 +2375,7 @@ Japanese fonts&\Param{yjabaselineshift}
 %</en>
 %<*ja>
 和文フォントと欧文フォントを合わせるためには，時々どちらかのベースラインの移動が
-必要になる．\pTeX ではこれは \cs{ybaselineshift} を設定することで
+必要になる．\pTeX ではこれは \cs{ybaselineshift}（または\cs{tbaselineshift}）を設定することで
 なされていた（\textbf{ALchar}のベースラインがその分だけ下がる）．しかし，日本語が主ではない
 文書に対しては，欧文フォントではなく和文フォントのベースラインを移動した方がよい．
 このため，\LuaTeX-jaでは欧文フォントのベースラインのシフト量
@@ -2391,6 +2499,49 @@ $\Phi\vdash F(x)\ \hbox{for all}\ x\in A$
 \end{table}
 %</ja>
 
+%<*en>
+\subsection{\emph{kinsoku} parameters and OpenType features}
+Among parameters which related to Japanese word-wrapping process (\emph{kinsoku shori}),
+\begin{quote}
+ \Param{jaxspmode},~\Param{alxspmode}, \Param{prebreakpenalty}, 
+ \Param{postbreakpenalty}~and~\Param{kcatcode}
+\end{quote}
+are stored by each character codes. ...
+
+For example, a fullwidth katakana ``ア'' on line~10 in the below input is replaced to
+its halfwidth variant ``ï½±'', by \verb+hwid+ feature. 
+However, the penalty inserted after it is 10 which is the \Param{postbreakpenalty} of
+``ア'', not 20.
+%</en>
+%<*ja>
+\subsection{禁則処理関連パラメータとfont feature}
+禁則処理や \Param{kanjiskip}, \Param{xkanjiskip} の挿入に関連したパラメータのうち
+\begin{quote}
+ \Param{jaxspmode},~\Param{alxspmode}, \Param{prebreakpenalty},
+ \Param{postbreakpenalty}, \Param{kcatcode}
+\end{quote}
+は，文字コードごとに設定する量である．
+
+\Pkg{fontspec}パッケージを使う（\ref{ssec-fontspec}節）場合など，
+各種のOpenType featureを適用することもあると思うが，前段落に述べたパラメータ類は，
+\emph{OpenType featureの適用前の文字コードによって判定される．}
+例えば，以下の例において10行目の「ア」は，\verb+hwid+ featureの適用により半角カタカナの「ｱ」
+に置き換わる．しかし，その直後に挿入される \Param{postbreakpenalty}は，置換前の「ア」に対する値10である．
+%</ja>
+
+\begin{LTXexample}[width=0.2\textwidth]
+\ltjsetparameter{postbreakpenalty={`ア, 10}}
+\ltjsetparameter{postbreakpenalty={`ï½±, 20}}
+
+\newcommand\showpostpena[1]{%
+  \leavevmode\setbox0=\hbox{#1\hbox{}}%
+  \unhbox0\setbox0=\lastbox\the\lastpenalty}
+
+\showpostpena{ア},
+\showpostpena{ï½±},
+{\addjfontfeatures{CharacterWidth=Half}\showpostpena{ア}}
+\end{LTXexample}
+
 \clearpage
 %<en>\part{Reference}
 %<ja>\part{リファレンス}
@@ -2574,7 +2725,7 @@ for \LuaTeX, \emph{to match the \cs{catcode} setting with that of \XeTeX.}
 %<en>&\bf row&\bf col.&\bf \pTeX&\bf \upTeX&\bf\LuaTeX-ja\\
 %<ja>&\bf 区&\bf 点&\bf \pTeX&\bf \upTeX&\fontseries{b}\selectfont\LuaTeX-ja\\
 \midrule
-\D 3000&1&1&N&N&Y\\
+%\D 3000&1&1&N&N&Y\\
 \D 30FB&1&6&N&Y&N\\
 \D 309B&1&11&N&Y&N\\
 \D 309C&1&12&N&Y&N\\
@@ -2582,16 +2733,18 @@ for \LuaTeX, \emph{to match the \cs{catcode} setting with that of \XeTeX.}
 \D FF3E&1&16&N&N&Y\\
 \D FFE3&1&17&N&N&Y\\
 \D FF3F&1&18&N&N&Y\\
-\D 30FD&1&19&N&Y&Y\\
-\D 30FE&1&20&N&Y&Y\\
-\D 309D&1&21&N&Y&Y\\
-\D 309E&1&22&N&Y&Y\\
+%\D 30FD&1&19&N&Y&Y\\
+%\D 30FE&1&20&N&Y&Y\\
+%\D 309D&1&21&N&Y&Y\\
+%\D 309E&1&22&N&Y&Y\\
 \D 3003&1&23&N&N&Y\\
 \D 4EDD&1&24&N&Y&Y\\
 \D 3005&1&25&N&N&Y\\
 \D 3006&1&26&N&N&Y\\
 \D 3007&1&27&N&N&Y\\
 \D 30FC&1&28&N&Y&Y\\
+\D FF0F&1&31&N&N&Y\\
+\D FF3C&1&32&N&N&Y\\
 \bottomrule
 \end{tabular}\qquad
 \begin{tabular}{cccccc}
@@ -2599,8 +2752,6 @@ for \LuaTeX, \emph{to match the \cs{catcode} setting with that of \XeTeX.}
 %<en>&\bf row&\bf col.&\bf \pTeX&\bf \upTeX&\bf\LuaTeX-ja\\
 %<ja>&\bf 区&\bf 点&\bf \pTeX&\bf \upTeX&\fontseries{b}\selectfont\LuaTeX-ja\\
 \midrule
-\D FF0F&1&31&N&N&Y\\
-\D FF3C&1&32&N&N&Y\\
 \D FF5C&1&35&N&N&Y\\
 \D FF0B&1&60&N&N&Y\\
 \D FF1D&1&65&N&N&Y\\
@@ -2618,7 +2769,6 @@ for \LuaTeX, \emph{to match the \cs{catcode} setting with that of \XeTeX.}
 %<en>\multicolumn{3}{c}{$\vphantom{\D 3000}$\hbox{}Cyrillic letters (row 7)}&N&N&Y\\
 %<ja>\multicolumn{3}{c}{$\vphantom{\D 3000}$\hbox{}ギリシャ文字（6区）}&Y&N&Y\\
 %<ja>\multicolumn{3}{c}{$\vphantom{\D 3000}$\hbox{}キリル文字（7区）}&N&N&Y\\
-$\vphantom{\D 3000}$\\
 \bottomrule
 \end{tabular}\hss}\par
 \end{table}
@@ -2645,12 +2795,10 @@ For the detail, see \url{https://github.com/h-kitagawa/kct}.
 異なっているところだけを載せると，表\ref{table-kcat-diff}のようになる．
 「・」「゛」「゜」「゠」を除けば，\LuaTeX-jaでは\upTeX より多くの文字が
 制御綴に使用可能になっている．
-\textbf{特に重要なのは，全角空白(\texttt{U+3000})が
-\LuaTeX-jaでは制御綴中に使用可能であることである．}
 
 JIS~X~0213の範囲に広げると，差異はさらに大きくなる．
 詳細については例えば \url{https://github.com/h-kitagawa/kct} 中の\
-\texttt{kct-uni-out.pdf} などを参照すること．
+\texttt{kct-out.pdf} などを参照すること．
 %</ja>
 
 
@@ -2693,7 +2841,7 @@ implemented vertical writing by rotating \texttt{TLT}-box by 90~degrees.
 %<*ja>
 \begin{tabular}{>{\bfseries}lcccc}
 \toprule
-&横組&縦組 &\cs{dtou}「dtou方向」&「utod方向」\\
+&横組&縦組 &「dtou方向」&「utod方向」\\
 \midrule
 命令&\cs{yoko}&\cs{tate}&\cs{dtou}&\cs{utod}\\
 字送り方向&水平右向き（→）&垂直下向き（↓）&垂直上向き（↑）&垂直下向き（↓）\\
@@ -3035,28 +3183,27 @@ To access box dimensions \emph{with respect to current direction},
 one have to use the following commands instead of \cs{wd} wtc.
 \begin{cslist}
 
- \item[\cs{ltjgetwd}\{<num>\}\textrm{, }\cs{ltjgetht}\{<num>\}\textrm{, }%
-  \cs{ltjgetdp}\{<num>\}]
+ \item[\cs{ltjgetwd}<num>\textrm{, }\cs{ltjgetht}<num>\textrm{, }%
+  \cs{ltjgetdp}<num>]
 These commands return \emph{an internal dimension} of \cs{box<num>} with respect to
 the current direction. One can use these in \cs{dimexpr} primitive, as the followings.
 \begin{lstlisting}
-\dimexpr 2\ltjgetwd{42}-3pt\relax, \the\ltjgetwd{1701}
+\dimexpr 2\ltjgetwd42-3pt\relax, \the\ltjgetwd1701
 \end{lstlisting}
-By its implementaion,  the argument must be grouped as \verb+\ltjgetwd{42}+,
-if the argument consists of more than one token.
+The following is an example.
 \begin{LTXexample}[width=0.3\textwidth]
 \parindent0pt
 \setbox32767=\hbox{\yoko よこぐみ}
 \fboxsep=0mm\fbox{\copy32767}
 \vbox{\hsize=20mm
-\yoko YOKO \the\ltjgetwd{32767}, \\
-  \the\ltjgetht{32767}, \\ \the\ltjgetdp{32767}.}
+\yoko YOKO \the\ltjgetwd32767, \\
+  \the\ltjgetht32767, \\ \the\ltjgetdp32767.}
 \vbox{\hsize=20mm\raggedleft
-\tate TATE \the\ltjgetwd{32767}, \\
-  \the\ltjgetht{32767}, \\ \the\ltjgetdp{32767}.}
+\tate TATE \the\ltjgetwd32767, \\
+  \the\ltjgetht32767, \\ \the\ltjgetdp32767.}
 \vbox{\hsize=20mm\raggedleft
-\dtou DTOU \the\ltjgetwd{32767}, \\
-  \the\ltjgetht{32767}, \\ \the\ltjgetdp{32767}.}
+\dtou DTOU \the\ltjgetwd32767, \\
+  \the\ltjgetht32767, \\ \the\ltjgetdp32767.}
 \end{LTXexample}
 
  \item[\cs{ltjsetwd}<num>=<dimen>\textrm{, }\cs{ltjsetht}<num>=<dimen>\textrm{, }%
@@ -3093,32 +3240,27 @@ These commands set the dimension of \cs{box<num>}. Unlike \cs{ltjgetwd}, one doe
 
 \begin{cslist}
 
- \item[\cs{ltjgetwd}\{<num>\}\textrm{, }\cs{ltjgetht}\{<num>\}\textrm{, }%
-  \cs{ltjgetdp}\{<num>\}]
+ \item[\cs{ltjgetwd}<num>\textrm{, }\cs{ltjgetht}<num>\textrm{, }%
+  \cs{ltjgetdp}<num>]
 現在の組方向に応じたボックスの寸法の取得を行う．結果は内部長さであるため，
 \begin{lstlisting}
-\dimexpr 2\ltjgetwd{42}-3pt\relax, \the\ltjgetwd{1701}
+\dimexpr 2\ltjgetwd42-3pt\relax, \the\ltjgetwd1701
 \end{lstlisting}
-のように \cs{wd}<num> の代わりとして扱うことができる．引数が1桁の場合は，
-\cs{ltjgetwd3} のように引数をグループで括らなくても良いが，そうでない場合は
-（通常の命令への引数のように）\verb+\ltjgetwd{42}+ とグループに括る必要がある%
-\footnote{\cs{afterassignment} を利用して実装すればグループに括る必要がなくなるのでは，と思
-	      うかもしれないが，それでは本文中に書いた例のように \cs{dimexpr} 中で使用でき
-	      なくなってしまう．}．
+のように \cs{wd}<num> の代わりとして扱うことができる．
 使用例は以下の通りである．
 \begin{LTXexample}[width=0.3\textwidth]
 \parindent0pt
 \setbox32767=\hbox{\yoko よこぐみ}
 \fboxsep=0mm\fbox{\copy32767}
 \vbox{\hsize=20mm
-\yoko YOKO \the\ltjgetwd{32767}, \\
-  \the\ltjgetht{32767}, \\ \the\ltjgetdp{32767}.}
+\yoko YOKO \the\ltjgetwd32767, \\
+  \the\ltjgetht32767, \\ \the\ltjgetdp32767.}
 \vbox{\hsize=20mm\raggedleft
-\tate TATE \the\ltjgetwd{32767}, \\
-  \the\ltjgetht{32767}, \\ \the\ltjgetdp{32767}.}
+\tate TATE \the\ltjgetwd32767, \\
+  \the\ltjgetht32767, \\ \the\ltjgetdp32767.}
 \vbox{\hsize=20mm\raggedleft
-\dtou DTOU \the\ltjgetwd{32767}, \\
-  \the\ltjgetht{32767}, \\ \the\ltjgetdp{32767}.}
+\dtou DTOU \the\ltjgetwd32767, \\
+  \the\ltjgetht32767, \\ \the\ltjgetdp32767.}
 \end{LTXexample}
 
  \item[\cs{ltjsetwd}<num>=<dimen>\textrm{, }\cs{ltjsetht}<num>=<dimen>\textrm{, }%
@@ -3185,7 +3327,7 @@ Returned value&\texttt{4}&\texttt{3}&\texttt{1}&\texttt{11}&\texttt{0}\\
 \end{center}
 
 \begin{LTXexample}[width=0.3\textwidth]
-\leavevmode\def\DIR{\ltjgetparameter{ direction}}
+\leavevmode\def\DIR{\ltjgetparameter{direction}}
 \hbox{\yoko\DIR}, \hbox{\tate\DIR},
 \hbox{\dtou\DIR}, \hbox{\utod\DIR},
 \hbox{\tate$\hbox{tate math: \DIR}$}
@@ -3200,7 +3342,7 @@ Returned value&\texttt{4}&\texttt{3}&\texttt{1}&\texttt{11}&\texttt{0}\\
 \ifnum\ltjgetparameter{boxdir}{200}=4
 \end{lstlisting}
 のように行うことができる．
-\cs{iftdir} は少々面倒であるが
+\cs{iftdir} は少々面倒であるが，8で割った余りが3であるか否かを判断すれば良いから
 \begin{lstlisting}
 \ifnum\numexpr
   \ltjgetparameter{direction}-(\ltjgetparameter{direction}/8)*8=3
@@ -4171,8 +4313,8 @@ we specify <ratio> to
 
 %<*ja>
 \paragraph{文字クラスの決定}
-文字からその文字の属する文字クラスを算出する過程は少々複雑である．
-次の内容を一部に含んだ \texttt{jfm-test.lua} を用いて説明する．
+文字からその文字の属する文字クラスを算出する過程について，
+次の内容を含んだ \texttt{jfm-test.lua} を用いて説明する．
 %</ja>
 %<*en>
 \paragraph{Character to character classes}
@@ -4216,17 +4358,17 @@ applying font features by \Pkg{luaotfload}}.
 \item JFMによれば，この「ﾋ」のグリフの文字クラスは2000である．
 \item 以上により文字クラス2000とみなされるため，結果として「ﾋ」の幅は半角だと認識される．
 \end{enumerate}
-この例は，\emph{文字クラスの決定はfont featureの適用によるグリフ置換の後に行われる}ことを
+この例は，\emph{文字クラスの決定はfont featureの適用によるグリフ置換の結果に基づく}ことを
 示している．
 %</ja>
 
 %<*en>
-However, ...
-Consider the following input:
+However, if the class determined by the glyph after application of features is zero,
+\LuaTeX-ja adopts the class determined by the glyph \emph{before} application of features.
+The following input is an example.
 %</en>
 %<*ja>
-但し，JFMによって決まる置換後のグリフの文字クラスが0である場合は，
-状況は異なる．
+但し，JFMによって決まる置換後のグリフの文字クラスが0である場合は，置換前の文字クラスを採用する．
 %</ja>
 \begin{LTXexample}[width=0.3\textwidth]
 \jfont\a=file:KozMinPr6N-Regular.otf:jfm=test;+vert
@@ -4234,11 +4376,11 @@ Consider the following input:
 \end{LTXexample}
 %<*en>
 Here, the character class of the ideographic full stop ``。''~(\texttt{U+3002}) is determined
-as following:
+as follows:
 \begin{enumerate}
 \item As the case of ``ヒ'', the ideographic full stop ``。'' is converted to its vertical
-      form ``\char"FE12''~(\texttt{U+FE12}).%"
-\item The character class of ``\char"FE12'' is \emph{zero}.
+      form ``\char"FE12''~(\texttt{U+FE12}) by \verb+vert+ feature.%"
+\item The character class of ``\char"FE12'', according to the JFM  is \emph{zero}.
 \item However, \LuaTeX-ja remembers that this ``\char"FE12'' is obtained from ``。'' by
       font features. The character class of ``。'' is \emph{non-zero value}, namely, 2000.
 \item Hence the ideographic full stop ``。'' in above belongs the character class~2000.
@@ -4706,8 +4848,8 @@ is the position of \verb+hpack_filter+ callback in the source
 of \LuaTeX, see Section~\ref{sec-para}.
 %</en>
 %<*ja>
-先に述べたように，\LuaTeX-jaのほとんどの内部パラメータにアクセスするには
-\cs{ltjsetparameter} と \cs{ltjgetparameter} を用いる．
+先に述べたように，\LuaTeX-jaの内部パラメータにアクセスするには
+\cs{ltjsetparameter}（または \cs{ltjglobalsetparameter}）と \cs{ltjgetparameter} を用いる．
 \LuaTeX-jaが\pTeX のような文法（例えば，\verb+\prebreakpenalty`）=10000+）を
 採用しない理由の一つは，\LuaTeX のソースにおける \verb+hpack_filter+
 コールバックの位置にある．\ref{sec-para}章を参照．
@@ -4717,24 +4859,22 @@ of \LuaTeX, see Section~\ref{sec-para}.
 \cs{ltjsetparameter} and \cs{ltjglobalsetparameter} are commands
 for assigning parameters. These take one argument which is a
 \texttt{<key>=<value>} list.
-The list of allowed keys are described in the next subsection.
 The difference between
 \cs{ltjsetparameter} and \cs{ltjglobalsetparameter} is only the
 scope of assignment;
 \cs{ltjsetparameter} does a local assignment and
 \cs{ltjglobalsetparameter} does a global one.
-They also obey the value of \cs{globaldefs},
-like other assignment.
+They also obey the value of \cs{globaldefs}, like other assignments.
 %</en>
 %<*ja>
 \cs{ltjsetparameter} と \cs{ltjglobalsetparameter} はパラメータを
-指定するための命令である．これらは\texttt{<key>=<value>}のリストを
-引数としてとる．許されるキーの一覧は次の節にある．
+指定するための命令で，\texttt{<key>=<value>}のリストを
+引数としてとる．
 \cs{ltjsetparameter} と \cs{ltjglobalsetparameter} の違いはスコープの
 違いのみで，
-\cs{ltjsetparameter} はローカルな指定，\cs{ltjglobalsetparameter} は
-グローバルな指定を行う．
-これらは他のパラメータ指定と同様に \cs{globaldefs} の値に従う．
+\cs{ltjsetparameter} はローカルな設定を行うのに対し，
+\cs{ltjglobalsetparameter} はグローバルな設定を行う．
+また，他のパラメータ指定と同様に \cs{globaldefs} の値にも従う．
 %</ja>
 
 %<*en>
@@ -4745,7 +4885,7 @@ in \pTeX, and symbols beside each parameter has the following meaning:
 %<*ja>
 以下は \cs{ltjsetparameter} に指定することができるパラメータの一覧である．
 [\cs{cs}]は\pTeX における対応物を示す．
-また，それぞれのパラメータの右上にある記号には次の意味がある：
+また，それぞれのパラメータの右上の記号には次の意味がある：
 %</ja>
 \begin{itemize}
 %<*en>
@@ -4786,7 +4926,7 @@ At the present version, the lowermost bit of <natural number> indicates
 	     (see the description of \Param{jcharwidowpenalty} above).
 %</en>
 %<*ja>
-文字コードが<chr\_code>の文字が持つ付加的な属性値(attribute)．
+文字コードが<chr\_code>の文字が持つ付加的な属性値．
 現在のバージョンでは，<natural number>の最下位ビットが，その文字が句読点と
 みなされるかどうかを表している（上の\Param{jcharwidowpenalty}の記述を参照）．
 %</ja>
@@ -4803,7 +4943,15 @@ At the present version, the lowermost bit of <natural number> indicates
 \end{lstlisting}
 と，最大値の10000が標準で指定されている．他にも，小書きのカナなど，絶対禁止とい
 	     うわけではないができれば行頭にはきて欲しくない場合に，0と
-	     10000の間の値を指定するのも有用であろう.
+	     10000の間の値を指定するのも有用であろう．
+
+\pTeX では，\cs{prebreakpenalty}, \cs{postbreakpenalty}において，
+\begin{itemize}
+\item 一つの文字に対して，pre, postどちらか一つしか指定することができない%
+  \footnote{後から指定した方で上書きされる．}
+\item pre, post合わせて256文字分の情報を格納することしかできない
+\end{itemize}
+という制限があったが，\LuaTeX-jaではこれらの制限は解消されている．
 %</ja>
 %<*en>
 Set a penalty which is inserted automatically before the character <chr\_code>,
@@ -4813,8 +4961,15 @@ with one of closing brackets ``〗'', so \LuaTeX-ja sets
 \ltjsetparameter{prebreakpenalty={`〙,10000}}
 \end{lstlisting}
 by default.
-%</en>
 
+\pTeX\ has following restrictions on \cs{prebreakpenalty} and \cs{postbreakpenalty},
+but they don't exist in \LuaTeX-ja:
+\begin{itemize}
+ \item Both \cs{prebreakpenalty} and \cs{postbreakpenalty} cannot be set
+for the same character.
+ \item We can set \cs{prebreakpenalty} and \cs{postbreakpenalty} up to 256~characters.
+\end{itemize}
+%</en>
 
 \item[\DParam{postbreakpenalty}\,=\{<chr\_code>,<penalty>\}$^\ast$]
 	   [\cs{postbreakpenalty}]\
@@ -4822,25 +4977,10 @@ by default.
 %<*ja>
 文字コード<chr\_code>の\textbf{JAchar}が行末にくることを抑止するために，
 	     この文字の後に挿入/追加されるペナルティの量を指定する．
-
-\pTeX では，\cs{prebreakpenalty}, \cs{postbreakpenalty}において，
-\begin{itemize}
-\item 一つの文字に対して，pre, postどちらか一つしか指定することができなかっ
-      た（後から指定した方で上書きされる）．
-\item pre, post合わせて256文字分の情報を格納することしかできなかった．
-\end{itemize}
-という制限があったが，\LuaTeX-jaではこれらの制限は解消されている．
 %</ja>
 %<*en>
 Set a penalty which is inserted automatically after the character <chr\_code>,
 to prevent a line ends with this character.
-\pTeX\ has following restrictions on \cs{prebreakpenalty} and \cs{postbreakpenalty},
-but they don't exist in \LuaTeX-ja:
-\begin{itemize}
- \item Both \cs{prebreakpenalty} and \cs{postbreakpenalty} cannot be set
-for the same character.
- \item We can set \cs{prebreakpenalty} and \cs{postbreakpenalty}  up to 256~characters.
-\end{itemize}
 %</en>
 
 \item[\DParam{jatextfont}\,=\{<jfam>,<jfont\_cs>\}$^\ast$]
@@ -4984,6 +5124,7 @@ the behavior of this assignment is undefined.
 
 \end{cslist}
 
+
 \subsection{\cs{ltjgetparameter}}
 \label{ssec-getpar}
 %<*en>
@@ -5003,8 +5144,8 @@ always takes a parameter name as first argument.
 
 %<*en>
 \emph{The return value of\/ \cs{ltjgetparameter} is
-always a string}. This is outputted by \texttt{tex.write()}, so any
-character other than space~``\texttt{\char32}''~(\texttt{U+0020}) has the category code
+always a string}, which is outputted by \texttt{tex.write()}.
+Hence any character other than space~``\texttt{\char32}''~(\texttt{U+0020}) has the category code
 12~(other), while the space has 10~(space).
 %</en>
 %<*ja>
@@ -5036,7 +5177,7 @@ returns 1 or 0, not
 %<*ja>
 \verb+\ltjgetparameter{autospacing}+ と \verb+\ltjgetparameter{autoxspacing}+ は，
 \texttt{true}や\texttt{false}を返すの\emph{ではなく}，
-1と0のいずれかを返すことに注意，
+1か0のいずれかを返すことに注意，
 %</ja>
 
 \item
@@ -5045,7 +5186,7 @@ If first argument is one of the
 following, an additional argument---a character code, for example---is needed.
 %</en>
 %<*ja>
-第1引数が次のいずれかの場合には，さらに文字コードを第二引数としてとる．
+第1引数が次のいずれかの場合には，さらに文字コードを第2引数としてとる．
 %</ja>
 \begin{quote}
 \sffamily
@@ -5154,10 +5295,134 @@ by the following:
   <chr\_code>\verb+}}+\\\null\hfill\verb+% 0 if JAchar, 1 if ALchar+
 \end{quote}
 
+%<*en>
+\item Because the returned value is string, the following conditionals do not work
+if \Param{kanjiskip} (or~\Param{xkanjiskip}) has the stretch part or the shrink part.
+\begin{lstlisting}
+\ifdim\ltjgetparameter{kanjiskip}>\z@ ... \fi
+\ifdim\ltjgetparameter{xkanjiskip}>\z@ ... \fi
+\end{lstlisting}
+The correct way is using a temporary register.
+\begin{lstlisting}
+\@tempskipa=\ltjgetparameter{kanjiskip} \ifdim\@tempskipa>\z@ ... \fi
+\@tempskipa=\ltjgetparameter{xkanjiskip}\ifdim\@tempskipa>\z@ ... \fi
+\end{lstlisting}
+%</en>
+%<*ja>
+\item 返り値が文字列であることから，\Param{kanjiskip}や\Param{xkanjiskip}を直接
+\ \cs{ifdim} を使って比較することは望ましくない．伸び量や縮み量を持っている時には，
+次はエラーを発生させる：
+\begin{lstlisting}
+\ifdim\ltjgetparameter{kanjiskip}>\z@ ... \fi
+\ifdim\ltjgetparameter{xkanjiskip}>\z@ ... \fi
+\end{lstlisting}
+レジスタに一旦代入するのが良い：
+\begin{lstlisting}
+\@tempskipa=\ltjgetparameter{kanjiskip} \ifdim\@tempskipa>\z@ ... \fi
+\@tempskipa=\ltjgetparameter{xkanjiskip}\ifdim\@tempskipa>\z@ ... \fi
+\end{lstlisting}
+%</ja>
+
+\end{itemize}
+
+%<*ja>
+\subsection{\cs{ltjsetparameter} の代替}
+原則として各種内部パラメータの設定には \cs{ltjsetparameter} もしくは
+\ \cs{ltjglobalsetparameter}\ を用いることになるが，
+\cs{ltjsetparameter} の実行には時間がかかるという難点があり，
+\LuaTeX-ja の内部ではより高速に実行できる別の形式を用いている．
+\emph{本節は一般利用者むけの内容ではない．}
+
+\paragraph{\Param{kanjiskip}, \Param{xkanjiskip} の設定}
+\pLaTeXe 新ドキュメントクラスでは，
+\begin{lstlisting}
+\def\@setfontsize#1#2#3{%
+  ...
+  \kanjiskip=0zw plus .1zw minus .01zw
+  \ifdim\xkanjiskip>\z@
+    \if@slide \xkanjiskip=0.1em \else
+      \xkanjiskip=0.25em plus 0.15em minus 0.06em
+    \fi
+  \fi}
+\end{lstlisting}
+と，フォントサイズを変更するごとに \cs{kanjiskip}, \cs{xkanjiskip} を変更している．
+この \cs{@setfontsize} は文書の中で多数回実行されるので．
+\LuaTeX-ja 用に素直に書き換えた
+\begin{lstlisting}
+  \ltjsetparameter{kanjiskip=0\zw plus .1\zw minus .01\zw}
+  \@tempskipa=\ltjgetparameter{xkanjiskip}
+  \ifdim\@tempskipa>\z@
+    \if@slide 
+      \ltjsetparameter{xkanjiskip=0.1em}
+    \else
+      \ltjsetparameter{xkanjiskip=0.25em plus 0.15em minus 0.06em}
+    \fi
+  \fi
+\end{lstlisting}
+としたのではタイプセットが遅くなってしまう．
+そこで，\cs{ltjsetparameter} の中で
+\begin{itemize}
+\item \cs{globaldefs} の値を読み取る \cs{ltj@setpar@global}
+\item \Param{kanjiskip} の設定を行う \cs{ltjsetkanjiskip}
+\item \Param{xkanjiskip} の設定を行う \cs{ltjsetxkanjiskip}
 \end{itemize}
+を独立させ，\Pkg{ltjsclasses}では，
+\begin{lstlisting}
+  \ltj@setpar@global
+  \ltjsetkanjiskip{\z@ plus .1\zw minus .01\zw}
+  \@tempskipa=\ltjgetparameter{xkanjiskip}
+  \ifdim\@tempskipa>\z@
+    \if@slide 
+      \ltjsetxkanjiskip.1em
+    \else
+      \ltjsetxkanjiskip.25em plus .15em minus .06em
+    \fi
+  \fi
+\end{lstlisting}
+としている．
+\cs{ltj@setpar@global}を直前に実行せず，単独で
+\cs{ltjsetkanjiskip}, \cs{ltjsetxkanjiskip}を実行することは想定されていないので注意．
 
 
 
+\paragraph{ベースライン補正量の設定}
+\pLaTeX の\Pkg{ascmac}パッケージでは，縦組の欧文ベースライン補正量の一時待避・復帰処理に
+\ \cs{@saveybaselineshift}\ という寸法レジスタを用い
+\begin{lstlisting}
+\@savetbaselineshift\tbaselineshift\tbaselineshift\z@
+...
+\tbaselineshift\@savetbaselineshift
+\end{lstlisting}
+という処理を行っている．
+
+これを\LuaTeX-ja 用に \cs{ltjsetparameter} を使って書き直すと，
+\begin{lstlisting}
+\@savetbaselineshift\ltjgetparameter{talbaselineshift}
+\ltjsetparameter{talbaselineshift=\z@}
+...
+\ltjsetparameter{talbaselineshift=\@savetbaselineshift}
+\end{lstlisting}
+となる．
+
+さて，縦組の欧文ベースライン補正量\Param{talbaselineshift}は，
+実際には \cs{ltj@tablshift} という属性レジスタに格納されている
+（\ref{sec-para}\nobreak 節参照）．属性レジスタは長さではなく整数値を格納する\footnote{%
+  従って，\texttt{\textbackslash @savetbaselineshift=\textbackslash ltj@tablshift}\ 
+  のように記述することはできない．属性レジスタを \cs{tbaselineshift} という名称にしなかっ
+  たのはそのためである．
+}ものであり，\cs{ltj@tablshift} は補正量を sp 単位で保持することから，
+上記のコードと同じ内容をより速い以下のコードで実現することができる．
+\begin{lstlisting}
+\@savetbaselineshift\ltj@tablshift sp%
+\ltj@tablshift\z@
+...
+\ltj@tablshift\@savetbaselineshift
+\end{lstlisting}
+この手法は \Pkg{ascmac} パッケージの\LuaTeX-ja対応パッチ \Pkg{lltjp-tascmac.sty} で
+実際に用いられている．\Pkg{lltjp-tascmac.sty} は自動的に読み込まれるので，
+ユーザは何も気にせず普通に \Pkg{ascmac} パッケージを \cs{usepackage} で読みこめば良い．
+%</ja>
+
 
 %<en>\section{Other Commands for plain \TeX\ and \LaTeXe}
 %<ja>\section{plainでも\LaTeX でも利用可能なその他の命令}
@@ -7225,7 +7490,7 @@ process it}, if and only if the following three conditions are satisfied:
 \paragraph{Remark}
 The following example shows the major difference from the behavior of \pTeX.
 \begin{LTXexample}
-\fontspec[Ligatures=TeX]{TeX Gyre Termes}
+\fontspec[Ligatures=TeX]{Linux Libertine O}
 \ltjsetparameter{autoxspacing=false}
 \ltjsetparameter{jacharrange={-6}}xあ
 y\ltjsetparameter{jacharrange={+6}}zい
@@ -8100,7 +8365,7 @@ then the patch \Pkg{lltjp-listings} is loaded automatically at \verb+\begin{docu
 意識する必要はない．
 %</ja>
 
-%<en>\subsection{Notes}
+%<en>\subsection{Notes and additional keys}
 %<ja>\subsection{注意}
 %<*en>
 \paragraph{Escaping to \LaTeX}
@@ -8142,6 +8407,20 @@ instead of ``\verb+\ほげ+''.
 「\cs{}\IVSA FFFFF」というcontrol symbolが実行されることになる．
 %</ja>
 
+%<*en>
+\paragraph{Variation selectors}
+\Pkg{lltjp-listings} add two keys, namely \texttt{vsraw}~and~\texttt{vscmd},
+which specify how variation selectors are treated in 
+\texttt{lstlisting} or other enviroments.
+Note that these additional keys are not usable in the preamble, 
+since \Pkg{lltjp-listings} is loaded at \verb+\begin{document}+.
+
+\texttt{vsraw} is a key which takes a boolean value, and its default value is
+false.
+\begin{itemize}
+ \item If the \texttt{vsraw} key is true, then
+variation selectors are ``combined'' with the previous character.
+%</en>
 %<*ja>
 \paragraph{異体字セレクタの扱い}
 \texttt{lstlisting} 環境などの内部にある異体字セレクタを扱うため，
@@ -8154,21 +8433,31 @@ instead of ``\verb+\ほげ+''.
  \item trueの場合は，異体字セレクタは「直前の文字に続けて」出力される．
 もしもIVSサポート（\ref{ssec-ltjotf}節）が有効になっていた場合は，
 以下の例（左側は入力，右側はその出力）のようになる．
+%</ja>
 \begin{LTXexample}
 \begin{lstlisting}[vsraw=true]
 葛󠄀城市，葛󠄁飾区，葛西
 \end{lstlisting}
 \end{LTXexample}
+%<*en>
+\item If the \texttt{vsraw} key is false, then 
+variation selectors are typeset by an appropriate command, which is specified by
+      the \texttt{vscmd} key.
+The default setting of the \texttt{vscmd} key produces the following.
+%</en>
+%<*ja>
 \item falseの場合は，異体字セレクタは適当な命令によって「見える形で」出力される．
 どのような形で出力されるかを規定するのが \texttt{vscmd} キーであり，
 \Pkg{lltjp-listings} の標準設定では以下の例の右側のように出力される．
+%</ja>
 \begin{LTXexample}
 \begin{lstlisting}[vsraw=false,
    vscmd=\ltjlistingsvsstdcmd]
 葛󠄀城市，葛󠄁飾区，葛西
 \end{lstlisting}
 \end{LTXexample}
-ちなみに，本ドキュメントでは次のようにしている：
+%<ja> ちなみに，本ドキュメントでは次のようにしている：
+%<en> For example, the following code is the setting of the \texttt{vscmd} key in this document.
 \begin{lstlisting}[numbers=left]
 \def\IVSA#1#2#3#4#5{%
   \textcolor{blue}{\raisebox{3.5pt}{\tt%
@@ -8182,10 +8471,56 @@ instead of ``\verb+\ほげ+''.
 \lstset{vscmd=\IVSB}
 \end{lstlisting}
 \end{itemize}
-既定の出力命令を復活させたい場合は\ \verb+vsraw=\ltjlistingsvsstdcmd+\
+%<*en>
+The default output command of variation selectors is stored in \verb+\ltjlistingsvsstdcmd+.
+%</en>
+%<*ja>
+既定の出力命令を復活させたい場合は\ \verb+vscmd=\ltjlistingsvsstdcmd+\
 とすれば良い．
 %</ja>
 
+%<*en>
+\paragraph{The \texttt{doubleletterspace} key}
+Even the column format is \texttt{[c]fixed}, sometimes characters are not vertically aligned.
+The following example  is typeset with \texttt{basewidth=2em}, and
+you'll see the leftmost ``\texttt{H}'' are not vertically aligned.
+\begin{lstlisting}[basewidth=2em, basicstyle=\tt,numbers=left]
+:H:
+:HHHH:
+\end{lstlisting}
+
+\Pkg{lltjp-listing} adds the \texttt{doubleletterspace} key (not activated by default, for
+compatibility) to
+improve the situation, namely doubles inter-character space in each output unit.
+With this key, the above input now produces better output.
+\begin{lstlisting}[basewidth=2em, basicstyle=\tt,numbers=left, doubleletterspace]
+:H:
+:HHHH:
+\end{lstlisting}
+%</en>
+%<*ja>
+\paragraph{\texttt{doubleletterspace}キー}
+\Pkg{listings}パッケージで列揃えが \texttt{[c]fixed} となっている場合でも，
+場合によっては文字が縦に揃わない場合もある．
+例を以下に示そう．これは強調するために \texttt{basewidth=2em} を設定している．
+\begin{lstlisting}[basewidth=2em, basicstyle=\tt,numbers=left]
+:H:
+:HHHH:
+\end{lstlisting}
+1行目と2行目の「\texttt{H}」の位置が揃っていないが，
+これは出力単位ごとに，先頭・末尾・各文字間に同じ量の空白を挿入することによる．
+
+\Pkg{lltjp-listing}では，このような症状を改善させるために \texttt{doubleletterspace} キー
+を追加した（標準では互換性のために無効になっている）．このキーを有効にすると，
+出力単位中の各文字間の空白を2倍にすることで文字を揃いやすくしている．
+上と同じものを \texttt{doubleletterspace} キーを有効にして組んだものが以下であり，
+きちんと「\texttt{H}」の位置が揃っていることが分かる．
+\begin{lstlisting}[basewidth=2em, basicstyle=\tt,numbers=left, doubleletterspace]
+:H:
+:HHHH:
+\end{lstlisting}
+%</ja>
+
 %<en>\subsection{Class of Characters}
 %<ja>\subsection{文字種}
 
@@ -8307,7 +8642,7 @@ Prev&Kanji&\multicolumn{4}{c}{\hrulefill \ outputs\ \hrulefill}&collects\\
 \end{itemize}
 
 %<*en>
-Characters above \texttt{U+0080} \emph{except Variation Selectors}
+Characters above or equal to~\texttt{U+0080} \emph{except Variation Selectors}
 are classified into above 5~classes by the following rules:
 %</en>
 %<*ja>
@@ -8315,7 +8650,7 @@ are classified into above 5~classes by the following rules:
 Letter, Other, Kanji, Open, Closeのどれに属するかは次によって決まる：
 %</ja>
 \begin{itemize}
-%<en>\item \textbf{ALchar}s above \texttt{U+0080} are classified as Letter.
+%<en>\item \textbf{ALchar}s above or equal to~\texttt{U+0080} are classified as Letter.
 %<ja>\item （\texttt{U+0080}以降の）\textbf{ALchar}は，すべてLetter扱いである．
 
 %<en>\item \textbf{JAchar}s are classified in the order as follows:
@@ -8527,10 +8862,11 @@ OpenTypeフォントでもTrueTypeフォントでもIVS情報が格納されて
 \texttt{fontloader} の呼び出しでかなり時間を消費することから，
 %%% to_table を使わなくしたことで，メモリ使用量は減った
 IVS情報をキャッシュに保存することで2回目以降の実行時間を節約している．
+%</ja>
 
 
+%<*ja>
 \section{複数フォントの「合成」（未完）}
-
 \section{\LuaTeX-jaにおけるキャッシュ}
 \Pkg{luaotfload}パッケージが，各TrueType・OpenTypeフォントの情報を
 キャッシュとして保存しているのと同様の方法で，
@@ -8601,7 +8937,7 @@ CMapが必要である．
 \item[ltj-cid-auto-adobe-japan1.lua]
 The font table of a CID-keyed non-embedded Japanese font.
 This is loaded in every run.
-It is created from two CMaps, \texttt{UniJIS2004-UTF32-H} and
+It is created from three CMaps, \texttt{UniJIS2004-UTF32-\{H,V\}} and
 	     \texttt{Adobe-Japan1-UCS2},
 and this is why these two CMaps are needed in the first run of \LuaTeX-ja.
 
@@ -8631,10 +8967,10 @@ The following is the structure of the that table.
 \bf \texttt{cid} key&\bf name of the cache &
 \multicolumn{2}{c}{\bf used CMaps}\\
 \midrule
-Adobe-Japan1-*&ltj-cid-auto-adobe-japan1.lua&UniJIS2004-UTF32-H&Adobe-Japan1-UCS2\\
-Adobe-Korea1-*&ltj-cid-auto-adobe-korea1.lua&UniKS-UTF32-H&Adobe-Korea1-UCS2\\
-Adobe-GB1-*&ltj-cid-auto-adobe-gb1.lua&UniGB-UTF32-H&Adobe-GB1-UCS2\\
-Adobe-CNS1-*&ltj-cid-auto-adobe-cns1.lua&UniCNS-UTF32-H&Adobe-CNS1-UCS2\\
+Adobe-Japan1-*&ltj-cid-auto-adobe-japan1.lua&UniJIS2004-UTF32-*&Adobe-Japan1-UCS2\\
+Adobe-Korea1-*&ltj-cid-auto-adobe-korea1.lua&UniKS-UTF32-*&Adobe-Korea1-UCS2\\
+Adobe-GB1-*&ltj-cid-auto-adobe-gb1.lua&UniGB-UTF32-*&Adobe-GB1-UCS2\\
+Adobe-CNS1-*&ltj-cid-auto-adobe-cns1.lua&UniCNS-UTF32-*&Adobe-CNS1-UCS2\\
 \bottomrule
 \end{tabular}
 \end{table}