fontawesome5 (7jun19)

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

3 files changed, 110 insertions, 4 deletions

diff --git a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf
index 22645fc1df9..de83e4bbcf4 100644
--- a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf
+++ b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.pdf
diff --git a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex
index 596e0c2dcc7..e665fa20dd5 100644
--- a/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex
+++ b/Master/texmf-dist/doc/fonts/fontawesome5/fontawesome5.tex
@@ -2,11 +2,13 @@
 \usepackage{hyperref}
 \usepackage{shortvrb}
 \usepackage{metalogo}
+\usepackage{longtable}
 \usepackage{fontawesome5}
 \usepackage[utf8]{inputenc}
+\usepackage{geometry}
 \MakeShortVerb{\|}
 \begin{document}
-\title{The fontawesome5 package\thanks{This document corresponds to fontawesome5 version 5.8.0, dated 2019/03/20}}
+\title{The fontawesome5 package\thanks{This document corresponds to fontawesome5 version 5.9.0, dated 2019/06/07}}
 \author{Font Awesome\thanks{More information at \url{https://fontawesome.com}} (The font)\and Marcel Krüger\thanks{E-Mail: \href{mailto:tex@2krueger.de}{\nolinkurl{tex@2krueger.de}}} (The \LaTeX{} package)}
 \maketitle
 This package provides \LaTeX{} support for the Font Awesome 5 icons.
@@ -19,13 +21,15 @@ Alternatively you can add the |fixed| option to get fixed-width icons:
 \begin{verbatim}
   \usepackage[fixed]{fontawesome5}
 \end{verbatim}
-For every icon a macro is provided: Just use the official icon names\footnote{For a full list see \url{https://fontawesome.com/cheatsheet}.} converted to CamelCase with the prefix |\fa|.
+For every icon a macro is provided: Just use the official icon names converted to CamelCase with the prefix |\fa|.
 For example to use the |hand-point-up| icon, use |\faHandPointUp|.
 For icons ending with |-alt|, append a |*| instead.
 An optional argument can be added to select the style (|solid| or |regular|).
 The default style is |solid|, it can be changed with |\faStyle{...}|
 
-Every icon can also be accessed with |\faIcon{the-icon-name}| or |\faIcon[style]{...}|.
+Every icon can also be accessed using the official icon name. To do this, you can use |\faIcon{the-icon-name}| or |\faIcon[style]{the-icon-name}|.
+
+A list of all included icons with their respective commands can be found at the end of this document.
 
 \subsection*{Example}
 \begin{verbatim}
@@ -65,7 +69,7 @@ Now additional icons and the |light| style can be used.
 Pro is only supported with \XeLaTeX{} and \LuaLaTeX.
 
 \subsection*{Updates}
-This package corresponds to Font Awesome 5.8.0.
+This package corresponds to Font Awesome 5.9.0.
 In case there is a newer version available on the Font Awesome homepage, check for updates on \url{https://ctan.org/pkg/fontawesome5}. Should there be no corresponding update on CTAN, you can write a mail to \href{mailto:tex@2krueger.de}{\nolinkurl{tex@2krueger.de}}.
 If you use \XeLaTeX{} or \LuaLaTeX{}, you can also directly download the new Desktop Fonts from \url{https://fontawesome.com} into your \TeX{} tree. If you save them with the filenames\\
 {\ttfamily\begin{tabular}{l}
@@ -77,4 +81,6 @@ the package will start using the new version right away.
 
 \subsection*{Bugs}
 For bug reports and feature requests, write to \href{mailto:tex@2krueger.de}{\nolinkurl{tex@2krueger.de}}.
+
+\input{fulllist}
 \end{document}
diff --git a/Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex b/Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex
new file mode 100644
index 00000000000..071dd165b44
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/fontawesome5/fulllist.tex
@@ -0,0 +1,100 @@
+\ExplSyntaxOn
+\msg_new:nnnn {fontawesome5} {list/no-shorthand} {No~shorthand~defined~for~icon~#1.} {
+  It~looks~like~#1~need~special~handling~in~fulllist.tex~but~there~are~
+  no~appropriate~definitions.~Ask~a~wizard~to~add~#1~to~fulllist.tex~to~
+  fix~this.
+}
+\tl_new:N \g__fontawesome_last_name_tl
+\tl_new:N \g__fontawesome_last_cs_tl
+\prg_new_protected_conditional:Nnn \__fontawesome_if_regular_style:nn {T} {
+  \str_if_eq:nnTF {#1} {free3} {
+    \prg_return_false:
+  }
+  {
+    \group_begin:
+      \usefont{U}{fontawesome#1}{regular}{n}
+      \iffontchar\font#2
+        \group_insert_after:N \prg_return_true:
+      \else:
+        \group_insert_after:N \prg_return_false:
+      \fi:
+    \group_end:
+  }
+}
+\tracingonline1
+\showboxdepth\maxdimen
+\showboxbreadth\maxdimen
+\cs_new:Nn\__fontawesome_list_show_icon:nnnn{
+  \str_if_in:nnT{#3}{brands}{
+    \hfilneg\vbox to0.875em{\vfil\hbox to0pt{\hss\tiny\faTrademark\quad}\vfil}\hfil
+  }
+  \faIcon{#2}&\texttt{\textbackslash#1}&\texttt{\textbackslash faIcon\{#2\}}
+  \str_if_in:nnT{#3}{free}{
+    \__fontawesome_if_regular_style:nnT {#3} {#4} {
+      \\\faIcon[regular]{#2}&\texttt{\textbackslash#1[regular]}&\texttt{\textbackslash faIcon[regular]\{#2\}}
+    }
+  }
+  \tl_gset:Nn \g__fontawesome_last_cs_tl {#1}
+  \tl_gset:Nn \g__fontawesome_last_name_tl {#2}
+  \\
+}
+\cs_generate_variant:Nn \__fontawesome_list_show_icon:nnnn { fnnn }
+\cs_set:Nn\__fontawesome_def_icon:nnnnn{
+  \__fontawesome_list_show_icon:fnnn{
+    \tl_if_empty:nTF{#1}{
+      \str_if_eq:noTF{#2}{\g__fontawesome_last_name_tl-alt}{
+        \g__fontawesome_last_cs_tl*
+      }{
+        \cs_if_exist_use:cF {__fontawesome_list_real_cs_#2_tl} {
+          \msg_expandable_error:nnn {fontawesome5} {list/no-shorthand} {#2}
+        }
+      }
+    }{
+      \cs_to_str:N #1 % You might have noticed that #1 is a n-type argument, not N-type.
+      % This is not a mistake, the argument might contain additional characters after the initial cs
+      % which is passed to \cs_to_str:N
+    }
+  }{#2}{#3}{#4}
+}
+% Some icons are special for some reason. See fontawesome5.sty if you want to know why
+% they are singled out.
+\tl_const:cn{__fontawesome_list_real_cs_wifi_tl}{faWifi}
+\tl_const:cn{__fontawesome_list_real_cs_dice-d20_tl}{faDiceD20}
+\tl_const:cn{__fontawesome_list_real_cs_dice-d6_tl}{faDiceD6}
+\tl_const:cn{__fontawesome_list_real_cs_signal_tl}{faSignal}
+%
+\tl_const:cn{__fontawesome_list_real_cs_500px_tl}{faIcon\{500px\}}
+\tl_const:cn{__fontawesome_list_real_cs_arrows-alt_tl}{faArrows*}
+\tl_const:cn{__fontawesome_list_real_cs_cloud-download-alt_tl}{faCloudDownload*}
+\tl_const:cn{__fontawesome_list_real_cs_cloud-upload-alt_tl}{faCloudUpload*}
+\tl_const:cn{__fontawesome_list_real_cs_exchange-alt_tl}{faExchange*}
+\tl_const:cn{__fontawesome_list_real_cs_expand-arrows-alt_tl}{faExpandArrows*}
+\tl_const:cn{__fontawesome_list_real_cs_external-link-alt_tl}{faExternalLink*}
+\tl_const:cn{__fontawesome_list_real_cs_external-link-square-alt_tl}{faExternalLinkSquare*}
+\tl_const:cn{__fontawesome_list_real_cs_level-down-alt_tl}{faLevelDown*}
+\tl_const:cn{__fontawesome_list_real_cs_level-up-alt_tl}{faLevelUp*}
+\tl_const:cn{__fontawesome_list_real_cs_pencil-alt_tl}{faPencil*}
+\tl_const:cn{__fontawesome_list_real_cs_shield-alt_tl}{faShield*}
+\tl_const:cn{__fontawesome_list_real_cs_sign-in-alt_tl}{faSignIn*}
+\tl_const:cn{__fontawesome_list_real_cs_sign-out-alt_tl}{faSignOut*}
+\tl_const:cn{__fontawesome_list_real_cs_square-root-alt_tl}{faSquareRoot*}
+\tl_const:cn{__fontawesome_list_real_cs_tachometer-alt_tl}{faTachometer*}
+\tl_const:cn{__fontawesome_list_real_cs_ticket-alt_tl}{faTicket*}
+%
+\tl_const:cn{__fontawesome_list_real_cs_compress-arrows-alt_tl}{faCompressArrows*}
+\ExplSyntaxOff
+\newgeometry{textwidth=18cm}
+\subsection*{Full~icon~list~for~FontAwesome~5~Free}
+All icons marked with \vbox to0.875em{\vfil\hbox{\hss\tiny\faTrademark}\vfil} are brand icons.
+\begin{quote}
+  All brand icons are trademarks of their respective owners. The use of these
+  trademarks does not indicate endorsement of the trademark holder by Font
+  Awesome, nor vice versa. \emph{Please do not use brand logos for any purpose except
+  to represent the company, product, or service to which they refer.}
+\end{quote}
+\ExplSyntaxOn
+\begin{longtable}{cll}
+  \cs:w @@input\cs_end: fontawesome5-mapping.def~
+\end{longtable}
+\ExplSyntaxOff
+\restoregeometry