X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;f=doc%2Fluatexja.dtx;h=f3e910c44198d84be6277b5b9dbba48a6ea2de3f;hb=029c74784e3acac4ca96ef9c8c3789faf7334d38;hp=953019e05609ff4c60e5662da11d40b7bf1b317a;hpb=8049e2bb43cb350c8af4ee30c61c63e831276de9;p=luatex-ja%2Fluatexja.git

diff --git a/doc/luatexja.dtx b/doc/luatexja.dtx
index 953019e..f3e910c 100644
--- a/doc/luatexja.dtx
+++ b/doc/luatexja.dtx
@@ -158,7 +158,8 @@
   \vskip\belowcaptionskip}
 
 \def\_{\leavevmode \kern .06em\vbox {\hrule \@width .333em}}
-\def\cs#1{\texttt{\upshape\textbackslash\ltjsetparameter{autoxspacing=false}#1}}
+\def\cs#1{\texttt{\upshape
+  \texorpdfstring{\textbackslash\ltjsetparameter{autoxspacing=false}#1}{\textbackslash#1}}}
 
 %%%%%%%%
 \makeatother
@@ -745,17 +746,23 @@ 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.
+\item By default, \LuaTeX-ja uses Japanese fonts to typeset Greek and Cyrillic letters.
+      To change this behavior, 
+      put \verb!\ltjsetparameter{jacharrange={-2,-3}}! in the preamble.
       For the detailed description, see Subsection~\ref{ssec-setrange}.
 %</en>
 %<*ja>
 \item 
-標準では，\LuaTeX-jaはギリシャ文字やキリル文字，それに\P や\S などの記号を和文フォントを使っ
+標準では，\LuaTeX-jaはギリシャ文字やキリル文字を和文フォントを使っ
       て組む．ギリシャ語などを本格的に組むなどこの状況が望ましくない場合，
-      プリアンブルに \lstinline!\ltjsetparameter{jacharrange={-2,-3,-8}}! を入れると
+      プリアンブルに
+\begin{lstlisting}
+ \ltjsetparameter{jacharrange={-2,-3}}
+\end{lstlisting}
+      を入れると
       上記種類の文字は欧文フォントを用いて組まれるようになる．
+      なお，\P,~\S といったISO~8859-1の上位領域とJIS~X~0208の共通部分の文字は
+      本バージョンから標準で欧文扱い(\textbf{ALchar})となった．
       詳しい説明は\ref{ssec-setrange}節を参照してほしい．
 %</ja>
 %<*en>
@@ -1586,8 +1593,6 @@ There is not rounded gothic family in Kozuka fonts.
 \end{tabular}
 \end{center}
 
-%<ja>\newpage
-
  \item[hiragino-pro]  Hiragino Pro (Adobe-Japan1-5) fonts.
 %<en>    \\*[-\dimexpr\medskipamount+\baselineskip\relax]
  \item[hiragino-pron] Hiragino ProN (Adobe-Japan1-5, JIS04-savvy) fonts.
@@ -1976,8 +1981,8 @@ removed from the range~4.
 %</en>
 %<*ja>
 各文字はただ一つの文字範囲に所属することができる．
-例えば，SIPは全て\LuaTeX-jaのデフォルトでは4番の文字範囲に
-属しているが，上記の指定を行えばSIPは100番に属すようになり，4番からは除かれる．
+例えば，SIP内の文字は全て\LuaTeX-jaのデフォルトでは4番の文字範囲に
+属しているが，上記の指定を行えばSIP内の文字は100番に属すようになり，4番からは除かれる．
 %</ja>
 
 %<*en>
@@ -1986,8 +1991,8 @@ This can be edited by setting the \textsf{jacharrange} parameter.
 For example, the code below is just the default setting of \LuaTeX-ja, and
 it sets
 \begin{itemize}
- \item a character which belongs character ranges 1,~4, and~5 is \textbf{ALchar},
- \item a character which belongs character ranges 2,~3, 6, 7, and~8 is \textbf{JAchar}.
+ \item a character which belongs character ranges 1,~4, 5, and~8 is \textbf{ALchar},
+ \item a character which belongs character ranges 2,~3, 6, and~7 is \textbf{JAchar}.
 \end{itemize}
 %</en>
 %<*ja>
@@ -1995,12 +2000,12 @@ it sets
 これは\textsf{jacharrange}パラメータによって編集できる．
 例えば，以下は\LuaTeX-jaの初期設定であり，次の内容を設定している：
 \begin{itemize}
- \item 1番，4番，5番の文字範囲に属する文字は\textbf{ALchar}．
- \item 2番，3番，6番，7番，8番の文字範囲に属する文字は\textbf{JAchar}．
+ \item 1番，4番，5番，8番の文字範囲に属する文字は\textbf{ALchar}．
+ \item 2番，3番，6番，7番の文字範囲に属する文字は\textbf{JAchar}．
 \end{itemize}
 %</ja>
 \begin{lstlisting}
-\ltjsetparameter{jacharrange={-1, +2, +3, -4, -5, +6, +7, +8}}
+\ltjsetparameter{jacharrange={-1, +2, +3, -4, -5, +6, +7, -8}}
 \end{lstlisting}
 %<*en>
 The argument to \textsf{jacharrange} parameter is a list of non-zero integer.
@@ -2015,29 +2020,6 @@ and positive integer $+n$ means that ``\dots\ is a \textbf{JAchar}''.
 %</ja>
 
 %<*en>
-\emph{Caution}: this default setting may causes a problem with traditional 8-bit fonts,
-such as \cs{Frowny} in MarVoSym.ttf. Since the codepoint of \cs{Frowny} is 167,
-which belongs to character range~8, this will be typeset \ltjjachar`§ in current
-\emph{Japanese} font.
-To avoid this problem, one can use
-\begin{lstlisting}
-\ltjsetparameter{jacharrange={-1, -8}}
-\end{lstlisting}
-to set all characters whose codepoint is in $[128,255)$ as \textbf{ALchar}.
-%</en>
-%<*ja>
-なお，この標準設定は，伝統的な8ビットのフォントを使うときに問題を起こす可能性がある．
-具体例としてはMarVoSym.ttf中の\cs{Frowny}があり，この符号位置は（文字範囲8内の）167である
-から，\cs{Frowny}はそのままでは\ltjjachar`§を和文フォントで出力してしまうことになる．
-回避するには，
-\begin{lstlisting}
-\ltjsetparameter{jacharrange={-1, -8}}
-\end{lstlisting}
-などとして，符号位置が$[128,255)$の全ての文字を\textbf{ALchar}扱いにさせればよい．
-%</ja>
-
-
-%<*en>
 \paragraph{Default character ranges}
 \LuaTeX-ja predefines eight character ranges for convenience. They are
 determined from the following data:
@@ -2066,19 +2048,21 @@ these eight ranges belongs to the character range~217.
 %</en>
 %<*ja>
 以下ではこれら8つの文字範囲について記述する．添字のアルファベット「J」「A」
-は，その文字範囲内の文字が\textbf{JAchar}か\textbf{ALchar}かを表している．これらの設定は
-\texttt{PXbase}バンドルで定義されている\texttt{prefercjk}と類似のものである．
+は，その文字範囲内の文字が\textbf{JAchar}か\textbf{ALchar}かを表している．これらの初期設定は
+\texttt{PXbase}バンドルで定義されている\texttt{prefercjk}と類似のものであるが，
+8ビットフォント使用時のトラブルを防ぐために \texttt{U+0080}--\texttt{U+00FF} の文字は全部
+\textbf{ALchar}としている．
 なお，\texttt{U+0080} 以降でこれら8つの文字範囲に属さない文字は，217番の文字範囲に属することになっている．
 %</ja>
 \begin{description}
 %<*en>
 
-\item[Range~8${}^{\kern.1em\text{J}}$] The intersection of the upper half of ISO~8859-1
+\item[Range~8${}^{\text{A}}$] 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${}^{\kern.1em\text{J}}$] ISO~8859-1の上位領域（ラテン1補助）と
+\item[範囲8${}^{\text{A}}$] ISO~8859-1の上位領域（ラテン1補助）と
                              JIS~X~0208の共通部分．この文字範囲は
                              以下の文字で構成される：
 %</ja>
