From 77362f5f4b083c21c2044b0c54d228da42804c72 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Thu, 1 Dec 2022 03:01:22 +0000
Subject: CTAN sync 202212010301

---
 graphics/circuit_macros/doc/defines.tex | 30 +++++++++++++++++++++---------
 1 file changed, 21 insertions(+), 9 deletions(-)

(limited to 'graphics/circuit_macros/doc/defines.tex')

diff --git a/graphics/circuit_macros/doc/defines.tex b/graphics/circuit_macros/doc/defines.tex
index 7ac3cbaed4..c2b800e509 100644
--- a/graphics/circuit_macros/doc/defines.tex
+++ b/graphics/circuit_macros/doc/defines.tex
@@ -442,9 +442,11 @@
     {\sl phase} )}
   {gen}
   {function $a\times\cos(\omega t + \phi)$ }
-\macrodef{cross}{cross}{(at {\sl location})}
+\macrodef{cross}{cross}{(at {\sl location, size}|{\sl keys})}
   {gen}
-  {plots a small cross}
+  {Plots a small cross.  The possible key-value pairs are:
+    {\tt size={\sl expr};},
+    {\tt line={\sl attributes};} }
 \macrodef{cross3D}{cross3D}{({\sl x1,y1,z1,x2,y2,z2})}
   {3D}
   {cross product of two triples}
@@ -693,9 +695,12 @@ B|b|CR|D|G|L|LE[R]|P[R]|S|Sh|T|U|V|v|w|Z|chars,%
 %\macrodef{dnm\_}{dnm_}{}
 %  {cct}
 %  {similar to dna\_}
-\macrodef{dot}{dot}{(at {\sl location},{\sl radius},{\sl fill})}
+\macrodef{dot}{dot}{(at {\sl location},{\sl radius}|{\sl keys},{\sl fill})}
   {gen}
-  {filled circle (third arg= gray value: 0=black, 1=white)}
+  {Filled circle (third arg= gray value: 0=black, 1=white). The possible
+   key-value pairs are:
+    {\tt rad={\sl expr};} and
+    {\tt circle={\sl attributes};} }
 \macrodef{dot3D}{dot3D}{({\sl x1,y1,z1,x2,y2,z2})}
   {3D}
   {dot product of two triples}
@@ -792,10 +797,15 @@ B|b|CR|D|G|L|LE[R]|P[R]|S|Sh|T|U|V|v|w|Z|chars,%
 \macrodef{elen\_}{elen_}{}
   {cct}
   {default element length}
-\macrodef{em\_arrows}{em_arrows}{([N|I|E][D],{\sl angle,length})}
-  {cct}
-  {radiation arrows, N=nonionizing, I=ionizing, E=simple;
-     D=dot\seesect{Twoterminal:}}
+\macrodef{em\_arrows}{em_arrows}{({\sl type}|{\sl keys,angle,length})}
+  {cct}
+  { Radiation arrows: {\sl type} {\tt N|I|E [D|T]}
+  {\tt N}=nonionizing, {\tt I}=ionizing, {\tt E}=simple;
+  {\tt D}=dot on arrow stem; {\tt T}=anchor tail;
+  {\sl keys:} {\tt type=}{\sl chars} as above;
+  {\tt lgth}={\sl expr};
+  {\tt sep}={\sl expr}; arrow separation
+  {\tt angle}={\sl degrees}; absolute direction\seesect{Twoterminal:}}
 \macrodef{endshade}{endshade}{}
   {gen}
   {end gray shading, see {\tt beginshade}}
@@ -1863,7 +1873,9 @@ justification})}
      with text label and a size-adjustment parameter }
 \macrodef{shade}{shade}{({\sl gray value},{\sl closed line specs})}
   {gen}
-  {Fill arbitrary closed curve}
+  {Fill arbitrary closed curve. Note: when producing pdf via pdflatex, line
+   thickness changes within this macro must be made via the {\tt linethick}
+   environment variable rather than by the {\tt thickness} line attribute}
 \macrodef{shadebox}{shadebox}{(box {\sl attributes, shade width})}
   {gen}
   {Box with edge shading.  Arg2 is in points. See also {\tt shaded} }
-- 
cgit v1.2.3

