4 files changed, 45 insertions, 39 deletions
diff --git a/Master/texmf-dist/doc/latex/extarrows/README b/Master/texmf-dist/doc/latex/extarrows/README
deleted file mode 100644
index e828202198f..00000000000
--- a/Master/texmf-dist/doc/latex/extarrows/README
+++ /dev/null
@@ -1,34 +0,0 @@
-Package: extarrows (extensible arrows)
-
-Version:
-	* 1.0b (2008/05/15)
-		Thanks to Herbert Voss <Herbert.Voss@FU-Berlin.DE>
-	* 1.0a (2004/11/05)
-
-Author: kyanh <xkyanh@gmail.com>
-
-License: LGPL
-
-This package provides some extensible arrows in maths. mode
-    (more than \xleftarrow, \xrightarrow, ...)
-
-    \xlongequal
-    \xLongleftarrow
-    \xLongrightarrow
-    \xLongleftrightarrow
-    \xLeftrightarrow
-
-    \xlongleftrightarrow
-    \xleftrightarrow
-    \xlongleftarrow
-    \xlongrightarrow
-
-Examples:
-    extarrows-test.tex (source)
-    extarrows-test.pdf (demonstration)
-
---
-Huynh Ky Anh
-Vietnamese TeX Users Group
-http://kyanh.net/
-http://viettug.org/
diff --git a/Master/texmf-dist/doc/latex/extarrows/README.md b/Master/texmf-dist/doc/latex/extarrows/README.md
new file mode 100644
index 00000000000..e4aca88986d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/extarrows/README.md
@@ -0,0 +1,34 @@
+## Description
+
+`extarrows` (extensible arrows) provides some extensible arrows in math mode.
+
+The list of new arrow commands:
+
+* `\xlongequal`
+* `\xLongleftarrow`
+* `\xLongrightarrow`
+* `\xLongleftrightarrow`
+* `\xLeftrightarrow`
+* `\xlongleftrightarrow`
+* `\xleftrightarrow`
+* `\xlongleftarrow`
+* `\xlongrightarrow`
+
+## Examples
+
+* Source file: [extarrows-test.tex](extarrows-test.tex)
+* Sample output: [extarrows-test.pdf](extarrows-test.pdf)
+
+## History
+
+* Version 1.2.0 (2020/03/12): Documentation updates. Use https://github.com/viettug/extarrows
+* Version 1.0b  (2008/05/15): Thanks to Herbert Voss <Herbert.Voss@FU-Berlin.DE>
+* Version 1.0a  (2004/11/05): Initial version
+
+## Author:
+
+Ky-Anh Huynh <xkyanh@gmail.com>
+
+## License
+
+LGPL
diff --git a/Master/texmf-dist/doc/latex/extarrows/extarrows-test.pdf b/Master/texmf-dist/doc/latex/extarrows/extarrows-test.pdf
index 930f579652e..361bcad1516 100644
--- a/Master/texmf-dist/doc/latex/extarrows/extarrows-test.pdf
+++ b/Master/texmf-dist/doc/latex/extarrows/extarrows-test.pdf
diff --git a/Master/texmf-dist/doc/latex/extarrows/extarrows-test.tex b/Master/texmf-dist/doc/latex/extarrows/extarrows-test.tex
index bca513d7cdd..b99340b1cbf 100644
--- a/Master/texmf-dist/doc/latex/extarrows/extarrows-test.tex
+++ b/Master/texmf-dist/doc/latex/extarrows/extarrows-test.tex
@@ -1,9 +1,17 @@
+% Purpose : Provide some extensible arrows in math mode.
+%           (Sample source file)
+% Author  : Ky-Anh Huynh
+% License : LGPL
+
 \documentclass[10pt, a4paper, oneside]{article}
 
 \usepackage{extarrows}
 
+% Define a simple macro for testing
 \def\test#1/{%
-	\texttt{\textbackslash #1:}\qquad& A\csname #1\endcsname[\text{to love}]{\text{we love}}Z}
+	\texttt{\textbackslash #1:}\qquad& A\csname #1\endcsname[\text{sub-script}]{\text{super-script}}Z}
+
+% Test command without sub/super-scripts
 \def\tfst #1/{%
 	\texttt{\textbackslash #1:}\qquad& A\csname #1\endcsname[]{}Z}
 
@@ -11,14 +19,12 @@
 \section{Syntax}
 
 \begin{verbatim}
+\arrowname{super-script}
 \arrowname[sub-script]{super-script}
 \end{verbatim}
 
 \noindent
-\texttt{arrowname} is \texttt{xlongequal}, \texttt{xLongleftarrow}, etc.
-
-\noindent
-The parameter \verb"[sub-script]" is optional.
+\texttt{arrowname} is one of known arrow command, for example, \texttt{xlongequal}, \texttt{xLongleftarrow},\ldots
 
 \section{Examples}
 \begin{align}