From 6d56f935e68d3edbe7afc8613d516999443019fb Mon Sep 17 00:00:00 2001
From: Karl Berry <karl@freefriends.org>
Date: Wed, 29 Jan 2014 22:39:05 +0000
Subject: chemmacros (29jan14)

git-svn-id: svn://tug.org/texlive/trunk@32817 c570f23f-e606-0410-a88d-b1316a301751
---
 .../doc/latex/chemmacros/chemgreek_en.tex          | 45 ++++++++++++++++++----
 1 file changed, 38 insertions(+), 7 deletions(-)

(limited to 'Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex')

diff --git a/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex b/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex
index 6cc4e45adb1..c26422e4167 100644
--- a/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex
+++ b/Master/texmf-dist/doc/latex/chemmacros/chemgreek_en.tex
@@ -1,7 +1,7 @@
-% !arara: pdflatex
-% arara: biber
-% !arara: pdflatex
+% arara: pdflatex: { shell: on }
+% !arara: biber
 % arara: pdflatex
+% !arara: pdflatex
 % --------------------------------------------------------------------------
 % the CHEMMACROS bundle
 %   chemgreek_en.tex
@@ -75,7 +75,7 @@
       newman, nitrogen, NMR, Nu, Nuc,
     orbital, ortho, ox, OX, oxygen,
     para, pch, per, pH, phase, phosphorus, photon, pKa, pKb, pOH, pos,
-      positron, Pot, prt,
+      positron, Pot, prt, printchemgreekalphabet ,
     Rad, redox, RenewChemArrow, RenewChemBond, renewchemgreekmapping,
       RenewChemIUPAC, RenewChemLatin, RenewChemNMR, RenewChemParticle,
       RenewChemPhase, RenewChemState,
@@ -103,8 +103,8 @@
     ominus, oplus,
     percent, pgfarrowsdeclarealias, pgfarrowsrenewalias,
     renewtagform, rightarrow,
-    sample, scriptscriptstyle, setatomsep, setbondoffset, sfrac, shorthandoff,
-      si, SI, sisetup, square, subsection,
+    sample, scriptscriptstyle, setatomsep, setbondoffset, setmainfont, sfrac,
+      shorthandoff, si, SI, sisetup, square, subsection,
     textcolor, textendash, textsuperscript, tiny, toprule,
     upbeta, upeta, upgamma, upPhi, upphi, usetikzlibrary,
     volt, vphantom, vspave,
@@ -317,6 +317,14 @@ used by \chemmacros\ and its \acs{iupac} naming commands.
     about \cs*{texorpdfstring}.
 \end{itemize}
 
+\subsection{Version~0.4}
+\begin{itemize}
+  \item The mapping ``fontspec'' has been added.  In order to use it you
+    need the \pkg{fontspec} package~\cite{pkg:fontspec} loaded.  This means it
+    can only be used with \LuaLaTeX\ or \XeLaTeX.
+  \item New command \cs{printchemgreekalphabet}.
+\end{itemize}
+
 \section{Define Mappings}
 \selectchemgreekmapping{default}
 
@@ -392,7 +400,10 @@ available mappings.
 \section{Predefined Mappings and Selection of a Mapping}
 \chemgreek\ predefines some mappings.  Some of the mappings require additional
 packages to be loaded.  The mapping names and the required packages are listed
-in table~\ref{tab:mappings}.
+in table~\ref{tab:mappings}.  Ths mapping \code{fontspec} is a bit different
+here:  if you use this mapping then the fact is used that \pkg{fontspec} also
+defines commands like \cs*{textalpha}.  However, they only work if you also
+use a font that has the Greek glyphs.
 
 \begin{table}
   \centering
@@ -409,6 +420,7 @@ in table~\ref{tab:mappings}.
       mathdesign  & \pkg{mathdesign} \cite{pkg:mathdesign} \\
       fourier     & \pkg{fourier} \cite{pkg:fourier} \\
       textalpha   & \pkg{textalpha} \cite{bnd:greek-fontenc} \\
+      fontspec    & \pkg{fontspec} \cite{pkg:fontspec} \\
     \bottomrule
   \end{tabular}
   \caption{Predefined mappings.}
@@ -437,6 +449,21 @@ A mapping is selected and activated with one of the following commands:
   \chemphi\ and \chemPhi, $\upphi$ and $\upPhi$
 \end{example}
 
+Since the \code{fontspec} mapping is a little bit different than the others
+I'd like to show a little example for it.  The difference is subtle: you need
+to choose a font containing the needed glyphs.
+
+\begin{example}[compile,program=lualatex,runs=1,add-frame=false]
+  \documentclass[margin=3pt]{standalone}
+  \usepackage{fontspec}
+  \setmainfont{Linux Libertine O}% need a font that has the glyphs!
+  \usepackage{chemgreek}
+  \selectchemgreekmapping{fontspec}
+  \begin{document}
+  \printchemgreekalphabet
+  \end{document}
+\end{example}
+
 \section{Changing a Specific Symbol in an Existing Mapping}
 If you should want to change a specific entry of a specific mapping it would
 be rather tedious to redefine the whole mapping.  That is why \chemgreek\
@@ -458,6 +485,7 @@ mapping afterwards:
 \end{example}
 
 \section{Inspecting a Mapping}
+\selectchemgreekmapping{newtx}
 If you want to check if a mapping has been correctly set you can use the
 following commands:
 \begin{commands}
@@ -465,6 +493,9 @@ following commands:
     \sinceversion{0.3}This will typeset a table (using a simple \code{tabular}
     environment) with all~48 characters like the one shown in
     table~\ref{tab:showmapping}.
+  \command{printchemgreekalphabet}
+    \sinceversion{0.4}This will print the twentyfour pairs of lower- and
+    uppercase letters of the currently active mapping: \printchemgreekalphabet.
   \command{showchemgreekmapping}[\marg{mapping}]
     \changedversion{0.3}This command will write information about the
     definition of all 48~macros for a mapping to the log file.
-- 
cgit v1.2.3

