update latex tutorial

Author: sfeam

ChangeLog

@@ -1,6 +1,7 @@
 2010-09-16  Ethan A Merritt  <[email protected]>
 
-	* tutorial/eg2.plt tutorial/eg6.plt tutorial/tutorial.tex:
+	* tutorial/eg2.plt tutorial/eg6.plt tutorial/test_tikz.plt 
+	tutorial/Makefile.am.in tutorial/header.tex tutorial/tutorial.tex:
 	Update the LaTeX tutorial a bit.  More could be done.
 
 2010-09-15  Ingo Thies  <[email protected]>

tutorial/Makefile.am.in

@@ -9,7 +9,7 @@ header.tex makefile.dst tutorial.tex eg3.dat
 
 CLEANFILES = tutorial.aux tutorial.dvi tutorial.log tutorial.pdf tutorial.ps \
 tutorial.toc eg1.tex eg2.tex eg3.tex eg4.tex eg5.tex eg6.tex eg7.tex \
-eg7.eps eg7.pdf test.tex
+eg7.eps eg7.pdf test.tex test_tikz.tex
 
 DVIPS = dvips
 LATEX = @LATEX@
@@ -38,7 +38,7 @@ tutorial.dvi: eg1.tex eg2.tex eg3.tex eg4.tex eg5.tex eg6.tex eg7.tex eg7.eps te
 	TEXINPUTS=.:$(srcdir):${TEXINPUTS}: $(LATEX) tutorial
 	TEXINPUTS=.:$(srcdir):${TEXINPUTS}: $(LATEX) tutorial
 
-tutorial.pdf: eg1.tex eg2.tex eg3.tex eg4.tex eg5.tex eg6.tex eg7.tex eg7.pdf test.tex \
+tutorial.pdf: eg1.tex eg2.tex eg3.tex eg4.tex eg5.tex eg6.tex eg7.tex eg7.pdf test.tex test_tikz.tex \
 	tutorial.tex header.tex
 	@echo "Building LaTeX tutorial (PDF version)"
 	TEXINPUTS=.:$(srcdir):${TEXINPUTS}: $(PDFLATEX) tutorial

tutorial/header.tex

@@ -69,11 +69,15 @@
 
 % Other packages
 \usepackage{url}
+\usepackage{subfigure}
 
 % Only needed for epslatex driver
 \usepackage{graphicx}
 \usepackage{color}
 
+% Only needed for the tikz driver
+\usepackage{gnuplot-lua-tikz}
+
 % Margins
 \sloppy
 \setlength{\textwidth}{6.5in}

tutorial/test_tikz.plt

@@ -0,0 +1,3 @@
+set term tikz
+set out "test_tikz.tex"
+test

tutorial/tutorial.tex

@@ -1,5 +1,5 @@
 %
-% $Id: tutorial.tex,v 1.8 2010/09/17 03:05:25 sfeam Exp $
+% $Id: tutorial.tex,v 1.9 2010/09/17 20:58:12 sfeam Exp $
 %
 % Tutorial for gnuplot plotting program, for LaTeX users
 % David Kotz
@@ -33,7 +33,7 @@
 {\bf current gnuplot team} \\[0.4cm]
 Updates of this tutorial for gnuplot 4.0, March 2004 \\
 Update of this tutorial for gnuplot 4.2, August 2006 \\
-Update of this tutorial for gnuplot 4.4, August 2010
+Update of this tutorial for gnuplot 4.4, September 2010
 
 \vskip2cm
 
@@ -68,8 +68,7 @@ \section{Introduction and History}
 In late 1989 and early 1990 Gnu\TeX\ and a number of other gnuplot
 variants were merged together into a new release of gnuplot, 2.0. This
 includes, among many other improvements, a \LaTeX\ driver derived from
-the one in Gnu\TeX. Former Gnu\TeX\ users are referred to
-Section~\ref{oldusers} for information about adapting to gnuplot.
+the one in Gnu\TeX.
 Anyone interested in using gnuplot with \LaTeX\ should read the next
 section, a tutorial, and the primary gnuplot manual.
 
@@ -89,9 +88,6 @@ \section{Introduction and History}
 available for \verb+ftp+ as \verb+pub/gnuplot-latex.shar+ from
 \verb+cs.duke.edu+.
 
-NB: There is also a much more recent tikz latex terminal that
-is not described in this tutorial.
-
 \section{Using gnuplot for \LaTeX: a Tutorial}
 
 Gnuplot is by nature an interactive program. Users making plots for
@@ -178,13 +174,13 @@ \section{Using gnuplot for \LaTeX: a Tutorial}
 \end{verbatim}
 \currentspace
 
-\boxfigure{htbp}{\fullboxwidth}{
+\begin{figure}[htbp]
   \begin{center}
     \input{eg2}
   \end{center}
-  \caption{A more fancy example.}
+  \caption{A fancier example.}
   \label{eg2}
-}
+\end{figure}
 
 We have specified the plot to be 7 cm wide and 5 cm tall with
 the {\tt set term latex size ...} command. This is the size of the 
@@ -263,7 +259,7 @@ \section{Using gnuplot for \LaTeX: a Tutorial}
 each data point.  The {\tt points} and {\tt linespoints} styles
 produce a different point symbol for each curve on the plot (for up to
 twelve symbols, after which they are re-used; see
-Figure~\ref{test} for a complete list). The {\tt lines} and {\tt
+Figure~\ref{testcomp} for a complete list). The {\tt lines} and {\tt
 linespoints} styles use a different line style for each curve on the
 plot (in this example the dots have different spacing). The
 style {\tt impulses} draws a perpendicular from each point to the
@@ -361,27 +357,19 @@ \section{Using gnuplot for \LaTeX: a Tutorial}
 \end{verbatim}
 \currentspace
 
-\boxfigure{htbp}{\fullboxwidth}{
+\begin{figure}
   \begin{center}
     \input{eg6}
   \end{center}
   \caption{An example of many features.}
   \label{eg6}
-}
+\end{figure}
 
 \paragraph{Line and point types:} For reference, we show all of the
-line and point types available in Figure~\ref{test}.
-
-\boxfigure{htbp}{\fullboxwidth}{
-  \begin{center}
-    \input{test}
-  \end{center}
-  \caption{All of the line and point types in the \LaTeX\ driver.}
-  \label{test}
-}
+line and point types available in Figure~\ref{testcomp}.
 
 \subsection{Summary --- Use with \LaTeX}
-In summary, to use the \LaTeX\ facilities of gnuplot, the first
+In summary, to use the most basic \LaTeX\ mode of gnuplot, the first
 command to gnuplot should be
 \begin{syntax}
     set terminal latex
@@ -445,7 +433,8 @@ \section{Use with EEPIC}
 \section{What is new for \TeX{} and \LaTeX{} terminals in gnuplot 4.0}
 
 In addition to the \texttt{latex} terminal, the following \LaTeX-friendly
-terminals are available:
+terminals are available. The gnuplot documentation contains more information
+about the options and usage for each of these.
 
 \begin{itemize}
 \item \texttt{emtex}: Like the \texttt{latex} terminal, but supports emtex
@@ -463,11 +452,6 @@ \section{What is new for \TeX{} and \LaTeX{} terminals in gnuplot 4.0}
 
 \end{itemize}
 
-See helps of these terminals for more details about their usage.
-
-In addition, the \texttt{postscript eps enhanced} is the most useful for \TeX{}
-and \LaTeX{} if you don't insist on using \TeX{} fonts for the graph labels, and
-\texttt{pdf enhanced} and \texttt{png enhanced} for pdf\LaTeX{}.
 
 \section{What is new for \TeX{} and \LaTeX{} terminals in gnuplot 4.4}
 
@@ -476,7 +460,8 @@ \section{What is new for \TeX{} and \LaTeX{} terminals in gnuplot 4.4}
 \item \texttt{pslatex and epslatex}:  Rewritten version.  See the example below. 
 
 \item \texttt{tikz}:  Much improved graphics compaired to earlier \LaTeX terminals.  
-Requires a lua interpreter as an intermediate processing step.
+Requires a lua interpreter that is called by gnuplot. Compare the output
+of the \texttt{test} command to that from the minimal latex terminal.
 
 \end{itemize}
 
@@ -517,6 +502,18 @@ \section{Sample of epslatex terminal driver}
   \label{epslatex_test}
 }
 
+\begin{figure}[htbp]
+  \begin{center}
+
+  \subfigure[Line and point types in the latex driver]
+            {\input{test}}
+  \subfigure[Line and point types in the tikz driver]
+            {\input{test_tikz}}
+  
+  \end{center}
+  \caption{The exact line and point types available depend on the terminal type.}
+  \label{testcomp}
+\end{figure}
 
 \section{Contact for help}