summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex')
-rw-r--r--Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex36
1 files changed, 24 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex b/Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex
index dc0738769f0..934e7813d74 100644
--- a/Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex
+++ b/Master/texmf-dist/doc/latex/circuit-macros/doc/body.tex
@@ -61,19 +61,20 @@ other diagrams in \latex and web documents.
The diagrams are defined in the simple \pic drawing language~\cite{KRpic}
augmented with \Mfour macros~\cite{KRm4}, and are
processed by \Mfour and a \pic processor to
-convert them to \TPGF, \PSTricks, other \latex-compatible code, or \SVG.
-In its basic form, the method has the advantages and disadvantages of
+convert them to \TPGF, \PSTricks, other \latex-compatible code, \SVG,
+or other formats.
+In its basic usage, the method has the advantages and disadvantages of
\tex itself, since it is macro-based and non-WYSIWYG,
with ordinary text input. The book from which the above quotation
is taken correctly points out that the payoff can be in quality of
-diagrams at the price of the time spent in learning how to draw them.
+diagrams at the price of the time spent in drawing them.
A collection of basic components, most based on IEC and IEEE
standards~\cite{IECstd,IEEEstd},
and conventions for their internal
structure are described. Macros such as these are only a starting
point, since it is often convenient to customize elements or to package
-combinations of them for particular drawings,
+combinations of them for particular drawings or contexts,
a process for which \Mfour\ and \pic\ are well suited.
\xection{Using the macros\label{Using:}}
@@ -205,7 +206,7 @@ produce {\sl file}{\tt.ps},
which can be printed or viewed using {\tt gsview}, for example.
For \TPGF,
Invoking PDFlatex on the source produces {\tt .pdf} output directly.
-The essential line is \verb|\input quick| whether or not the figure
+The essential line is \verb|\input quick| whether or not the {\tt figure}
environment is used.
The effect of the \Mfour command above is shown in \FR{ConfigA}.
@@ -255,10 +256,12 @@ The macros can be processed by \latex-specific
project software and by graphic applications such as
Pycirkuit~\cite{Mas2019}.
% Cirkuit~\cite{KDEApps2009}.
-Alternatively when many files are to be processed, a facility such as
-Unix ``make,'' which is also available in PC and Mac versions, can be employed
-to automate the required commands. On systems without such
-facilities, a scripting language can be used.
+Alternatively when many files are to be processed,
+% a facility such as
+Unix ``make,'' which is also available in PC and Mac versions,
+%can be employed to automate the required commands.
+is a simple and powerful tool for automating the required commands.
+On systems without such facilities, a scripting language can be used.
\item
The \Mfour commands illustrated above can be shortened to
@@ -445,8 +448,11 @@ a more complete manual~\cite{Raymond95} can be found in the GNU \groff\
package, and both are available on the web~\cite{KRpic,Raymond95}. Reading
either will give you competence with \pic in an hour or two. Explicit mention
of {\tt *roff} string and font constructs in these manuals should be replaced by
-their equivalents in the \latex context. A man-page language summary is
-appended to the \dpic manual~\cite{Aplevich2011}.
+their equivalents in the \latex context.
+%A man-page language summary is
+%appended to the \dpic manual~\cite{Aplevich2022}.
+The \dpic manual~\cite{Aplevich2022} includes a man-page lanuage
+summary in an appendix.
A web search will yield good discussions of ``little languages'';
for \pic in particular, see Chapter~9 of~\cite{Bentley88}.
@@ -1037,7 +1043,8 @@ and switches with numerous controls in \FR{Switches}.
and other macros.
\begin{figure}[h!t]
\input EmarrowsMan
- \caption{Radiation arrows: {\tt em\_arrows({\sl type, angle, length})}}
+ \caption{Radiation arrows: {\tt em\_arrows({\sl type}|{\sl keys,%
+ angle, length})}}
\label{Emarrows}
\end{figure}
The arrow stems are named {\sl A1}, {\sl A2},
@@ -2531,6 +2538,11 @@ There are at least three kinds of graphical elements to be considered:
{\tt scale} at the beginning of the diagram.
To change default sizes, redefine the appropriate parameters explicitly.
+\item \Dpic\ implements a {\tt scaled} attribute for objects, so you can
+ enclose the entire diagram (or part of it) in {\tt [ ]} brackets, thus:
+ {\tt [} \ldots {\sl drawing commands} {\tt ] scaled} $x$ where $x$ is a
+ scale factor.
+
\item The {\tt .PS} line can be used to scale the entire drawing, regardless
of its interior. Thus, for example, the line {\tt.PS 100/25.4}
scales the entire drawing to a width of 100$\,$mm.