textualicomma (24aug18)

git-svn-id: svn://tug.org/texlive/trunk@48474 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 22 insertions, 10 deletions

diff --git a/Master/texmf-dist/doc/latex/textualicomma/README.md b/Master/texmf-dist/doc/latex/textualicomma/README.md
index a4cdf0c11d3..c68f2f739ee 100644
--- a/Master/texmf-dist/doc/latex/textualicomma/README.md
+++ b/Master/texmf-dist/doc/latex/textualicomma/README.md
@@ -1,20 +1,32 @@
 # textualicomma
-A solution for using the textual comma character as decimal separator in math mode.  
+Use the textual comma character as decimal separator in math mode.  
 
-**`textualicomma` is based on the `icomma` package and intended as a solution for situations where the text comma character discerns from the math comma character**, e. g. when fonts whithout math support are involved.  
-Escaping to text mode every time a comma is used in math mode may slow down the compilation process.  
-Please check, whether `icomma` already satisfies your needs.  
+**`textualicomma` is based on the [`icomma`](https://ctan.org/pkg/icomma) package and intended as a solution for situations where the text comma character discerns from the math comma character**, e. g. when fonts whithout math support are involved.  
+Escaping to text mode every time a comma is used in math mode might slow down the compilation of huge documents.  
+Please check, whether [`icomma`](https://ctan.org/pkg/icomma) already satisfies your needs.  
 
-You can obtain the package files by running LaTeX over the file `textualicomma.ins`:
 
-    latex textualicomma.ins
 
-For compiling the documentation, run **LuaLaTeX** twice over the docstrip source file `textualicomma.dtx`:
+### Installation
+Extract the *package* file first:
+
+  1. Run LaTeX over the file `textualicomma.ins`
+  2. Move the resulting `.sty` file to `TEXMF/tex/latex/textualicomma/`
+
+Then, you can compile the *documentation* yourself by executing
+
+    lualatex textualicomma-doc.dtx
+    makeindex -s gind.ist textualicomma-doc.idx
+    makeindex -s gglo.ist -o textualicomma-doc.gls textualicomma-doc.glo
+    lualatex textualicomma-doc.dtx
+    lualatex textualicomma-doc.dtx
+    
+
+or just use the precompiled documentation shipped with the source files.  
+In both cases, copy the files `textualicomma-doc.pdf` and `README.md` to `TEXMF/doc/latex/textualicomma/`.
 
-    lualatex textualicomma.dtx
-    lualatex textualicomma.dty
 
 
 ### License
-This work, consisting of the files `textualicomma.dtx`, `textualicomma.ins` and the derived file `textualicomma.sty`, is licensed under the LPPL, Version 1.3c (or, at your option, any later version)  
+This work, consisting of the files `textualicomma.dtx`, `textualicomma.ins`, `textualicomma-doc.dtx` and the derived file `textualicomma.sty`, is licensed under the LPPL, Version 1.3c (or, at your option, any later version)  
 Current maintainer of the work is Sebastian Friedl.
diff --git a/Master/texmf-dist/doc/latex/textualicomma/textualicomma-doc.pdf b/Master/texmf-dist/doc/latex/textualicomma/textualicomma-doc.pdf
new file mode 100644
index 00000000000..3037d11b419
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/textualicomma/textualicomma-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/textualicomma/textualicomma.pdf b/Master/texmf-dist/doc/latex/textualicomma/textualicomma.pdf
deleted file mode 100644
index 6bfb01aee3b..00000000000
--- a/Master/texmf-dist/doc/latex/textualicomma/textualicomma.pdf
+++ /dev/null