X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=README;h=8e35b33983d425de6485a012ac7bd25113c991a9;hb=a978d06a452db8d773e039ed49dd2b57666e7f60;hp=bdc6849b03b377c91fb9bdb5f9ca280b64bb3312;hpb=ed2c2bfdf661faf9aacf81b0f090e2d182bc8a7a;p=luatex-ja%2Fluatexja.git

diff --git a/README b/README
index bdc6849..8e35b33 100644
--- a/README
+++ b/README
@@ -1,6 +1,6 @@
 The LuaTeX-ja Package $VER$
 --------------------------------
-Copyright (c) 2011--2012 The LuaTeX-ja project
+Copyright (c) 2011--2020 The LuaTeX-ja project
 License: modified BSD (see COPYING)
 
 LuaTeX-ja is a macro package for typesetting Japanese documents with LuaTeX.
@@ -8,38 +8,61 @@ This package is highly affected by ASCII pTeX engine, but not a porting of it.
 
 Note that this package is still *alpha-stage*; documentations are not complete
 and specifications are subject to change. Documentations are located at
-  doc/luatexja-en.pdf (en), doc/luatexja-ja.pdf (ja), doc/luatexja-zh.pdf (zh).
+  doc/luatexja-en.pdf (en), doc/luatexja-ja.pdf (ja).
 
 LuaTeX-ja is developed on
-  <http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage(en)>.
+  <https://osdn.jp/projects/luatex-ja/wiki/FrontPage(en)>.
 If you have questions or recognize bugs/have feature requests,
 we would like you to create a thread in the forum or a ticket
-in the way which SourceForge.JP supplies, via links found in
-the page above. 
+in the way which OSDN supplies, via links found in the page above.
 
 
 Installation
 ------------
 
 0. Please make sure that your TeX distribution is up-to-date.
-   LuaTeX-ja (luatexja-fontspec.sty) requires xunicode.sty v0.981.
-
-1. If you are using TeX Live 2011 or later, you can install LuaTeX-ja via tlmgr.
+   This version of LuaTeX-ja requires
+    - LuaTeX 1.07.0 (or later)
+    - luaotfload (v3.1 or later recommended)
+    - adobemapping (Adobe CMap files)
+    - everysel package
+    - etoolbox package
+    - ltxcmds package
+    - pdftexcmds package
+    - atbegshi package
+    - filehook package
+    - stfloats package
+    - IPAex fonts (http://ipafont.ipa.go.jp/)
+
+   Using LuaTeX-ja with LuaHBTeX is not well tested.
+   One might be able to typeset documents without an error, but with
+   some unwanted results.
+
+1. If you are using TeX Live 2019, you can install LuaTeX-ja via tlmgr.
 
 2. If you must/want to install manually:
 
    a. Download the source archive from CTAN,
       or tagged as $VER$ in the Git repository by
-      <http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git
+      <http://git.osdn.jp/view?p=luatex-ja/luatexja.git
                               ;a=snapshot;h=refs/tags/$VER$;sf=tgz>
 
-   b. Extract the archive and put src/ into your TEXMF tree.
+   b. Extract the archive and process following three files by LuaLaTeX
+      to generate classes for Japanese typesetting:
+        src/ltjclasses.ins
+        src/ltjltxdoc.ins
+        src/ltjsclasses.ins
+
+   c. Process src/ltj-kinsoku_make.tex by (plain) LuaTeX to generate ltj-kinsoku.lua,
+      which stores default "kinsoku" parameters.
+
+   d. Put src/ into your TEXMF tree.
       An example location is TEXMF/tex/luatex/luatexja.
 
       If you are updating from old version, you MUST remove it before
       extracting the new version of LuaTeX-ja.
 
-   c. You may need to update the filename database, by 'mktexlsr' or something.
+   e. You may need to update the filename database, by mktexlsr (or by another program).
 
 
 Basic Usage
@@ -49,11 +72,25 @@ LuaTeX-ja supports both the plain format and LaTeX2e.
 Simply loading luatexja.sty by \input or \usepackage does the minimal setting.
 
 - If you want to create Japanese-based documents, you can consider the use of
-  ltj{article,book,report}.cls or ltjs{article,book}.cls.
-- If you want to use the fontspec package, please load luatexja-fontspec.sty.
-  It defines control sequences such as \setmainjfont, setsansjfont and
-  \jfontspec, which can be used for specifying Japanese fonts.
+  ltj{article,book,report}.cls or ltjs{article,book,report}.cls.
+- If you want to use functionality of the fontspec package with Japanese fonts,
+  load luatexja-fontspec.sty. It defines control sequences such as \setmainjfont,
+  \setsansjfont and  \jfontspec, which can be used for specifying Japanese fonts.
 
+Notes
+-----
+* We don't recommend defining a Japanese font with HarfBuzz, by specifying
+  "Renderer=..." (fontspec) or "mode=harf" (otherwise).
 
-Last commit date: $Format:%cd$
+* This archive contains four .{dtx,ins} pairs:
+    src/ltjclasses.{ins,dtx},  src/ltjltxdoc.{ins,dtx}
+    src/ltjsclasses.{ins,dtx}, doc/luatexja.{ins,dtx}
+  Former three pairs generate class files (see above),
+  while the latter doc/luatexja.{ins,dtx} generates documentations.
+  (You will need Kozuka fonts to regenerate documentaion PDFs.)
 
+  No .{dtx,ins} pair generates .sty files of LuaTeX-ja package.
+
+* src/*.{ins.dtx} and src/ltj-kinsoku_make.tex are not needed in regular use.
+
+Last commit date: $Format:%cd$