unicode-alphabets (22jul19)

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

7 files changed, 229 insertions, 46 deletions

diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/README.md b/Master/texmf-dist/doc/latex/unicode-alphabets/README.md
index 3c34eaad290..abe2fb58608 100644
--- a/Master/texmf-dist/doc/latex/unicode-alphabets/README.md
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/README.md
@@ -5,7 +5,11 @@ Macros for using various PUA character sets in LaTeX (CYFI, MUFI, SIL, TITUS, UN
 
 See [unicode-alphabets.pdf](docs/unicode-alphabets.pdf) for the documentation.
 
-Contents last updated 2017-07-17.
+See [specimen.pdf](docs/specimen.pdf) for examples.
 
-License: CC-BY-4.0
+Contents last updated 2017-07-19.
+
+Package available via CTAN at https://www.ctan.org/pkg/unicode-alphabets
+
+License: CC-BY-SA 4.0
 Author: Mikkel Eide Eriksen <mikkel.eriksen@gmail.com>
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/license.txt b/Master/texmf-dist/doc/latex/unicode-alphabets/license.txt
index b113da0429e..9cc9c679047 100644
--- a/Master/texmf-dist/doc/latex/unicode-alphabets/license.txt
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/license.txt
@@ -1,12 +1,12 @@
 This LaTeX package and associated files is hereby released under the
-CC-BY 4.0 license.
+CC-BY-SA 4.0 license.
 
-Mikkel Eide Eriksen, May 25, 2019
+Mikkel Eide Eriksen, July 19, 2019
 mikkel.eriksen@gmail.com
 
 =======================================================================
 
-Attribution 4.0 International
+Attribution-ShareAlike 4.0 International
 
 =======================================================================
 
@@ -41,7 +41,7 @@ exhaustive, and do not form part of our licenses.
      material not subject to the license. This includes other CC-
      licensed material, or material used under an exception or
      limitation to copyright. More considerations for licensors:
-	wiki.creativecommons.org/Considerations_for_licensors
+    wiki.creativecommons.org/Considerations_for_licensors
 
      Considerations for the public: By using one of our public
      licenses, a licensor grants the public permission to use the
@@ -57,21 +57,23 @@ exhaustive, and do not form part of our licenses.
      such as asking that all changes be marked or described.
      Although not required by our licenses, you are encouraged to
      respect those requests where reasonable. More considerations
-     for the public: 
-	wiki.creativecommons.org/Considerations_for_licensees
+     for the public:
+    wiki.creativecommons.org/Considerations_for_licensees
 
 =======================================================================
 
-Creative Commons Attribution 4.0 International Public License
+Creative Commons Attribution-ShareAlike 4.0 International Public
+License
 
 By exercising the Licensed Rights (defined below), You accept and agree
 to be bound by the terms and conditions of this Creative Commons
-Attribution 4.0 International Public License ("Public License"). To the
-extent this Public License may be interpreted as a contract, You are
-granted the Licensed Rights in consideration of Your acceptance of
-these terms and conditions, and the Licensor grants You such rights in
-consideration of benefits the Licensor receives from making the
-Licensed Material available under these terms and conditions.
+Attribution-ShareAlike 4.0 International Public License ("Public
+License"). To the extent this Public License may be interpreted as a
+contract, You are granted the Licensed Rights in consideration of Your
+acceptance of these terms and conditions, and the Licensor grants You
+such rights in consideration of benefits the Licensor receives from
+making the Licensed Material available under these terms and
+conditions.
 
 
 Section 1 -- Definitions.
@@ -90,7 +92,11 @@ Section 1 -- Definitions.
      and Similar Rights in Your contributions to Adapted Material in
      accordance with the terms and conditions of this Public License.
 
-  c. Copyright and Similar Rights means copyright and/or similar rights
+  c. BY-SA Compatible License means a license listed at
+     creativecommons.org/compatiblelicenses, approved by Creative
+     Commons as essentially the equivalent of this Public License.
+
+  d. Copyright and Similar Rights means copyright and/or similar rights
      closely related to copyright including, without limitation,
      performance, broadcast, sound recording, and Sui Generis Database
      Rights, without regard to how the rights are labeled or
@@ -98,29 +104,33 @@ Section 1 -- Definitions.
      specified in Section 2(b)(1)-(2) are not Copyright and Similar
      Rights.
 
-  d. Effective Technological Measures means those measures that, in the
+  e. Effective Technological Measures means those measures that, in the
      absence of proper authority, may not be circumvented under laws
      fulfilling obligations under Article 11 of the WIPO Copyright
      Treaty adopted on December 20, 1996, and/or similar international
      agreements.
 
-  e. Exceptions and Limitations means fair use, fair dealing, and/or
+  f. Exceptions and Limitations means fair use, fair dealing, and/or
      any other exception or limitation to Copyright and Similar Rights
      that applies to Your use of the Licensed Material.
 
-  f. Licensed Material means the artistic or literary work, database,
+  g. License Elements means the license attributes listed in the name
+     of a Creative Commons Public License. The License Elements of this
+     Public License are Attribution and ShareAlike.
+
+  h. Licensed Material means the artistic or literary work, database,
      or other material to which the Licensor applied this Public
      License.
 
-  g. Licensed Rights means the rights granted to You subject to the
+  i. Licensed Rights means the rights granted to You subject to the
      terms and conditions of this Public License, which are limited to
      all Copyright and Similar Rights that apply to Your use of the
      Licensed Material and that the Licensor has authority to license.
 
-  h. Licensor means the individual(s) or entity(ies) granting rights
+  j. Licensor means the individual(s) or entity(ies) granting rights
      under this Public License.
 
-  i. Share means to provide material to the public by any means or
+  k. Share means to provide material to the public by any means or
      process that requires permission under the Licensed Rights, such
      as reproduction, public display, public performance, distribution,
      dissemination, communication, or importation, and to make material
@@ -128,13 +138,13 @@ Section 1 -- Definitions.
      public may access the material from a place and at a time
      individually chosen by them.
 
-  j. Sui Generis Database Rights means rights other than copyright
+  l. Sui Generis Database Rights means rights other than copyright
      resulting from Directive 96/9/EC of the European Parliament and of
      the Council of 11 March 1996 on the legal protection of databases,
      as amended and/or succeeded, as well as other essentially
      equivalent rights anywhere in the world.
 
-  k. You means the individual or entity exercising the Licensed Rights
+  m. You means the individual or entity exercising the Licensed Rights
      under this Public License. Your has a corresponding meaning.
 
 
@@ -180,7 +190,13 @@ Section 2 -- Scope.
                Licensed Rights under the terms and conditions of this
                Public License.
 
-            b. No downstream restrictions. You may not offer or impose
+            b. Additional offer from the Licensor -- Adapted Material.
+               Every recipient of Adapted Material from You
+               automatically receives an offer from the Licensor to
+               exercise the Licensed Rights in the Adapted Material
+               under the conditions of the Adapter's License You apply.
+
+            c. No downstream restrictions. You may not offer or impose
                any additional or different terms or conditions on, or
                apply any Effective Technological Measures to, the
                Licensed Material if doing so restricts exercise of the
@@ -262,9 +278,24 @@ following conditions.
           information required by Section 3(a)(1)(A) to the extent
           reasonably practicable.
 
-       4. If You Share Adapted Material You produce, the Adapter's
-          License You apply must not prevent recipients of the Adapted
-          Material from complying with this Public License.
+  b. ShareAlike.
+
+     In addition to the conditions in Section 3(a), if You Share
+     Adapted Material You produce, the following conditions also apply.
+
+       1. The Adapter's License You apply must be a Creative Commons
+          license with the same License Elements, this version or
+          later, or a BY-SA Compatible License.
+
+       2. You must include the text of, or the URI or hyperlink to, the
+          Adapter's License You apply. You may satisfy this condition
+          in any reasonable manner based on the medium, means, and
+          context in which You Share Adapted Material.
+
+       3. You may not offer or impose any additional or different terms
+          or conditions on, or apply any Effective Technological
+          Measures to, Adapted Material that restrict exercise of the
+          rights granted under the Adapter's License You apply.
 
 
 Section 4 -- Sui Generis Database Rights.
@@ -279,8 +310,9 @@ apply to Your use of the Licensed Material:
   b. if You include all or a substantial portion of the database
      contents in a database in which You have Sui Generis Database
      Rights, then the database in which You have Sui Generis Database
-     Rights (but not its individual contents) is Adapted Material; and
+     Rights (but not its individual contents) is Adapted Material,
 
+     including for purposes of Section 3(b); and
   c. You must comply with the conditions in Section 3(a) if You Share
      all or a substantial portion of the contents of the database.
 
@@ -401,4 +433,3 @@ the avoidance of doubt, this paragraph does not form part of the
 public licenses.
 
 Creative Commons may be contacted at creativecommons.org.
-
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/specimen.pdf b/Master/texmf-dist/doc/latex/unicode-alphabets/specimen.pdf
new file mode 100644
index 00000000000..8d336593c29
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/specimen.pdf
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/specimen.tex b/Master/texmf-dist/doc/latex/unicode-alphabets/specimen.tex
new file mode 100644
index 00000000000..4912283f5c9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/specimen.tex
@@ -0,0 +1,133 @@
+% !TEX TS-program = lualatex
+\documentclass{book}
+\usepackage[
+	a4paper,
+	margin=1in,
+	landscape
+]{geometry}
+
+\usepackage{csvsimple}
+\usepackage{xltabular}
+\usepackage{booktabs}
+\usepackage{pgfkeys}
+\usepackage{stringstrings}
+\usepackage[
+	hidelinks,
+]{hyperref}
+
+\include{csvsimple.tmp.patch}
+
+\title{Unicode Alphabets for \LaTeX\\\bigskip\large Specimen}
+\author{Mikkel Eide Eriksen}
+
+\usepackage{fontspec}
+\newfontfamily\mufifont{Palemonas MUFI}
+\newfontfamily\silfont{Doulos SIL}
+\newfontfamily\titusfont{TITUS Cyberbit Basic}
+\newfontfamily\unzfont{LUC.EnsisheimU1A}
+
+\usepackage[
+%	CYFI,
+	MUFI,
+	SIL,
+	TITUS,
+	UNZ,
+%	disable entity macros,
+	fonts={
+%		CYFI=\titusfont,
+		MUFI=\mufifont,
+		SIL=\silfont,
+		TITUS=\titusfont,
+		UNZ=\unzfont,
+	},
+]{unicode-alphabets}
+
+\makeatletter
+\newcommand\specset[1]{\pgfkeys{/specimen/.cd,#1}}
+
+\newcommand\spec@showfont[1]{%
+	{%
+		#1%
+		\edef\currentfontname{\f@family}\currentfontname
+	}%
+}
+
+\newif\ifspec@has@entity
+\specset{
+	character set/.code={
+		\csedef{spec@charset}{#1}%
+		\caselower[q]{\spec@charset}%
+		\csedef{spec@code}{\thestring}%
+		\csedef{spec@csvfile}{unicode-alphabets.\spec@code.csv}%
+		\csedef{spec@font}{\csname\spec@code font\endcsname}%
+	},
+	font url/.store in=\spec@font@url,
+	has entity/.is if=spec@has@entity,
+}
+
+\newcommand\specimen[1]{%
+	\specset{has entity=false,#1}%
+	\chapter*{\spec@charset}
+	\addcontentsline{toc}{chapter}{\spec@charset}
+
+	Using the font \spec@showfont{\spec@font} from \url{\spec@font@url}.
+
+	\begingroup
+	\def\mytablerow{\texttt{\csvcoli} & \csuse{\csuse{spec@code}}{\csvcoli} & \ifspec@has@entity\csvcolii &\fi \csvcoliii}
+	\ifspec@has@entity
+		\def\spec@columns{r @{ } c @{ } l @{ } X}
+	\else
+		\def\spec@columns{r @{ } c @{ } X}
+	\fi
+	\expanded{\unexpanded{\begin{xltabular}{\linewidth}}{\spec@columns}}
+	\toprule
+	& Code & \ifspec@has@entity&\fi \hfill \spec@charset\\
+	Glyph & Point & \ifspec@has@entity Entity Name &\fi Unicode Name\\
+	\midrule
+	\endhead
+	\bottomrule
+	\endfoot
+	\csvloop{
+		file={\spec@csvfile},
+		late after line=\\,
+		head to column names prefix=spec@,
+		command=\mytablerow,
+	}
+	\end{xltabular}
+	\endgroup
+}
+
+\makeatother
+
+\begin{document}
+
+\maketitle
+\tableofcontents
+
+\specimen{
+	character set=MUFI,
+	font url=http://mufi.info/,
+	has entity=true,
+}
+
+\specimen{
+	character set=SIL,
+	font url=https://software.sil.org/charis/download/,
+}
+
+\specimen{
+	character set=TITUS,
+	font url=http://titus.fkidg1.uni-frankfurt.de/unicode/tituut.asp,
+}
+
+\begingroup
+\catcode`\_=12 % unz entities have underscores
+\specimen{
+	character set=UNZ,
+	font url=http://www.ligafaktur.de/,
+	has entity=true,
+}
+\catcode`\_=8
+\endgroup
+
+\end{document}
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.bib b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.bib
index b93fadc988d..2180c3b7684 100644
--- a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.bib
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.bib
@@ -5,7 +5,6 @@
 }
 @online{MUFI,
   title = {MUFI: The Medieval Unicode Font Initiative},
-  date = {2019-07-12},
   url = {https://mufi.info/},
   urldate = {2019-07-12}
 }
@@ -20,7 +19,6 @@
 @online{UNZ,
   title = {Normung von Sonderzeichen},
   author = {Bund für deutsche Schrift und Sprache e. V.},
-  date = {2019-07-12},
   url = {https://www.bfds.de/der-bund/normung-von-sonderzeichen-unicode/},
   urldate = {2019-07-12}
 }
@@ -36,3 +34,13 @@
   url = {http://titus.uni-frankfurt.de/indexe.htm},
   urldate = {2019-07-12}
 }
+@online{AGL,
+  title = {adobe-type-tools/agl-aglfn},
+  url = {https://github.com/adobe-type-tools/agl-aglfn/blob/master/glyphlist.txt},
+  urldate = {2019-07-20}
+}
+@online{UCSUR,
+  title = {Under-ConScript Unicode Registry},
+  url = {http://www.kreativekorp.com/ucsur/},
+  urldate = {2019-07-20}
+}
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.pdf b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.pdf
index 646f3bf125e..0c4bd25ad56 100644
--- a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.pdf
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.pdf
diff --git a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex
index a5eef86433a..ada84e780f8 100644
--- a/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex
+++ b/Master/texmf-dist/doc/latex/unicode-alphabets/unicode-alphabets.tex
@@ -1,29 +1,37 @@
 % !TEX TS-program = lualatex
 \documentclass{article}
 
-\usepackage{biblatex}
+\usepackage[english]{babel}
+\usepackage[
+	backend=biber,
+	urldate=long,
+	date=long,
+]{biblatex}
 \addbibresource{unicode-alphabets.bib}
 
 \usepackage{showexpl}
 \usepackage{float}
 \usepackage{moreverb}
+\usepackage{csvsimple}
+\usepackage{enumitem}
+\usepackage{xltabular}
+\usepackage{booktabs}
+\usepackage[
+	hidelinks,
+]{hyperref}
+
+\include{csvsimple.tmp.patch}
 
 \title{Unicode Alphabets for \LaTeX}
-\author{Mikkel Eide Eriksen}
+\author{Mikkel Eide Eriksen\\\href{mailto:mikkel.eriksen@gmail.com}{mikkel.eriksen@gmail.com}}
 
 \usepackage{fontspec}
 \newfontfamily\mufifont{Palemonas MUFI}
-\newfontfamily\titusfont{TITUS Cyberbit Basic}
 
 \usepackage[
-	CYFI,
 	MUFI,
-	TITUS,
-%	disable entity macros,
 	fonts={
-		CYFI=\titusfont,
 		MUFI=\mufifont,
-		TITUS=\titusfont,
 	},
 ]{unicode-alphabets}
 
@@ -35,7 +43,7 @@
 
 While Unicode supports the vast majority of use cases, there are certain specialized niches which require characters and glyphs not (yet) represented in the standard.
 
-Thus the Private Use Area (PUA) at code points E000--F8FF, which enables third parties to define arbitrary character sets.
+Thus the Private Use Area (PUA) at code points \texttt{E000}--\texttt{F8FF}, which enables third parties to define arbitrary character sets.
 
 This package allows configuring a number of macros to enter characters from the PUA by name or code point.
 
@@ -44,14 +52,14 @@ This package allows configuring a number of macros to enter characters from the
 The package is configured in the following manner:
 
 \begin{verbatim}
-\usepackage[⟨options⟩]{unicode-alphabets}
+\usepackage[options]{unicode-alphabets}
 \end{verbatim}
 
 Where \verb|options| must be one or more of the following character sets. See references for further detail on each, as well as usable fonts.
 
-\begin{figure}[H]
-\begin{description}
+\begin{description}[labelindent=1cm, leftmargin=*, rightmargin=\leftmargin]
 
+\item[AGL] Adobe Glyph List\cite{AGL}.
 % \item[CSUR] - https://www.evertype.com/standards/csur/
 \item[CYFI] Early Cyrillic glyphs\cite{CYFI}.
 % DANIA ???
@@ -59,11 +67,10 @@ Where \verb|options| must be one or more of the following character sets. See re
 \item[MUFI] The Medieval Unicode Font Initiative\cite{MUFI}.
 \item[SIL] SIL International\cite{SIL}.
 \item[TITUS] Thesaurus Indogermanischer Text- und Sprachmaterialien\cite{TITUS}.
+\item[UCSUR] Under-ConScript Unicode Registry\cite{UCSUR}.
 \item[UNZ] Normung von Sonderzeichen\cite{UNZ}.
 
 \end{description}
-\caption{Character sets}
-\end{figure}
 
 There is no default, since future versions of this package may supply more character sets that are incompatible with the above.