1\subsection{Insert a given knot into the description of a curve.}
2\funclabel{s1017}
3\begin{minipg1}
4  Insert a given knot into the description of a curve.\\
5  NOTE       : When the curve is periodic (i.e.\ the curve flag
6  $cuopen=-1$), the input parameter value must lie in the half-open
7  $[et[kk-1], et[kn)$ interval, the function will automatically update
8  the extra knots and  coeffisients. {\fov rcnew}{\tt ->}{\fov in} is
9  still equal to  $pc${\tt ->}$in + 1$!
10\end{minipg1} \\ \\
11SYNOPSIS\\
12        \>void s1017(\begin{minipg3}
13          {\fov pc},  {\fov rc},  {\fov apar},  {\fov jstat})
14        \end{minipg3}\\[0.3ex]
15        \>\>    SISLCurve \> *{\fov pc};\\
16        \>\>    int       \> *{\fov jstat};\\
17        \>\>    double    \> {\fov apar};\\
18        \>\>    SISLCurve \> **{\fov rc};\\
19\\
20ARGUMENTS\\
21        \>Input Arguments:\\
22        \>\>    {\fov pc}   \> - \> The curve to be refined.\\
23        \>\>    {\fov apar} \> - \> Parameter value of the knot to be inserted.\\
24\\
25        \>Output Arguments:\\
26        \>\>    {\fov rc}    \> - \> The new, refined curve.\\
27        \>\>    {\fov jstat} \> - \> Status message\\
28                      \>\>\>\>\> $> 0$ : Warning.\\
29                      \>\>\>\>\> $= 0$ : Ok.\\
30                      \>\>\>\>\> $< 0$ : Error.\\
31\\
32EXAMPLE OF USE\\
33        \>      \{ \\
34        \>\>    SISLCurve \> *{\fov pc};\\
35        \>\>    double    \> {\fov apar};\\
36        \>\>    SISLCurve \> *{\fov rc} = NULL;\\
37        \>\>    int       \> {\fov jstat} = 0;\\
38        \>\>    \ldots \\
39        \>\>s1017(\begin{minipg4}
40          {\fov pc},  \&{\fov rc},  {\fov apar}, \&{\fov jstat});
41        \end{minipg4}\\
42        \>\>    \ldots \\
43        \>      \}
44\end{tabbing}
45