@@ -2112,9 +2096,10 @@ This range consists of the following Unicode ranges, \emph{except characters in
 \item \texttt{U+0180}--\texttt{U+024F}: Latin Extended-B
 \item \texttt{U+0250}--\texttt{U+02AF}: IPA Extensions
 \item \texttt{U+02B0}--\texttt{U+02FF}: Spacing Modifier Letters
-\item \texttt{U+0300}--\texttt{U+036F}: \\\null\hfill Combining Diacritical Marks
-\item \texttt{U+1E00}--\texttt{U+1EFF}: \\\null\hfill Latin Extended Additional
-\par\
+%<en>\par\ 
+\item \texttt{U+0300}--\texttt{U+036F}: \\*\null\hfill Combining Diacritical Marks
+\item \texttt{U+1E00}--\texttt{U+1EFF}: \\*\null\hfill Latin Extended Additional
+%<ja>\par\
 \end{itemize}
 \end{multicols}
 %<*en>
@@ -2123,7 +2108,7 @@ This range consists of the following Unicode ranges, \emph{except characters in
 %</en>
 %<*ja>
 \item[範囲2${}^{\text{\kern.1emJ}}$] ギリシャ文字とキリル文字．JIS~X~0208（したがってほとんどの
-                             和文フォント）はこれらの文字を持つ．
+                             和文フォント）には，これらの文字の一部が含まれている．
 %</ja>
 \begin{multicols}{2}
 \begin{itemize}
@@ -2248,6 +2233,54 @@ The block list is indicated in Table~\ref{table-rng7}.
 \end{table}
 \end{description}
 
+%<*en>
+\paragraph{Notes on \texttt{U+0080}--\texttt{U+00FF}}
+You should treat characters in \\texttt{U+0080}--\texttt{U+00FF} as \textbf{ALchar}, 
+when you use traditional 8-bit fonts, such as the \Pkg{textcomp} package or the
+\Pkg{marvosym} package.
+
+For example, the codepoint \cs{textparagraph} which is provided by the \Pkg{textcomp}
+package is 182. This codepoint corresponds \P\ (\text{U+00B6}) in Unicode.
+Similarly, \cs{Frowny} which is provided by the \Pkg{marvosym} package has
+the same codepoint as \S\ (\text{U+00A7}).
+Hence, as previous versions of \LuaTeX-ja, if these characters are treated as
+\text{JAchar}s, then \cs{textparagraph} produces ``ltjjachar`¶'' (in a Japanese font), 
+and  \cs{Frowny} produces ``\ltjjachar`§'' (in a Japanese font).
+
+To avoid such situations, the default  setting of \LuaTeX-ja is changed in this release
+so that all characters \texttt{U+0080}--\texttt{U+00FF} are treated as \textbf{ALchar}.
+If you want to output a character as \textbf{ALchar}/\textbf{JAchar} regardless the range
+setting, you can use \cs{ltjalchar}/\cs{ltjjachar} respectively.
+\begin{LTXexample}[width=0.3\textwidth]
+\gtfamily 
+¶，\ltjalchar`¶，\ltjjachar`¶\\   % default: ALchar
+α，\ltjalchar`α，\ltjjachar`α  % default: JAchar
+\end{LTXexample}
+%</en>
+%<*ja>
+\paragraph{\texttt{U+0080}--\texttt{U+00FF}についての注意}
+\LuaTeX-jaで，\Pkg{textcomp}パッケージや\Pkg{marvosym}パッケージ等，Unicodeフォントでなく
+伝統的な8ビットフォントを用いる場合には注意が必要である．
+
+例えば，\Pkg{textcomp}パッケージの提供する \cs{textparagraph} は，
+符号位置が182，つまり \texttt{0xB6} であり，Unicodeではこの符号位置では\P\ (\text{U+00B6}) に対応する．
+また，\Pkg{marvosym}パッケージの提供する \cs{Frowny} も，符号位置は167，つまりUnicodeにおける
+\S\ (\text{U+00A7}) と同じ符号位置にある．
+即ち，以前のバージョンのように，「前節の文字範囲8内の文字は\textbf{JAchar}」という設定で
+あったとすると，上記の \cs{textparagraph} は和文フォントで「\ltjjachar`¶」を出力し，
+また \cs{Frowny} は和文フォントで「\ltjjachar`§」を出力することになる．
+このような事態を避けるために，\emph{本バージョンからは \texttt{U+0080}--\texttt{U+00FF} の範囲の
+文字は全て\textbf{ALchar}となるように初期設定を変更}している．
+
+なお，文字範囲の設定に関わらず文字を\textbf{ALchar}, \textbf{JAchar}で出力したい場合には，
+それぞれ \cs{ltjalchar},~\cs{ltjjachar} に該当文字の文字コードを渡せばよい．
+\begin{LTXexample}[width=0.3\textwidth]
+\gtfamily 
+¶，\ltjalchar`¶，\ltjjachar`¶\\   % default: ALchar
+α，\ltjalchar`α，\ltjjachar`α  % default: JAchar
+\end{LTXexample}
+%</ja>
+
 %<en>\subsection{\Param{kanjiskip} and \Param{xkanjiskip}}
 %<ja>\subsection{\Param{kanjiskip}と\Param{xkanjiskip}}
 \label{subs-kskip}
@@ -5612,7 +5645,7 @@ With the help of this example, we remark the specification of \cs{inhibitglue}:
 Using \cs{ltjdeclarealtfont}, one can ``compose'' more than one Japanese fonts.
 This \cs{ltjdeclarealtfont} uses in the following form:
 \begin{quote}
-\ttfamily \textbackslash ltjdeclarealtfont<base\_font\_cs><alt\_font\_cs>{<range>}
+\ttfamily \textbackslash ltjdeclarealtfont<base\_font\_cs><alt\_font\_cs>\{<range>\}
 \end{quote}
 where  <base\_font\_cs>~and~<alt\_font\_cs> are defined by \cs{jfont}.
 Its meaning is
@@ -5620,8 +5653,7 @@ Its meaning is
 If the current Japanese font is <base\_font\_cs>, characters which belong to <range>
 is typeset by another Japanese font <alt\_font\_cs>, instead of <base\_font\_cs>.
 \end{quote}
-
-<range> is a comma-separated list of character codes, but also accepts negative integers:
+Here <range> is a comma-separated list of character codes, but also accepts negative integers:
 $-n$~($n≥1$) means that all characters of character classes~$n$, with respect to JFM used
 by <base\_font\_cs>. Note that characters which do not exist in <alt\_font\_cs> are
 ignored.
@@ -5645,7 +5677,7 @@ are typeset by \cs{piyo}.
 
 \cs{ltjdeclarealtfont} は以下の書式で使用する：
 \begin{quote}
-\ttfamily \textbackslash ltjdeclarealtfont<base\_font\_cs><alt\_font\_cs>{<range>}
+\ttfamily \textbackslash ltjdeclarealtfont<base\_font\_cs><alt\_font\_cs>\{<range>\}
 \end{quote}
 これは「現在の和文フォント」が<base\_font\_cs>であるとき，
 <range>に属する文字は<alt\_font\_cs>を用いて組版される，という意味である．
@@ -6097,10 +6129,7 @@ loaded.
 
 %<en>\paragraph{Remarks}
 %<ja>\paragraph{注意}
-\begin{itemize}
-
 %<*en>
-\item 
 Of course, there is a case that <family> is not recognized as a Japanese font family,  nor
 an alphabetic font family.
 In this case, \LuaTeX-ja treats ``the argument <family> is wrong'', so
@@ -6108,21 +6137,12 @@ set both current alphabetic and Japanese font family to <family>,
 to use the default family for font substitution.
 %</en>
 %<*ja>
-\item 
 さて，引数によっては，「和文フォントファミリとも欧文フォントファミリも認識されなかった」
 という事態もあり得る．
   この場合，引数<family>は不正だった，ということになるので，
 和文・欧文の両方のフォントファミリを<family>に設定し，代用フォントが使われるに任せることにする．
 %</ja>
 
-%<*en>
-\item 
-%</en>
-%<*ja>
-\item 
-%</ja>
-\end{itemize}
-
 
 %<*en>
 \section{Addons}