Added advanced plotting functions: YH

`plot3`, `surf`, `mesh`, `stem`, `stairs`, `bar`

funDef.txt

@@ -831,7 +831,22 @@ ZG	1	inf	2	3	0	1	0		true	true	true	true	switch in{end}	control appearance of gra
 													end
 H	0	0	0		0	inf	numel(CB_H)		true	true	false	true	out = CB_H(1:nout);	paste from clipboard H	paste from clipboard H
 XH	0	inf	1	2	0	0	0		false	true	false	true	CB_H = in;	copy to clipboard H	copy to clipboard H
-YH
+YH	1	inf	2	4	0	0	0		true	true	true	true	switch in{end}	advanced plotting functions	Depending on numeric last input, calls a plotting function with the remaining inputs.  $0$: \matlab+plot3+.  $1$: \matlab+surf+.  $2$: \matlab+mesh+.  $3$: \matlab+stem+.  $4$: \matlab+stairs+.  $5$: \matlab+bar+.
+													case 0
+													plot3(in{1:end-1});
+													case 1
+													surf(in{1:end-1});
+													case 2
+													mesh(in{1:end-1});
+													case 3
+													stem(in{1:end-1});
+													case 4
+													stairs(in{1:end-1});
+													case 5
+													bar(in{1:end-1});
+													otherwise
+													error('MATL:runtime', 'MATL run-time error: unrecognized last input');
+													end
 ZH
 I	0	0	0		0	inf	numel(CB_I)		true	true	false	true	out = CB_I(1:nout);	paste from clipboard I	paste from clipboard I
 XI	0	inf	1		0	0	0		false	true	false	true	CB_I = in;	copy to clipboard I	copy to clipboard I

preLit.txt

@@ -207,6 +207,9 @@ Y0
 64	'spring'
 65	'summer'
 66	'winter'
+70	'filled'
+71	'grouped'
+72	'stacked'
 
 
 Y2

spec/MATL_spec.tex

@@ -1637,6 +1637,13 @@ \section{Detailed function definitions}
 \begin{small}
 \input{preLitTable/preLitTableY0}
 %\input{preLitTable/preLitTableY1}
+\end{small}
+\end{table}
+
+\begin{table}
+\centering
+\caption*{Table \ref{tab: preLit}: Output of predefined literal functions---\emph{continued}}
+\begin{small}
 \input{preLitTable/preLitTableY2}
 \end{small}
 \end{table}

spec/funDefTable/funDefTable.tex

@@ -107,6 +107,7 @@
 \matl{ZG} & 1-- (2 / 3) & 0--1 (0) & Depending on numeric last input, calls a graphic function or \matlab+format+ with the remaining inputs.  $0$: \matlab+format+.  $1$: \matlab+axis+. Calls \matlab+drawnow+ to update figure immediately. Flag strings in first to second-last inputs can be replaced by numbers, as follows: 1: \matlab+'equal'+, 2: \matlab+'image'+, 3: \matlab+'square'+, 4: \matlab+'ij'+, 5: \matlab+'xy'+, 6: \matlab+'normal'+, 7: \matlab+'off'+, 8: \matlab+'on'+, 9: \matlab+'tight'+, 10: \matlab+'manual'+, 11: \matlab+'fill'+, 12: \matlab+'auto'+, 13: \matlab+'vis3d'+.  $2$: \matlab+colormap+. If the first input is numeric, has the shape of a colormap, and has some entry greater than $1$, it is normalized by converting to \matlab+uint8+, then to \matlab+double+, and then dividing by $255$. With $0$ outputs, calls \matlab+drawnow+ to update figure immediately.  $3$: \matlab+hold+. Flag strings in first input can be replaced by numbers, as follows: 1: \matlab+'on'+, 2: \matlab+'off'+. \\
 \matl{H} & 0 & 0-- ($^\dagger$) & paste from clipboard H \\
 \matl{XH} & 0-- (1 / 2) & 0 & copy to clipboard H \\
+\matl{YH} & 1-- (2 / 4) & 0 & Depending on numeric last input, calls a plotting function with the remaining inputs.  $0$: \matlab+plot3+.  $1$: \matlab+surf+.  $2$: \matlab+mesh+.  $3$: \matlab+stem+.  $4$: \matlab+stairs+.  $5$: \matlab+bar+. \\
 \matl{I} & 0 & 0-- ($^\dagger$) & paste from clipboard I \\
 \matl{XI} & 0-- (1) & 0 & copy to clipboard I \\
 \matl{YI} & 3--4 (3 / 4) & 1 & \matlab+col2im+. Uses \matlab+'distinct'+ option by default. Second and third inputs may be scalars, and then they are interpreted as numbers of columns. Third input may be a two-vector with product less then the number of elements of first input, and then it is appropriately scaled. This function allows flag strings in fourth input to be replaced by numbers, as follows: 1: \matlab+'distinct'+, 2: \matlab+'sliding'+ \\

spec/preLitTable/preLitTableY0.tex

@@ -55,4 +55,7 @@
 \matl{64} & \matl{'spring'} &
 \matl{65} & \matl{'summer'} &
 \matl{66} & \matl{'winter'} \\ \hline
+\matl{70} & \matl{'filled'} &
+\matl{71} & \matl{'grouped'} &
+\matl{72} & \matl{'stacked'} \\ \hline
 \end{longtable}