OSDN Git Service

ltj-jfont.lua: "-ltjksp" disables ksp_{natural,stretch,shrink} key in JFM
[luatex-ja/luatexja.git] / doc / luatexja.dtx
index 6743fcd..0c159e4 100644 (file)
@@ -4464,24 +4464,24 @@ we specify <ratio> to $0.25/(0.5+0.25)=1/3$.
              度を$-2$から$+2$の間の整数で指定する.大きい値ほど「伸びやすく,縮みやすい」
              ことを意味する.省略時の値
              は0であり,範囲外の値が指定されたときの動作は未定義である.
-\item[ksp\_natural=<bool>\textrm{, }%
-  ksp\_stretch=<bool>\textrm{, }ksp\_shrink=<bool>]\leavevmode
+\item[ksp\_natural=<num>\textrm{, }%
+  ksp\_stretch=<num>\textrm{, }ksp\_shrink=<num>]\leavevmode
 
 JFMによって本来挿入されるグルーの他に
 \Param{kanjiskip}分の空白を自然長(\texttt{ksp\_natural}),伸び量(\texttt{ksp\_stretch}),
 縮み量(\texttt{ksp\_shrink})ごとに挿入する\footnote{本来\Param{xkanjiskip}が挿入される場所においては
             \Param{xkanjiskip}分の空白を自然長・伸び量・縮み量ごとに.追加できる.}%
-ための指定である.
+ための指定である.いずれも省略された場合のデフォルト値は0(追加しない)である.
 
 例えば,\LuaTeX-jaの横組標準JFMの \texttt{jfm-ujis.lua} では,
 \begin{itemize}
  \item 通常の文字「あ」と開き括弧類の間に入るグルーは,自然長・縮み量半角,伸び量0のグルー
-となっているが,\texttt{ksp\_stretch=true} のおかげで,さらに\Param{kanjiskip}の伸び量だ
-伸びることが許される.
+となっているが,さらに\Param{kanjiskip}の伸び量に \texttt{ksp\_stretch}(ここでは1)を掛
+       た分だけ伸びることが許される.
  \item 同様に,閉じ括弧類(全角コンマ「,」も含む)と通常の文字「う」「え」の間にも
 自然長・縮み量半角,伸び量0のグルー
-となっているが,\texttt{ksp\_stretch=true} のおかげで,さらに\Param{kanjiskip}の伸び量だ
-伸びることが許される.
+となっているが,さらに\Param{kanjiskip}の伸び量に \texttt{ksp\_stretch}(ここでは1)を掛
+       た分だけ伸びることが許される.
 \end{itemize}
 となっている.従って,以下のような組版結果を得る.
 
@@ -4503,22 +4503,25 @@ An integer in $[-2,2]$ (treated as 0 if omitted), and this is
 used only in line adjustment with priority by \Pkg{luatexja-adjust}
 (see Subsection~\ref{ssec-adj}). Higher value means the glue is easy to stretch,
 and is also easy to shrink.
-\item[ksp\_natural=<bool>\textrm{, }%
-  ksp\_stretch=<bool>\textrm{, }ksp\_shrink=<bool>]\leavevmode
+\item[ksp\_natural=<num>\textrm{, }%
+  ksp\_stretch=<num>\textrm{, }ksp\_shrink=<num>]\leavevmode
 
 These keys specifies whether the natural width of \Param{kanjiskip}
 (the stretch/shrink part, respectively) will be inserted in addition to the original
-JFM glue.
+JFM glue. Default values of them are all 0.
 
 As an example, in \texttt{jfm-ujis.lua}, the standard JFM in horizontal writing, we have
 \begin{itemize}
  \item Between an ordinal letter ``あ'' and an ideographic opening bracket, we have
 a glue whose natural part and shrink part are both half-width, while its stretch part is
-       zero. However, because of \texttt{ksp\_stretch=true}, this glue can be stretched
-       as much as \Param{kanjiskip}.
+       zero. However, this glue also can be stretched
+       as much as the stretch part of \Param{kanjiskip} times the value of
+       \texttt{ksp\_stretch} key (1 in this case).
  \item Between an ideographic closeing brackets (the ideographic comma ``,''
-       is included) and an ordinal letter, we have the same glue. Again, because of 
-\texttt{ksp\_stretch=true}, this glue can be stretched as much as \Param{kanjiskip}.
+       is included) and an ordinal letter, we have the same glue. 
+       Again, this glue also can be stretched
+       as much as the stretch part of \Param{kanjiskip} times the value of
+       \texttt{ksp\_stretch} key (1 in this case).
 \end{itemize}
 Hence we have the following result: