OSDN Git Service

doc/luatexja.dtx: supply \makeatletter
[luatex-ja/luatexja.git] / doc / luatexja.dtx
index 92cce1a..44a9214 100644 (file)
@@ -44,6 +44,7 @@
 \usepackage[margin=25mm,lmargin=30mm,rmargin=30mm,footskip=6mm]{geometry}
 \usepackage{luatexja-adjust}\ltjdisableadjust
 \parskip=\smallskipamount
+\makeatletter
 \renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
     {3.25ex \@plus1ex \@minus.2ex}%
     {-1em}%
@@ -77,6 +78,7 @@
   explpreset={numberstyle=\tiny, numbers=left, numbersep=1em, columns=fixed}
 }
 % Suppress output from showexpl to stdout.
+\makeatletter
 \let\SX@Info\relax
 
 %%%%%%%% colors
@@ -274,8 +276,8 @@ 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, 
-implementing all feature of \pTeX\ is impossible, 
+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}.
@@ -300,7 +302,7 @@ For more detailed information, see Part~\ref{part-imp} or other sections of this
 %</ja>
 
 %<*en>
-\paragraph{Command names} \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>
@@ -313,7 +315,7 @@ For more detailed information, see Part~\ref{part-imp} or other sections of this
 \prebreakpenalty`ぁ=100
 \ifydir ... \fi
 \end{verbatim}
-%<en> However, we cannot use them under \LuaTeX-ja. 
+%<en> However, we cannot use them under \LuaTeX-ja.
 %<en> Instead of them, we have to write as the following.
 %<ja> は\LuaTeX-jaには存在しない.\LuaTeX-jaでは以下のように記述することになる.
 \begin{verbatim}
@@ -323,7 +325,7 @@ For more detailed information, see Part~\ref{part-imp} or other sections of this
 \ltjsetparameter{prebreakpenalty={`ぁ,100}}
 \ifnum\ltjgetparemeter{direction}=4 ... \fi
 \end{verbatim}
-%<*en> 
+%<*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>
@@ -418,13 +420,13 @@ The insertion process of glues/kerns between two Japanese
 
 %<*en>
 \paragraph{Directions}
-From this version, \LuaTeX-ja supports vertical writing;
+From version~20150420.0, \LuaTeX-ja supports vertical writing;
 but this feature must \emph{not} be confused with $\Omega$-style direction support of \LuaTeX\
 itself. ...
 %</en>
 %<*ja>
 \paragraph{組方向}
-版からは,不安定ながらも\LuaTeX-ja における縦組みをサポートしている.
+20150420.0版からは,不安定ながらも\LuaTeX-ja における縦組みをサポートしている.
 なお,\LuaTeX 本体も,$\Omega$流の組方向をサポートしているが,それとは全くの別物であること
 に注意してほしい.
 \LuaTeX のコールバックや実装により,特に異なった組方向のボックスを扱う場合には
@@ -519,21 +521,21 @@ and \emph{Japanese fonts} for fonts used in \textbf{JAchar}.
 %<ja>\paragraph{プロジェクトWiki} プロジェクトWikiは構築中である.
 %<*en>
 \begin{itemize}
