\chapter{Troubleshooting gretl} \label{trouble} \section{Bug reports} \label{trouble-bugs} Bug reports are welcome. Hopefully, you are unlikely to find bugs in the actual calculations done by \app{gretl} (although this statement does not constitute any sort of warranty). You may, however, come across bugs or oddities in the behavior of the graphical interface. Please remember that the usefulness of bug reports is greatly enhanced if you can be as specific as possible: what \emph{exactly} went wrong, under what conditions, and on what operating system? If you saw an error message, what precisely did it say? \section{Auxiliary programs} \label{trouble-programs} As mentioned above, \app{gretl} calls some other programs to accomplish certain tasks (gnuplot for graphing, {\LaTeX} for high-quality typesetting of regression output, GNU R). If something goes wrong with such external links, it is not always easy for \app{gretl} to produce an informative error message. If such a link fails when accessed from the \app{gretl} graphical interface, you may be able to get more information by starting \app{gretl} from the command prompt rather than via a desktop menu entry or icon. On the X window system, start gretl from the shell prompt in an \app{xterm}; on MS Windows, start the program \cmd{gretlw32.exe} from a console window or ``DOS box'' using the \verb|-g| or \option{debug} option flag. Additional error messages may be displayed on the terminal window. Also please note that for most external calls, \app{gretl} assumes that the programs in question are available in your ``path'' --- that is, that they can be invoked simply via the name of the program, without supplying the program's full location.\footnote{The exception to this rule is the invocation of gnuplot under MS Windows, where a full path to the program is given.} Thus if a given program fails, try the experiment of typing the program name at the command prompt, as shown below. \begin{center} \begin{tabular}{llll} & \textit{Graphing} & \textit{Typesetting} & \textit{GNU R}\\ X window system & gnuplot & latex, xdvi & R\\ MS Windows & wgnuplot.exe & pdflatex & RGui.exe\\ \end{tabular} \end{center} If the program fails to start from the prompt, it's not a \app{gretl} issue but rather that the program's home directory is not in your path, or the program is not installed (properly). For details on modifying your path please see the documentation or online help for your operating system or shell. %%% Local Variables: %%% mode: latex %%% TeX-master: "gretl-guide" %%% End: