tikz-cd (20nov18)

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

6 files changed, 82 insertions, 39 deletions

diff --git a/Master/texmf-dist/doc/latex/tikz-cd/README b/Master/texmf-dist/doc/latex/tikz-cd/README
deleted file mode 100644
index 9f7eee20ada..00000000000
--- a/Master/texmf-dist/doc/latex/tikz-cd/README
+++ /dev/null
@@ -1,13 +0,0 @@
-tikz-cd -- Commutative diagrams with tikz
-=========================================
-
-The general-purpose drawing package tikz can be used to typeset
-commutative diagrams and other kinds of mathematical pictures,
-generating high-quality results.  The present package facilitates the
-creation of such diagrams by providing a convenient set of macros and
-reasonable default settings.  It also includes an arrow tip library
-closely matching the Computer Modern arrow tips, as well as a general
-mechanism to use the arrow tips from any math font in TikZ graphics.
-
-This software is distributed under the GNU General Public License,
-version 3 or later.
diff --git a/Master/texmf-dist/doc/latex/tikz-cd/README.md b/Master/texmf-dist/doc/latex/tikz-cd/README.md
new file mode 100644
index 00000000000..b988d1dc069
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tikz-cd/README.md
@@ -0,0 +1,16 @@
+tikz-cd — Commutative diagrams with TikZ
+========================================
+
+The general-purpose drawing package [TikZ][pgf] can be used to typeset
+commutative diagrams and other kinds of mathematical pictures,
+generating high-quality results.  This TikZ library facilitates the
+creation of such diagrams by providing a convenient set of macros and
+reasonable default settings.  It can be used in plain TeX, LaTeX and
+ConTeXt.  See [the manual][tikz-cd-doc] for further details and many
+examples.
+
+This software is distributed under the terms of the GNU General Public
+License, version 3 or later.
+
+[pgf]: https://ctan.org/pkg/pgf
+[tikz-cd-doc]: http://mirrors.ctan.org/graphics/pgf/contrib/tikz-cd/tikz-cd-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.pdf b/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.pdf
index f1d5a3a68cf..e4f8c8d40d0 100644
--- a/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.pdf
+++ b/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.tex b/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.tex
index 3fa1f0b9c14..b2e6cd6652e 100644
--- a/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.tex
+++ b/Master/texmf-dist/doc/latex/tikz-cd/tikz-cd-doc.tex
@@ -1,4 +1,4 @@
-% Copyright 2011, 2012, 2014 by Florêncio Neves <florencioneves@gmail.com>
+% Copyright 2011, 2012, 2014, 2018 by Augusto Stoffel
 %
 % This program is free software: you can redistribute it and/or modify
 % it under the terms of the GNU General Public License as published by
@@ -23,6 +23,7 @@
 \def\pgfautoxrefs{1}
 
 \documentclass[a4paper]{ltxdoc}
+\usepackage[hyphens]{url}
 
 \def\xcolorversion{2.00}
 
@@ -178,7 +179,7 @@ directory}{}}
 {\Large\bfseries Commutative diagrams with \tikzname}
 
 \vspace{1em}
-{Version 0.9e \qquad October 30, 2014}
+{Version 0.9f \qquad November 19, 2018}
 \end{center}
 
 \vspace{1.5em}
@@ -215,7 +216,7 @@ To invoke this package in \LaTeX, type
 \begin{verse}
     \index{tikz-cd@\protect\texttt{tikz-cd} package}%
     \index{Packages and files!tikz-cd@\protect\texttt{tikz-cd}}%
-    |\usepackage{tikz-cd}|
+    |\usepackage{tikz-cd}|%
 \end{verse}
 or load \tikzname{} and then type
 \begin{verse}%
@@ -636,10 +637,10 @@ it.
   \begin{verse}
     |/tikz/commutative diagrams/row sep/|\meta{size}
   \end{verse}
-stores a
-  \meta{value}, then it is read and |/tikz/row sep|=\meta{value} is
-  set.  If the key above is not initialized, then \meta{size} is
-  presumably a dimension, and |/tikz/row sep|=\meta{size} is set.
+  stores a \meta{value}, then it is read and
+  |/tikz/row sep|=\meta{value} is set.  If the key above is not
+  initialized, then \meta{size} is presumed to be a dimension, and
+  |/tikz/row sep|=\meta{size} is set.
 
   The initially available sizes, and their values, are
   the following:
@@ -706,13 +707,10 @@ Section \ref*{pgfman-section-matrices}.3.2 of the \pgfname{} manual
   cells, which is appropriate for large, displayed diagrams.  The
   present style removes some of this extra white space, and is
   intended for smaller diagrams that should blend with the surrounding
