CTAN sync 202305080304

1 files changed, 29 insertions, 15 deletions

diff --git a/graphics/pstricks/contrib/pst-optic/doc/pst-optic-doc.tex b/graphics/pstricks/contrib/pst-optic/doc/pst-optic-doc.tex
index 60ed1261f6..275db43b5a 100644
--- a/graphics/pstricks/contrib/pst-optic/doc/pst-optic-doc.tex
+++ b/graphics/pstricks/contrib/pst-optic/doc/pst-optic-doc.tex
@@ -1,14 +1,15 @@
-%% $Id: pst-func-doc.tex 64 2008-12-08 22:14:27Z herbert $
-\documentclass[11pt,english,BCOR10mm,DIV13,bibliography=totoc,parskip=false,smallheadings
-    headexclude,footexclude,oneside]{pst-doc}
-\usepackage[utf8]{inputenc}
+%% $Id: pst-optic-doc.tex 717 2023-05-07 18:46:46Z herbert $
+\DocumentMetadata{}
+
+\documentclass[11pt,english,bibliography=totoc,parskip=false,headings=small,
+    headinclude=false,footinclude=false,twoside,usegeometry]{pst-doc}
 \usepackage{pst-text}
 \usepackage{pst-optic}
 \let\pstOpticFV\fileversion
 \lstset{pos=t,wide=true,language=PSTricks,basicstyle=\footnotesize\ttfamily}
 \let\belowcaptionskip\abovecaptionskip
 %
-\usepackage[style=dtk]{biblatex}
+%\usepackage[style=dtk]{biblatex}
 \addbibresource{\jobname.bib}
 
 \begin{document}
@@ -595,18 +596,18 @@ The macro uses the law of Snell
 \frac{n_1}{n_2}&=\frac{\sin \beta}{\sin \alpha}\label{snell}
 \end{align}
 
-where the $n_1$ and $n_2$ are the refraction numbers with the predefined values 
-
-\begin{align}
-	n_1 &= 1 \\
-	n_2 &= 1.41 
-\end{align}
-
+where the $n_1$ and $n_2$ are the refraction numbers % with the predefined values 
+%
+%\begin{align}
+%	n_1 &= 1 \\
+%	n_2 &= 1.41 
+%\end{align}
+%
 and $\alpha$ the incoming abd $\beta$ the outgoing angle of the ray.
 
-The refractionnumbers have the internal names \Lnotation{refractA} and \Lnotation{refractB}.
+%The refractionnumbers have the internal names \Lnotation{refractA} and \Lnotation{refractB}.
 
-A total reflection instead of a refraction is possible, 
+A total reflection instead of a normal refraction is possible, 
 when the ray starts in a medium with a higher refrectionnumber. This happens when 
 $\sin\beta>1$ in Equ.~\ref{snell}. In this case we have $\alpha =\beta$, a 
 total reflection.
@@ -632,7 +633,8 @@ total reflection.
 \end{LTXexample}
 
 The macro needs the values for the four nodes, the two refractionnumbers and the name for 
-the end node. As you can see in the figure the end node of the ray is the intermediate 
+the end node which is on the intermediate line of $n_1$ and $n_2$. 
+As you can see in the figure the end node of the ray is the intermediate 
 point between the linear ray and the linear medium. The end node of the refracted ray has 
 the same name with an additional single quotation mark. In the figure the macro was called as 
 
@@ -640,8 +642,17 @@ the same name with an additional single quotation mark. In the figure the macro
 \Lcs{refractionRay}\Largr{A}\Largr{B}\Largr{C}\Largr{D}\Largb{1}\Largb{4}\Largb{E}
 \end{BDef}
 
+with
+
 \begin{align}n_1&<n_2\end{align}
 
+and with  the  endnode defined as $E'$ (internally defined). You can get longer lines
+with the optional argument \Lkeyword{nodesep} and negatives values:
+
+\begin{lstlisting}
+	\pcline[arrowscale=2,linewidth=1pt,linecolor=red,
+	    nodesepB=-2cm]{->}(E)(E')
+\end{lstlisting}
 
 It is no problem to draw a ray which is going straight through another medium. 
 It can be done by using the macro twice as shown in the following examples.
@@ -712,6 +723,8 @@ The outline of processing we have adopted is the Gernot Hoffmann
 one. For more details look into the document:
 \url{http://www.fho-emden.de/~hoffmann/prism16072005.pdf}
 
+
+\clearpage
 \subsection{Figure with default values and construction indications}
 
 
@@ -730,6 +743,7 @@ one. For more details look into the document:
 \end{pspicture*}
 \end{LTXexample}
 
+\clearpage
 \subsection{Color matches wavelength}
 
 \begin{LTXexample}[wide=false]