summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/circuitikz
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-07-06 20:31:34 +0000
committerKarl Berry <karl@freefriends.org>2021-07-06 20:31:34 +0000
commitd045558bbb6184c258cfc1daa90ab4e47a1b224d (patch)
tree5d3aadccdbf11ac79a51b0775f316ab4868233e3 /Master/texmf-dist/doc/latex/circuitikz
parentb97f297879f8d65309e8fd032505a072bbb8e6d1 (diff)
circuitikz (6jul21)
git-svn-id: svn://tug.org/texlive/trunk@59856 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/circuitikz')
-rw-r--r--Master/texmf-dist/doc/latex/circuitikz/changelog.tex19
-rw-r--r--Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.pdfbin1427563 -> 1428626 bytes
-rw-r--r--Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.tex34
3 files changed, 49 insertions, 4 deletions
diff --git a/Master/texmf-dist/doc/latex/circuitikz/changelog.tex b/Master/texmf-dist/doc/latex/circuitikz/changelog.tex
index 88a0f200860..1266d820075 100644
--- a/Master/texmf-dist/doc/latex/circuitikz/changelog.tex
+++ b/Master/texmf-dist/doc/latex/circuitikz/changelog.tex
@@ -5,6 +5,25 @@ full list of changes.
\begin{itemize}
\item
+ Version 1.4.0 (2021-07-06)
+
+ The main news is that \emph{package rollback} for \texttt{circuitikz}
+ has been implemented (LaTeX-only, of course). Additionally, a small
+ but important change in the path (\texttt{to}) construction that
+ should fix some warning from Ti\emph{k}Z and give better line joins in
+ wire corners.
+
+ \begin{itemize}
+ \tightlist
+ \item
+ bump version to 1.4.0
+ \item
+ implement the version rollback: time travel to 0.4!
+ \item
+ remove a wrong movement in the path construction (potentially
+ dangerous)
+ \end{itemize}
+\item
Version 1.3.9 (2021-06-27)
Bugfix release: \texttt{open\ poles\ opacity} was not working in most
diff --git a/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.pdf b/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.pdf
index f6116a8d60f..239c0f6a5d9 100644
--- a/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.pdf
+++ b/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.tex b/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.tex
index b32056d02a9..10a4a9b4831 100644
--- a/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.tex
+++ b/Master/texmf-dist/doc/latex/circuitikz/circuitikzmanual.tex
@@ -224,6 +224,8 @@ The \texttt{use fpu reciprocal} key seems to have no side effects, but given tha
Here, we will provide a list of incompabilitys between different version of \Circuitikz. We will try to hold this list short, but sometimes it is easier to break with old syntax than including a lot of switches and compatibility layers. In general, changes that would invalidate a circuit (changes of polarity of components and so on) are almost always protected by a flag; the same is not true for purely aesthetic changes.
If unsure, you can check the version at your local installation using the macro \verb!\pgfcircversion{}!.
\begin{itemize}
+ \item \texttt{v1.4.0} introduce the rollback system for the package when using LaTeX; that (at least in principle) should be completely backeard-compatible.
+ \item The path construction in \texttt{v1.4.0} has been changed a bit (again). The change shouldn't break any circuit and correct a behavior that should have been fixed with the \texttt{v1.2.1} change (see below).
\item Version 1.3.6 fixes several problems with the stacked labels; the most important change is that now the bracing of arguments is respected as in version 1.3.0 for the other labels. The special treatment in stacked labels (and only in stacked labels!) for the (still experimental\footnote{and, really, not advised\dots}) \texttt{siunitx} compact syntax \texttt{<...>} has been removed: it was completely buggy before, and silently ignored, now will throw an error.
\item Version 1.3.3 fixes the direction of the arrows in tunable elements; before this version, they were more or less random, now the arrow goes from bottom left to top right. You have the option to go back to the old behavior with \texttt{\textbackslash ctikzset\{bipoles/fix tunable direction=false\}}. As a compensation for the fuss, now the arrows are configurable. To learn more, see the FAQ:~\ref{faq:tunable-arrow}.
\item Version 1.3.1 removes the warning if you do not specify a voltage direction.
@@ -257,13 +259,25 @@ If you have older projects that show compatibility problems, you have two option
\begin{itemize}
\item you can use an older version locally using the git-version and picking the correct commit from the repository (branch gh-pages) or the main GitHub site directly;
\item if you are using \LaTeX, the distribution has embedded several important old versions: \texttt{0.4}, \texttt{0.6}, \texttt{0.7}, \texttt{0.8.3}, \texttt{0.9.3}, \texttt{0.9.6}, \texttt{1.0}, \texttt{1.1.2} and \texttt{1.2.7}.
- To switch to use them, you simply change your \verb|\usepackage| invocation like
- \begin{lstlisting}
+ To switch to use them, since \texttt{v1.4.0} you simply use the \href{https://www.latex-project.org/publications/2018-FMi-TUB-tb122mitt-version-rollback.pdf}{new LaTeX kernel rollback system}, changing your \verb|\usepackage| invocation to something like:
+ \begin{lstlisting}[numbers=none]
+ \usepackage[]{circuitikz}[=v0.8.3] % or v0.4, v0.6, ...
+ \end{lstlisting}
+ You can also specify a date instead of a version number: if you write
+ \begin{lstlisting}[numbers=none]
+ \usepackage[]{circuitikz}[=2020/02/05]
+ \end{lstlisting}
+ the rollback system will load the version that was current on February 5th,~2020 (in this case it will be \texttt{v1.0} which was released the day before).
+
+ If for whatever reasons your kernel is older, you can still use the old method of loading the \emph{package-version} package; for example:
+ \begin{lstlisting}[numbers=none]
\usepackage[]{circuitikz-0.8.3} % or circuitikz-0.4, 0.6...
\end{lstlisting}
- You have to take care of the options that may have changed between versions;
+ which is an inferior solution because it can fool any package you use that depend on \texttt{circuitikz}.
+
+ Both ways, you have to take care of the options that may have changed between versions (and sometime syles, if you use them).
\item if you are using \ConTeXt, only versions \texttt{0.8.3}, \texttt{0.9.3}, \texttt{0.9.6}, \texttt{1.0}, \texttt{1.1.2} and \texttt{1.2.7} are packaged; if can use it with
- \begin{lstlisting}
+ \begin{lstlisting}[numbers=none]
\usemodule[circuitikz-0.8.3]
\end{lstlisting}
\end{itemize}
@@ -1649,6 +1663,18 @@ If you want to add a setting to your style file that has been recently added to
thyristor style/.try=compact,
\end{lstlisting}
+Or, in case of new values of existing ``choice'' keys, you can use the syntax:
+
+\begin{lstlisting}[frame=single, framesep=10pt]
+ % Logic ports
+ logic ports/ieee/.try,
+ % this way of setting the key does nothing if ieee option
+ % does not exist; logic ports/.try=ieee does not work
+ % if the key exists but the value is not defined
+ logic ports/scale=1.0,
+\end{lstlisting}
+
+
\subsection{Subcircuits}\label{sec:subcircuits}
Starting from version \texttt{1.3.5}, there is an \textbf{experimental}\footnote{That means that in future releases the interface can change; use it at your risk and if you need it to continue working as-is, please use the \href{https://circuitikz.github.io/circuitikz/}{GitHub project page} and download and save the \texttt{circuitikzgit.sty} file for future-proof use!} support for generating sub-circuits, or circuits blocks. The creation and use of subcircuits is somewhat limited, to keep them simple and easy to define and maintain.