-  text, or very wide material that wouldn't fit on the page otherwise.
+  text, or very wide material that wouldn't fit the page otherwise.
 \end{stylekey}
 
-Keep in mind that while there are some legitimate uses for |{tikzcd}|
-diagrams on inline formulas, standard \LaTeX\ constructs such as
-|\overset| and |\xrigthtarrow| are often sufficient and should be
-preferred.  The picture below shows the (somewhat subtle) difference
+The picture below shows the (somewhat subtle) difference
 between the cramped and the non-cramped styles.
 
 \begin{codeexample}[pre=\minipage{6cm},post=\endminipage]
@@ -721,6 +719,11 @@ This \begin{tikzcd}[cramped, sep=small] A \arrow[r] & B \end{tikzcd} is a crampe
 This $A \to B$ is just a formula.
 \end{codeexample}
 
+Keep in mind that while there are some legitimate uses for |{tikzcd}|
+diagrams on inline formulas, standard \LaTeX\ constructs such as
+|\overset| and |\xrigthtarrow| are often sufficient and should be
+preferred.
+
 \begin{key}{/tikz/commutative diagrams/math mode=\meta{boolean}
      (default true)}
    This key determines whether or not the contents of a diagram are
@@ -821,7 +824,8 @@ Recall that it is possible to give a specific entry of a \tikzname{}
 matrix a name by using the \verb!|[!\meta{options}\verb!]|! syntax, as
 done for entry $C$ in the example below.  You must be careful not to
 create nodes whose name contains only the characters |l|, |r|, |u|,