-\item \url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage%28en%29} (English)
-\item \url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage} (Japanese)
-\item \url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage%28zh%29} (Chinese)
+\item \url{https://osdn.jp/projects/luatex-ja/wiki/FrontPage%28en%29} (English)
+\item \url{https://osdn.jp/projects/luatex-ja/wiki/FrontPage} (Japanese)
+\item \url{https://osdn.jp/projects/luatex-ja/wiki/FrontPage%28zh%29} (Chinese)
 \end{itemize}
 %</en>
 %<*ja>
 \begin{itemize}
-\item \url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage}(日本語)
-\item \url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage%28en%29}(英語)
-\item \url{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage%28zh%29}(中国語)
+\item \url{https://osdn.jp/projects/luatex-ja/wiki/FrontPage}(日本語)
+\item \url{https://osdn.jp/projects/luatex-ja/wiki/FrontPage%28en%29}(英語)
+\item \url{https://osdn.jp/projects/luatex-ja/wiki/FrontPage%28zh%29}(中国語)
 \end{itemize}
 %</ja>
 
-%<en>This project is hosted by SourceForge.JP.
-%<ja>本プロジェクトはSourceForge.JPのサービスを用いて運営されている.
+%<en>This project is hosted by OSDN.
+%<ja>本プロジェクトはOSDNのサービスを用いて運営されている.
 
 %<en>\paragraph{Members}\
 %<ja>\paragraph{開発メンバー}\
@@ -564,12 +566,13 @@ and \emph{Japanese fonts} for fonts used in \textbf{JAchar}.
 %<ja>\subsection{インストール}
 
 %<en>The following packages are needed for the \LuaTeX-ja\ package.
-%*ja>\LuaTeX-jaパッケージの動作には次のパッケージ類が必要である.
+%<ja>\LuaTeX-jaパッケージの動作には次のパッケージ類が必要である.
 \begin{itemize}
 \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)
+\item \Pkg{fontspec} v2.4
 %<en>\item \emph{IPAex fonts} (\url{http://ipafont.ipa.go.jp/})
 %<ja>\item \emph{IPAexフォント(\url{http://ipafont.ipa.go.jp/})}
 \end{itemize}
@@ -629,11 +632,11 @@ W32\TeX においてはIPAexフォントは \texttt{luatexja.tar.xz} 内にあ
 \begin{itemize}
 \item Clone the Git repository:
 \begin{lstlisting}
-$ git clone git://git.sourceforge.jp/gitroot/luatex-ja/luatexja.git
+$ git clone git://git.osdn.jp/gitroot/luatex-ja/luatexja.git
 \end{lstlisting}
 \item Download the \texttt{tar.gz} archive of HEAD in the \texttt{master} branch from
 \begin{flushleft}
-\url{http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git;a=snapshot;h=HEAD;sf=tgz}.
+\url{http://git.osdn.jp/view?p=luatex-ja/luatexja.git;a=snapshot;h=HEAD;sf=tgz}.
 \end{flushleft}
 \end{itemize}
 
@@ -647,11 +650,11 @@ the forefront of development is not the \texttt{master} branch.
 \begin{itemize}
 \item Gitリポジトリをクローンする:
 \begin{lstlisting}
-$ git clone git://git.sourceforge.jp/gitroot/luatex-ja/luatexja.git
+$ git clone git://git.osdn.jp/gitroot/luatex-ja/luatexja.git
 \end{lstlisting}
 \item \texttt{master}ブランチのスナップショット(\texttt{tar.gz}形式)をダウンロードする.
 \begin{flushleft}
-\url{http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git;a=snapshot;h=HEAD;sf=tgz}.
+\url{http://git.osdn.jp/view?p=luatex-ja/luatexja.git;a=snapshot;h=HEAD;sf=tgz}.
 \end{flushleft}
 \end{itemize}
 \texttt{master}ブランチ(従って,CTAN内のアーカイブも)はたまにしか更新されないことに注意.
@@ -742,6 +745,20 @@ For changes from \pTeX, see Subsection~\ref{ssec:chgptex}.
       従来日本語の文字コードとして用いられてきたEUC-JPやShift-JISは使用できない.
 %</ja>
 %<*en>
+\item By default, \LuaTeX-ja uses Japanese fonts to typeset Greek and Cyrillic letters,
+      and some Unicode symbols such as \P~and~\S. To change this behavior, 
+      put \lstinline!\ltjsetparameter{jacharrange={-2,-3,-8}}! in the preamble.
+      For the detailed description, see Subsection~\ref{ssec-setrange}.
+%</en>
+%<*ja>
+\item 
+標準では,\LuaTeX-jaはギリシャ文字やキリル文字,それに\P や\S などの記号を和文フォントを使っ
+      て組む.ギリシャ語などを本格的に組むなどこの状況が望ましくない場合,
+      プリアンブルに \lstinline!\ltjsetparameter{jacharrange={-2,-3,-8}}! を入れると
+      上記種類の文字は欧文フォントを用いて組まれるようになる.
+      詳しい説明は\ref{ssec-setrange}節を参照してほしい.
+%</ja>
+%<*en>
 \item \LuaTeX-ja is very slower than \pTeX.
 Generally speaking, LuaJIT\TeX\ processes \LuaTeX-ja
 about 30\% faster than \LuaTeX, but not always.
@@ -752,9 +769,10 @@ about 30\% faster than \LuaTeX, but not always.
 LuaJIT\TeX を用いると\LuaTeX のだいたい1.3倍の速度で動くようであるが,
 IPA mj明朝などの大きいフォントを用いた場合には\LuaTeX よりも遅くなることもある.
 %</ja>
+
 \item%
 %<*en>
-\textbf{Outdated note for MiK\TeX\ users}\quad
+\textbf{(Outdated) note for MiK\TeX\ users}\quad
 \LuaTeX-ja requires that several CMap files%
 \footnote{\texttt{UniJIS2004-UTF32-\{H,V\}} and \texttt{Adobe-Japan1-UCS2}.}
 must be found from \LuaTeX.
@@ -767,7 +785,7 @@ so you will encounter an error like the following:
 \LuaTeX-jaが動作するためには,\emph{導入・更新後の初回起動時に}
 \texttt{UniJIS2004-UTF32-\{H,V\}}, \texttt{Adobe-Japan1-UCS2}という3つのCMapが
 \LuaTeX によって見つけられることが必要である.
-しかしやや古いMiK\TeX ではそのようになっていないので,次のエラーが発生するだろう:
+しかし古いバージョンのMiK\TeX ではそのようになっていないので,次のエラーが発生するだろう:
 %</ja>
 \begin{lstlisting}
 ! LuaTeX error ...iles (x86)/MiKTeX 2.9/tex/luatex/luatexja/ltj-rmlgbm.lua
@@ -776,13 +794,14 @@ bad argument #1 to 'open' (string expected, got nil)
 
 %<*en>
 If so, please execute a batch file which is written on
-\href{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage%28en%29}{ the Project Wiki (English)}.
+\href{https://osdn.jp/projects/luatex-ja/wiki/FrontPage%28en%29}{ the Project Wiki (English)}.
 This batch file creates a temporary directory, copy CMaps in it,
-run \LuaTeX-ja in this directory, and finally delete the temporary directory.
+run a test file which loads \LuaTeX-ja in this directory, 
+and finally delete the temporary directory.
 %</en>
 %<*ja>
 そのような場合には,
-\href{http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage%28en%29}{%
+\href{https://osdn.jp/projects/luatex-ja/wiki/FrontPage%28en%29}{%
   プロジェクトWiki英語版トップページ}中に書かれているバッチファイルを
 実行して欲しい.このバッチファイルは,作業用ディレクトリにCMap達を
 コピーし,その中で\LuaTeX-ja の初回起動を行い,作業用ディレクトリを消す作業をしている.
@@ -1040,14 +1059,14 @@ vertical writing is used:
 %</ja>
 \begin{lstlisting}
 ! Incompatible direction list can't be unboxed.
-\@begindvi ->\unvbox \@begindvibox 
-                                   \global \let \@begindvi \@empty 
+\@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 
+This patch \Pkg{lltjp-geometry} also can be used in \pLaTeX; for the detail, please refer
 \url{lltjp-geometry.pdf}~(Japanese).
 %</en>
 %<*ja>
@@ -1134,7 +1153,7 @@ auto select&\cs{fontencoding}&\cs{fontfamily}&---&---&\cs{usefont}\\
       \verb+\fontencoding{+<encoding>\verb+}+ changes the encoding of alphabetic fonts
       or Japanese fonts depending on the argument. For example,
       \verb+\fontencoding{JY3}+ changes the encoding of Japanese fonts to
-      \texttt{JY3},and \verb+\fontencoding{T1}+ changes the encoding of
+      \texttt{JY3}, and \verb+\fontencoding{T1}+ changes the encoding of
       alphabetic fonts to \texttt{T1}.
       \cs{fontfamily} also changes the current Japanese font family,
       the current alphabetic font family, \emph{or both}.
@@ -1380,7 +1399,7 @@ package with several options. This package provides functions in a part of
 
 \item[fontspec]
 %<*en>
-With this option, Japanese fonts are selected using functionality of 
+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.}
@@ -1816,7 +1835,7 @@ 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 the \Pkg{japanese-otf} package, 
+supports some of functions in the \Pkg{japanese-otf} package,
 as an external package \Pkg{luatexja-otf}.
 %</en>
 %<*ja>
@@ -1927,8 +1946,8 @@ parameters, you have to use commands \cs{ltjsetparameter} and
 用いる.
 %</ja>
 
-%<en>\subsection{Editing the Range of \textbf{JAchar}s}
-%<ja>\subsection{\textbf{JAchar}の範囲の設定}
+%<en>\subsection{Range of \textbf{JAchar}s}
+%<ja>\subsection{\textbf{JAchar}の範囲}
 \label{ssec-setrange}
 
 %<*en>
@@ -2436,18 +2455,20 @@ xyz漢字
 
 %<*en>
 Note that setting positive \Param{yalbaselineshift}~or~\Param{talbaselineshift}
-parameters does not increase the depth of one-letter ``syllable'' $p$ of \textbf{Alchar}, if
+parameters does not increase the depth of one-letter \emph{syllable} $p$ of \textbf{Alchar}, if
 its left-protrusion~(\cs{lpcode}) and right-protrusion~(\cs{rpcode}) are both non-zero.
 This is because
 \begin{itemize}
-\item These two parameters are implemented by setting yoffset field of a
+\item These two parameters are implemented by setting \texttt{yoffset} field of a
 glyph node, and this does not increase the depth of the glyph.
 \item To cope with the above situation, \LuaTeX-ja automatically supplies
-a rule in every ``syllable''.
-\item However, we cannot use this ``supplying a rule'' method if \dots
+a rule in every syllable.
+\item However, we cannot use this ``supplying a rule'' method if a syllable comprises just
+      one letter whose \cs{lpcode}~and~\cs{rpcode} are both non-zero.
 \end{itemize}
 
-This problem does not apply for \Param{yjabaselineshift}~nor~\Param{tjabaselineshift}.
+This problem does not apply for \Param{yjabaselineshift}~nor~\Param{tjabaselineshift},
+becuse a \emph{JAchar} is encapsulated by a horizontal box if needed.
 %</en>
 %<*ja>
 なお,以下の場合には1文字の\textbf{ALchar}からなる「音節」の深さは増加しないことに注意.
@@ -2456,6 +2477,7 @@ This problem does not apply for \Param{yjabaselineshift}~nor~\Param{tjabaselines
  \item 「音節」を構成する唯一の文字$p$の
 左余白への突出量(\cs{lpcode}),右余白への突出量(\cs{rpcode})がどちらも非零である.
 \end{itemize}
+\emph{JAchar}は必要に応じて1文字ずつボックスにカプセル化されるため,
 \Param{yjabaselineshift},~\Param{tjabaselineshift}パラメータについてはこのような問題は起こらない.
 %</ja>
 
@@ -2511,13 +2533,13 @@ $\Phi\vdash F(x)\ \hbox{for all}\ x\in A$
 \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{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. 
+its halfwidth variant ``ア'', by \verb+hwid+ feature.
 However, the penalty inserted after it is 10 which is the \Param{postbreakpenalty} of
 ``ア'', not 20.
 %</en>
@@ -2639,7 +2661,7 @@ and \LuaTeX-ja can control these four kinds separately:
 \begin{itemize}
  \item
 \emph{Distinction between \textbf{JAchar} or \textbf{ALchar}}
-is controlled by using the character range, see Subsection~\ref{ssec-setrange}.
+is controlled by the character range, see Subsection~\ref{ssec-setrange}.
  \item
 \emph{Whether the character can be used in a control word}
 is controlled by setting \cs{catcode} to 11~(enabled) or 12~(disabled), as usual.
@@ -2647,7 +2669,7 @@ is controlled by setting \cs{catcode} to 11~(enabled) or 12~(disabled), as usual
 \emph{Whether \Param{jcharwidowpenalty} can be inserted before the character}
 is controlled by the lowermost bit of the \Param{kcatcode} parameter.
  \item
-\emph{Ignoring linebreak after a \textbf{JAchar}} is always ignored.
+\emph{Linebreak after a \textbf{JAchar}} does not produce a space.
 \end{itemize}
 %</en>
 %<*ja>
@@ -2661,25 +2683,26 @@ is controlled by the lowermost bit of the \Param{kcatcode} parameter.
 \LuaTeX 自身の \cs{catcode} でよい
  \item[\Param{jcharwidowpenalty}が挿入可か]
 \Param{kcatcode}パラメータの最下位ビット
- \item[直後の改行の無視]
-日本語しか想定していないので\textbf{JAchar}については一律有効
+ \item[直後の改行]
+日本語しか想定していないので,\textbf{JAchar}直後の改行で半角スペースが挿入されることはない.
 \end{description}
 %</ja>
 
 %<*en>
-Default setting of \cs{catcode} of \LuaTeX\ can be found
-in \texttt{luatex-unicode-letters.tex},
-which is based on \texttt{unicode-letters.tex} (for \XeTeX).
+Default setting of \cs{catcode} of Unicode characters are located in
+\begin{description}
+ \item[plain \LuaTeX] \texttt{luatex-unicode-letters.tex}, which is based on \texttt{unicode-letters.tex}
+(for \XeTeX).
+ \item[\LuaLaTeX] now included in \LaTeX\ kernel  as~\texttt{unicode-letters.def}.
+\end{description}
 However, the default setting of \cs{catcode} differs
 between \XeTeX\ and \LuaTeX, by the following reasons:
 \begin{itemize}
- \item \texttt{luatex-unicode-letters.tex} is based on old \texttt{unicode-letters.tex}.
- \item The latter half of \texttt{unicode-letters.tex} sets
-\cs{catcode} of Kanji and kana characters to 11,
-via setting \cs{XeTeXcharclass}.
+ \item (plain format) \texttt{luatex-unicode-letters.tex} is based on old \texttt{unicode-letters.tex}.
+ \item The latter half of \texttt{unicode-letters.tex}~and~\texttt{unicode-letters.def}
+sets\cs{catcode} of Kanji and kana characters to 11, via setting \cs{XeTeXcharclass}.
 
-However, this latter half is simply omitted in
-\texttt{luatex-unicode-letters.tex}, hence
+However, this latter half does not exist (plain case), or not executed (\LaTeX~case) in \LuaTeX, hence
 \cs{catcode} of Kanji and kana characters remains 12 in \LuaTeX.
 \end{itemize}
 In other words, Kanji nor kana characters cannot be used in
@@ -2694,21 +2717,25 @@ for \LuaTeX, \emph{to match the \cs{catcode} setting with that of \XeTeX.}
 %<*ja>
 ネイティブにUnicode全部の文字を扱える\XeTeX や\LuaTeX では,
 文字が制御綴内で使用できるかは通常の欧文文字と同じく \cs{catcode}
-で指定することとなる.\XeTeX における \cs{catcode} の初期設定は\
-\texttt{unicode-letters.tex} 中に記述されており,\LuaTeX ではそれを
+で指定することとなる.plain \XeTeX における \cs{catcode} の初期設定は\
+\texttt{unicode-letters.tex} 中に記述されており,plain \LuaTeX ではそれを
 元にした \texttt{luatex-unicode-letters.tex} を用いている.
+\LaTeX では \cs{catcode} の設定はカーネルに \texttt{unicode-letters.def} として統合され.
+このファイルを\XeLaTeX, \LuaLaTeX の両方が用いている.
+
 
 だが,\XeTeX における \cs{catcode} の初期設定と
 \LuaTeX におけるそれは一致していない:
 \begin{itemize}
  \item \texttt{luatex-unicode-letters.tex} の元になった\
 \texttt{unicode-letters.tex} が古い
- \item \texttt{unicode-letters.tex} 後半部では
+ \item \texttt{unicode-letters.tex} 後半部や \texttt{unicode-letters.def} 後半部では
 \cs{XeTeXcharclass} の設定を行なっており,
 それによって漢字や仮名の \cs{catcode} が11に設定されている.
 
 しかし,\texttt{luatex-unicode-letters.tex} ではこの「後半部」が
-まるごと省略されており,漢字や仮名の \cs{catcode} は12のまま.
+まるごと省略されており,また\LuaLaTeX でも \texttt{unicode-letters.def} 後半部は実行されな
+       い.従って漢字や仮名の \cs{catcode} は12のままになっている.
 \end{itemize}
 言い換えると,\LuaTeX の初期状態では漢字や仮名を制御綴内に
 使用することはできない.
@@ -2788,8 +2815,6 @@ which can be used in a control word differ in \pTeX, in \upTeX,~and~in \LuaTeX-j
 Table~\ref{table-kcat-diff} shows the difference.
 Except for four characters ``・'',~``゛'', ``゜'',~``゠'',
 \LuaTeX-ja admits more characters in a control word than \upTeX.
-\emph{Note that the ideographic space~\texttt{U+3000} can be used
-in a control word in \LuaTeX-ja.}
 
 Difference becomes larger, if we consider
 non-kanji JIS~X~0213 characters.
@@ -3216,7 +3241,7 @@ The following is an example.
 
  \item[\cs{ltjsetwd}<num>=<dimen>\textrm{, }\cs{ltjsetht}<num>=<dimen>\textrm{, }%
   \cs{ltjsetdp}<num>=<dimen>]
-These commands set the dimension of \cs{box<num>}. Unlike \cs{ltjgetwd}, one does not need
+These commands set the dimension of \cs{box<num>}. One does not need
        to group the argument <num>; four calls of \cs{ltjsetwd} below have the same meaning.
 \begin{lstlisting}
 \ltjsetwd42 20pt,  \ltjsetwd42=20pt,  \ltjsetwd=42 20pt,  \ltjsetwd=42=20pt
@@ -3289,7 +3314,7 @@ These commands set the dimension of \cs{box<num>}. Unlike \cs{ltjgetwd}, one doe
 %<*en>
 \subsection{Getting current direction}
 The \Param{direction} parameter returns the current direction, and
-the \Param{boxdir} parameter (with the argumant <num>)
+the \Param{boxdir} parameter (with the argument <num>)
 returns the direction of a box register \cs{box}<num>.
 The returned value of these parameters are a \emph{string}:
 \begin{center}
@@ -3746,7 +3771,7 @@ letter-spacing and the width of italic correction are not correct:
 但し,以下の例の3行目に示すように,明示的に \texttt{vert}, \texttt{vrt2}(のいずれか)の
 有効・無効を指定した場合は別である.
 \begin{lstlisting}
-\tfont\S=file:KozMinPr6N-Regular.otf:jfm=ujisv 
+\tfont\S=file:KozMinPr6N-Regular.otf:jfm=ujisv
     % vert and vrt2 are automatically activated
 \tfont\T=file:KozMinPr6N-Regular.otf:jfm=ujisv;-vert % vert and vrt2 are not activated
 \end{lstlisting}
@@ -4716,7 +4741,7 @@ glueであれば,\texttt{[$j$]=\{false, <spec\_node>, <ratio>, <icflag>\}} で
 \end{itemize}
 \item[ascent\textrm{, }descent]
 ……
-\item[chars\_cbcache] 
+\item[chars\_cbcache]
 ……
 \end{cslist}
 %</ja>
@@ -5372,7 +5397,7 @@ The correct way is using a temporary register.
   \ltjsetparameter{kanjiskip=0\zw plus .1\zw minus .01\zw}
   \@tempskipa=\ltjgetparameter{xkanjiskip}
   \ifdim\@tempskipa>\z@
-    \if@slide 
+    \if@slide
       \ltjsetparameter{xkanjiskip=0.1em}
     \else
       \ltjsetparameter{xkanjiskip=0.25em plus 0.15em minus 0.06em}
@@ -5392,7 +5417,7 @@ The correct way is using a temporary register.
   \ltjsetkanjiskip{\z@ plus .1\zw minus .01\zw}
   \@tempskipa=\ltjgetparameter{xkanjiskip}
   \ifdim\@tempskipa>\z@
-    \if@slide 
+    \if@slide
       \ltjsetxkanjiskip.1em
     \else
       \ltjsetxkanjiskip.25em plus .15em minus .06em
@@ -5427,7 +5452,7 @@ The correct way is using a temporary register.
 さて,縦組の欧文ベースライン補正量\Param{talbaselineshift}は,
 実際には \cs{ltj@tablshift} という属性レジスタに格納されている
 (\ref{sec-para}\nobreak 節参照).属性レジスタは長さではなく整数値を格納する\footnote{%
-  従って,\texttt{\textbackslash @savetbaselineshift=\textbackslash ltj@tablshift}\ 
+  従って,\texttt{\textbackslash @savetbaselineshift=\textbackslash ltj@tablshift}\
   のように記述することはできない.属性レジスタを \cs{tbaselineshift} という名称にしなかっ
   たのはそのためである.
 }ものであり,\cs{ltj@tablshift} は補正量を sp 単位で保持することから,
@@ -5690,18 +5715,18 @@ but on the other hand \cs{zw}~and~\cs{zh} are specified by JFM.
 \item[\cs{DeclareTateKanjiEncoding}\{<encoding>\}\{<text-settings>\}\{<math-settings>\}]
 
 %<*en>
-In NFSS2 under \LuaTeX-ja, distinction between alphabetic font families
-            and Japanese font families are only made by their
-            encodings. For example, encodings OT1 and T1 are for
-            alphabetic font families, and a Japanese font family cannot
+In NFSS2 under \LuaTeX-ja, distinction between alphabetic fonts
+            and Japanese fonts are only made by their
+            encodings. For example, encodings OT1 and T1 are encodings for
+            alphabetic fonts, and Japanese fonts cannot
             have these encodings. These command define a new encoding
             scheme for Japanese font families.
 %</en>
 %<*ja>
-\LuaTeX-jaã\81®NFSS2ã\81«ã\81\8aã\81\84ã\81¦ã\81¯ï¼\8c欧æ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªã\81¨å\92\8cæ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ª
+\LuaTeX-jaã\81®NFSS2ã\81«ã\81\8aã\81\84ã\81¦ã\81¯ï¼\8c欧æ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\81¨å\92\8cæ\96\87ã\83\95ã\82©ã\83³ã\83\88
 そのエンコーディングによってのみ区別される.
-ä¾\8bã\81\88ã\81°ï¼\8cOT1ã\81¨T1ã\81®ã\82¨ã\83³ã\82³ã\83¼ã\83\87ã\82£ã\83³ã\82°ã\81¯æ¬§æ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªã\81«å¯¾ã\81\99ã\82\8bã\82\82ã\81®であり,
\92\8cæ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªã\81¯ã\81\93ã\82\8cã\82\89ã\81®ã\82¨ã\83³ã\82³ã\83¼ã\83\87ã\82£ã\83³ã\82°ã\82\92æ\8c\81ã\81¤ã\81\93ã\81¨ã\81¯ã\81§ã\81\8dã\81ªã\81\84ï¼\8e
+ä¾\8bã\81\88ã\81°ï¼\8cOT1ã\81¨T1ã\81®ã\82¨ã\83³ã\82³ã\83¼ã\83\87ã\82£ã\83³ã\82°ã\81¯æ¬§æ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\81®ã\82¨ã\83³ã\82³ã\83¼ã\83\87ã\82£ã\83³ã\82°であり,
+和文フォントはこれらのエンコーディングを持つことはできない.
 これらコマンドは横組用・縦組用和文フォントのための新しいエンコーディングを
 それぞれ定義する.
 %</ja>
@@ -5718,7 +5743,7 @@ In NFSS2 under \LuaTeX-ja, distinction between alphabetic font families
 The above 3~commands are just the counterparts for \cs{DeclareFontEncodingDefaults} and~others.
 %</en>
 %<*ja>
-上記3つのコマンドはちょうど \cs{DeclareFontEncodingDefaults} などに対応するものである.
+上記3つのコマンドはちょうどNFSS2 の \cs{DeclareFontEncodingDefaults} などに対応するものである.
 %</ja>
 
 \item[\cs{reDeclareMathAlphabet}\{<unified-cmd>\}\{<al-cmd>\}\{<ja-cmd>\}]
@@ -5750,12 +5775,12 @@ The above 3~commands are just the counterparts for \cs{DeclareFontEncodingDefaul
 \item[\cs{DeclareRelationFont}\{<ja-encoding>\}\{<ja-family>\}\{<ja-series>\}\{<ja-shape>\}\\*
   \null\hfill\{<al-encoding>\}\{<al-family>\}\{<al-series>\}\{<al-shape>\}]
 %<*en>
-This command sets the ``accompanied'' alphabetic font family (given by the latter 4~arguments)
-with respect to a Japanese font family given by the former 4~arguments.
+This command sets the ``accompanied'' alphabetic font (given by the latter 4~arguments)
+with respect to a Japanese font given by the former 4~arguments.
 %</en>
 %<*ja>
\81\84ã\82\8fã\82\86ã\82\8bã\80\8cå¾\93å±\9e欧æ\96\87ã\80\8dã\82\92設å®\9aã\81\99ã\82\8bã\81\9fã\82\81ã\81®å\91½ä»¤ã\81§ã\81\82ã\82\8bï¼\8eå\89\8då\8d\8aã\81®4å¼\95æ\95°ã\81§è¡¨ã\81\95ã\82\8cã\82\8bå\92\8cæ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªã\81«å¯¾ã\81\97ã\81¦ï¼\8c
\81\9dã\81®ã\83\95ã\82©ã\83³ã\83\88ã\81«å¯¾å¿\9cã\81\99ã\82\8bã\80\8cå¾\93å±\9e欧æ\96\87ã\80\8dã\81®ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªã\82\92å¾\8cå\8d\8aã\81®4å¼\95æ\95°ã\81«ã\82\88ã\82\8aä¸\8eã\81\88ã\82\8bï¼\8e
+いわゆる「従属欧文」を設定するための命令である.前半の4引数で表される和文フォントに対して,
+そのフォントに対応する「従属欧文」のフォントを後半の4引数により与える.
 %</ja>
 \item[\cs{SetRelationFont}]
 %<*en>
@@ -5778,7 +5803,7 @@ Like \cs{fontfamily}, \cs{selectfont} is required to take an effect.
 %<*ja>
 現在の欧文フォントのエンコーディング/ファミリ/…… を,
 \cs{DeclareRelationFont} か \cs{SetRelationFont} で指定された
\8f¾å\9c¨ã\81®å\92\8cæ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªã\81«å¯¾å¿\9cã\81\99ã\82\8bã\80\8cå¾\93å±\9e欧æ\96\87ã\80\8dã\83\95ã\82©ã\83³ã\83\88ã\83\95ã\82¡ã\83\9fã\83ªに変更する.
\8f¾å\9c¨ã\81®å\92\8cæ\96\87ã\83\95ã\82©ã\83³ã\83\88ã\81«å¯¾å¿\9cã\81\99ã\82\8bã\80\8cå¾\93å±\9e欧æ\96\87ã\80\8dã\83\95ã\82©ã\83³ã\83\88に変更する.
 \cs{fontfamily} のように,有効にするためには \cs{selectfont} が必要である.
 %</ja>
 
@@ -5792,7 +5817,8 @@ to match the vertical center of ``M'' and that of ``あ''  in vertical typesetti
   + d_{\text{あ}} - d_{\text{M}},
 \]
 where $h_{a}$~and~$d_{a}$ denote the height of ``$a$'' and the depth, respectively.
-In \LuaTeX-ja, this \cs{adjustbaseline} does same task.
+In \LuaTeX-ja, this \cs{adjustbaseline} does same task, namely setting the
+            \Param{talbaselineshift} parameter.
 %</en>
 %<*ja>
 \pLaTeXe では,\cs{adjustbaseline} は縦組時に「M」と「あ」の中心線を一致させるために,
@@ -5803,7 +5829,11 @@ In \LuaTeX-ja, this \cs{adjustbaseline} does same task.
   + d_{\text{あ}} - d_{\text{M}},
 \]
 ここで,$h_{a}$,~$d_{a}$はそれぞれ「$a$」の高さ・深さを表す.
-\LuaTeX-jaにおいても\cs{adjustbaseline} は同様の処理を行っている.
+\LuaTeX-jaにおいても\cs{adjustbaseline} は同様に\Param{talbaselineshift}パラメータの調整処
+            理を行っている.
+
+同時に,これも\pLaTeXe の \cs{adjustbaseline} で行われていたが,
+「漢」の寸法を元に,(本節の最初に述べた,小文字で始まる)\cs{cht}, \cs{cwd} といった長さ変数を設定する.
 %</ja>
 
 \item[\cs{fontfamily}\{<family>\}]
@@ -5970,9 +6000,8 @@ the following ``font features'' specifications are allowed for
 the commands of Japanese version:
 %</en>
 %<*ja>
-\ref{ssec-fontspec}節で述べたように,この追加パッケージは\Pkg{fontspec}
+\ref{ssec-fontspec}節で述べたように,この追加パッケージは\Pkg{fontspec}%
 パッケージで定義されているコマンドに対応する和文フォント用のコマンドを提供する.
-\emph{以下に述べる和文版の命令の説明は \Pkg{fontspec}~v2.4 使用時にのみ当てはまる.}
 
 \Pkg{fontspec}パッケージで指定可能な各種font featureに加えて,和文版のコマンドには
 以下の``font feature''を指定することができる:
@@ -6035,7 +6064,7 @@ will not be embedded in the output PDF file. See Subsection~\ref{ssec-psft}.
 \item[TateFeatures=\{<features>\}\textrm{, }TateFont=<font>]
 %<*en>
 The \texttt{TateFeatures} key specifies font features which are only turned~on in
-vertical writing, such as \texttt{Style=VerticalKana}~(\texttt{vkna} feature). 
+vertical writing, such as \texttt{Style=VerticalKana}~(\texttt{vkna} feature).
 Similarly, the \texttt{TateFont} key specifies the Japanese font which will be used only
             in vertical writing.
 A demonstrarion is shown in Figure~\ref{fig:yokotate-fontspec}.
@@ -8316,10 +8345,10 @@ $\mathit{Nq}.\mathit{tail}$は無意味なので,
 仮想ボディの高さ$h$,深さ$d$については
 \begin{description}
 \catcode`\<=12\catcode`\>=12
- \item[$\texttt{yoffset}\geq 0$のとき] 
-$h = \max(\texttt{height} + \texttt{yoffset}, 0)$, 
-$d = \max(\texttt{depth} - \texttt{yoffset}, 0)$, 
- \item[$\texttt{yoffset}<0$のとき] 
+ \item[$\texttt{yoffset}\geq 0$のとき]
+$h = \max(\texttt{height} + \texttt{yoffset}, 0)$,
+$d = \max(\texttt{depth} - \texttt{yoffset}, 0)$,
+ \item[$\texttt{yoffset}<0$のとき]
 $h = \max(\texttt{height} + \texttt{yoffset}, 0)$, $d=\texttt{depth}$.
 \end{description}
 という仕様になっている.つまり,\texttt{yoffset} が負(グリフを下ける)の場合に深さは増加しな
@@ -8461,9 +8490,9 @@ instead of ``\verb+\ほげ+''.
 %<*en>
 \paragraph{Variation selectors}
 \Pkg{lltjp-listings} add two keys, namely \texttt{vsraw}~and~\texttt{vscmd},
-which specify how variation selectors are treated in 
+which specify how variation selectors are treated in
 \texttt{lstlisting} or other enviroments.
-Note that these additional keys are not usable in the preamble, 
+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
@@ -8491,7 +8520,7 @@ variation selectors are ``combined'' with the previous character.
 \end{lstlisting}
 \end{LTXexample}
 %<*en>
-\item If the \texttt{vsraw} key is false, then 
+\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.
@@ -9001,7 +9030,7 @@ as in Page~\pageref{para-cid}.
 This file stores the table which stores the following.
 \begin{itemize}
  \item unicode variants in a font ``\texttt{***}''
- \item vertical width of glyphs, if it is not equal to the sum of 
+ \item vertical width of glyphs, if it is not equal to the sum of
 the height of ascender and the depth of descender
  \item vertical variants
 \end{itemize}
@@ -9357,7 +9386,7 @@ TUG 2013, October 2013.
 \bibitem{jlisting} Thor Watanabe. \newblock Listings\ -\ MyTeXpert.
 %<en>\newblock
 %<ja>\\\null\hfill
-\url{http://mytexpert.sourceforge.jp/index.php?Listings}
+\url{http://mytexpert.osdn.jp/index.php?Listings}
 \bibitem{jlreq}  W3C Japanese Layout Task Force~(ed). \newblock
 Requirements for Japanese Text Layout (W3C Working Group Note), 2011, 2012. \newblock
 \url{http://www.w3.org/TR/jlreq/}%