-|d| if you want to refer to them using |from| or |to|.
+|d| if you want to refer to them using |from| or |to|.  The following
+illustrates several different uses of these keys.
 
 {\catcode`\|=12
 \begin{codeexample}[]
@@ -967,6 +971,21 @@ possible values for \meta{anchor}.
 \end{tikzcd}
 \end{codeexample}
 
+\begin{key}{/tikz/commutative diagrams/shorten=\meta{dimension}}
+  This key shortens each end of the arrow by \meta{dimension}.
+
+\begin{codeexample}[]
+\begin{tikzcd}
+  A \arrow[r, shift left]
+    \ar[r, shorten=2mm, shift right]
+    & B
+\end{tikzcd}
+\end{codeexample}
+\end{key}
+
+Note that the ends of an arrow can be shortened individually using
+\tikzname's built-in keys |shorten <| and |shorten >|.
+
 \subsection{Three-dimensional diagrams}
 \label{sec:crossing-over}
 
@@ -1027,6 +1046,20 @@ the distance between a label and the corresponding arrow.
   This key appends \meta{options} to |every label|.
 \end{key}
 
+\begin{stylekey}{/tikz/commutative diagrams/marking}
+  This style causes the label to be placed over the arrow.  It is
+  useful to decorate arrows using ordinary math symbols.
+
+\begin{codeexample}[]
+\begin{tikzcd}
+  A \arrow[r, "/" marking]
+    \arrow[rd, "\circ" marking]
+    & B \\
+    & C
+\end{tikzcd}
+\end{codeexample}
+\end{stylekey}
+
 \begin{stylekey}{/tikz/commutative diagrams/description}
   This style causes the label to be placed over the arrow, with the
   background filled.  The clearance around the label is determined by
@@ -1393,10 +1426,6 @@ stem makes certain assumptions about the font design and could fail in
 cases where unusual design choices are made.
 
 \begin{thebibliography}{9}
-% \bibitem{knuth}
-%   Donald Knuth,
-%   \emph{Important message to all users of \TeX}.
-%   Available at \url{http://www-cs-staff.stanford.edu/~uno/cm.html}
 \bibitem{lenders}
   Felix Lenders,
   \emph{Commutative diagrams using \tikzname}.
@@ -1407,7 +1436,7 @@ cases where unusual design choices are made.
   Available at \url{http://www.jmilne.org/not/CDGuide.html}.
 \bibitem{pgfman}
   Till Tantau,
-  \emph{The \tikzname{} and \pgfname{} packages:  Manual for version 3.0.0}.
+  \emph{The \tikzname{} and \pgfname{} packages:  Manual for version 3.0.1a}.
   Available at \url{http://mirrors.ctan.org/graphics/pgf/base/doc/pgfmanual.pdf}.
 \end{thebibliography}
 
diff --git a/Master/texmf-dist/tex/generic/tikz-cd/tikzlibrarycd.code.tex b/Master/texmf-dist/tex/generic/tikz-cd/tikzlibrarycd.code.tex
index b5ab8c2d10a..1879a235a72 100644
--- a/Master/texmf-dist/tex/generic/tikz-cd/tikzlibrarycd.code.tex
+++ b/Master/texmf-dist/tex/generic/tikz-cd/tikzlibrarycd.code.tex
@@ -1,6 +1,6 @@
-% tikzlibrarycd.code.tex [2014/10/30 v0.9e Commutative diagrams with tikz]
+% tikzlibrarycd.code.tex [2018/11/19 v0.9f Commutative diagrams with TikZ]
 %
-% Copyright 2011, 2012, 2014 by Florêncio Neves <florencioneves@gmail.com>
+% Copyright 2011, 2012, 2014, 2018 by Augusto Stoffel
 %
 % This program is free software: you can redistribute it and/or modify
 % it under the terms of the GNU General Public License as published by
@@ -26,12 +26,23 @@
   labels/.code={\tikzcdset{every label/.append style={#1}}},
   cells/.code={\tikzcdset{every cell/.append style={#1}}},
   diagrams/.code={\tikzcdset{every diagram/.append style={#1}}},
-  execute before arrows/.code={\expandafter\def\expandafter\tikzcd@before@paths@hook\expandafter{\tikzcd@before@paths@hook#1}},
+  execute before arrows/.code={%
+    \expandafter\def%
+    \expandafter\tikzcd@before@paths@hook%
+    \expandafter{\tikzcd@before@paths@hook#1}},
   to/.code={\tikzcd@setarrowend\tikzcd@ar@target{#1}},
   from/.code={\tikzcd@setarrowend\tikzcd@ar@start{#1}},
+  shorten/.style={
+    /tikz/shorten <=#1,
+    /tikz/shorten >=#1},
   description/.style={
     /tikz/anchor=center,
     /tikz/fill=\pgfkeysvalueof{/tikz/commutative diagrams/background color}},
+  marking/.style={
+    /tikz/font=,
+    /tikz/sloped,
+    /tikz/shape=asymmetrical rectangle,
+    /tikz/anchor=center},
   phantom/.style={
     /tikz/draw=none,
     /tikz/commutative diagrams/labels={
@@ -51,7 +62,7 @@
   math mode/.is if=tikzcd@mathmode,
   arrow style/.is choice}
 
-\def\tikzcd@sep#1#2{
+\def\tikzcd@sep#1#2{%
   \pgfkeysifdefined{/tikz/commutative diagrams/#1 sep/#2}%
     {\pgfkeysgetvalue{/tikz/commutative diagrams/#1 sep/#2}\tikzcd@temp%
      \pgfkeysalso{/tikz/#1 sep/.expand once=\tikzcd@temp}}%
@@ -382,13 +393,13 @@
   cache=false,
   bending mode=none,
   parameters={\tikzcd@glyph@len,\tikzcd@glyph@shorten},
-  setup code={
+  setup code={%
     \pgfarrowssettipend{\tikzcd@glyph@len\advance\pgf@x by\tikzcd@glyph@shorten}},
   defaults={
     glyph axis=axis_height,
     glyph length=+0.9ex,
     glyph shorten=+-0.1ex},
-  drawing code={
+  drawing code={%
     \pgfpathrectangle{\pgfpoint{+0pt}{+-1ex}}{\pgfpoint{+\tikzcd@glyph@len}{+2ex}}%
     \pgfusepathqclip%
     \pgftransformxshift{+\tikzcd@glyph@len}%
diff --git a/Master/texmf-dist/tex/latex/tikz-cd/tikz-cd.sty b/Master/texmf-dist/tex/latex/tikz-cd/tikz-cd.sty
index e94b351828a..00837096e48 100644
--- a/Master/texmf-dist/tex/latex/tikz-cd/tikz-cd.sty
+++ b/Master/texmf-dist/tex/latex/tikz-cd/tikz-cd.sty
@@ -1,4 +1,4 @@
-% Copyright 2011, 2012, 2014 by Florêncio Neves <florencioneves@gmail.com>
+% Copyright 2011, 2012, 2014, 2018 by Augusto Stoffel
 %
 % This program is free software: you can redistribute it and/or modify
 % it under the terms of the GNU General Public License as published by
@@ -13,7 +13,7 @@
 % You should have received a copy of the GNU General Public License
 % along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-\ProvidesPackage{tikz-cd}[2014/10/30 v0.9e Commutative diagrams with tikz]
+\ProvidesPackage{tikz-cd}[2018/11/19 v0.9f Commutative diagrams with TikZ]
 \RequirePackage{tikz}[2013/12/13] % pgf version 3.0.0 required
 \usetikzlibrary{cd}