\documentclass[11pt]{article}
\usepackage[body={6.5in,9in},top=1in,left=1in,nohead]{geometry}
\usepackage[pdftex]{color}
\usepackage[urlcolor=blue]{hyperref}
\usepackage{myguide}
\usepackage[T1]{fontenc}
\usepackage{lucidabr}

\hypersetup{pdftitle={README for Gretl on OS X},
  pdfsubject={gretl},
  pdfauthor={Allin Cottrell},
  pdfkeywords={},
  pdfpagemode={None},
  colorlinks=true
}

\begin{document}

\begin{center}
{\color{gold} \titlefont gretl} \\[1ex]
version 1.10.2 for Mac OS X \\[2ex]

\textit{GNU Regression, Econometrics and Time-series Library\\
  This is free software under the GNU General Public License.}

\end{center}

This package was tested on Mac OS X 10.6.8 (Snow Leopard) and 10.10
(Yosemite).  Hopefully it will work on later releases of OS X but it
will not work on releases earlier than 10.6. It is a 64-bit build.

\section{Installating the program}
\label{sec:install}

\textsf{Gretl} is distributed as a gzipped disk-image
(\texttt{.dmg.gz}).  Double-click to unzip it first.  Once you have a
\texttt{.dmg} file, double-click to mount the image, and open the
image in the Finder. (This may all happen automatically when you
double-click the \texttt{.dmg.gz} file.) Then drag \textsf{Gretl} to
somewhere suitable on your system (preferably your
\textsf{Applications} folder).  Once that is done, you can eject the
disk image and delete the \texttt{.dmg} and \texttt{.dmg.gz} files.

If you already have an older version of \textsf{Gretl} installed, the
update via dragging may fail. In that case you should open the
\textsf{Applications} folder in the Finder, delete the \textsf{Gretl}
item, then try the drag again.

To run gretl, double-click on the gretl program icon.  You can drag
this icon onto the dock if you want a quick launcher.

\section{Trouble-shooting}

If double-clicking on the gretl icon doesn't work for you, try
opening an Terminal window, navigate into the \textsf{MacOS}
folder inside \textsf{Gretl.app}, and execute 
\textsf{gretl.sh} manually.  That is, do something like:

\begin{verbatim}
cd /Applications/Gretl.app/Contents/MacOS
./gretl.sh
\end{verbatim}

Hopefully this will give you an informative error message.

If you are updating from a previous installation of gretl, it
is possible that your recorded user preferences may be out of
sync with current gretl.  The fix for that is to delete
your old preferences file.  In an xterm window, do:

\begin{verbatim}
rm -f ~/.gretl2rc
\end{verbatim}

\section{An installation oddity}

It appears that in some cases dragging \textsf{Gretl} from the disk
image to the \textsf{Applications} folder does not work correctly:
certain shared library files may get truncated to zero bytes. If that
happens it may be necessary to copy the files manually. To do this,
open the Mac Terminal application, and at the command line type

\begin{verbatim}
sudo rm -rf /Applications/Gretl.app
\end{verbatim}

then

\begin{verbatim}
cp -r /Volumes/gretl/Gretl.app /Applications
\end{verbatim}

or if you get ``permission denied,'' do it as the administrator:

\begin{verbatim}
sudo cp -r /Volumes/gretl/Gretl.app /Applications
\end{verbatim}

\section{Documentation}
\label{sec:doc}

When you start gretl, please consult the program's Help menu for
documentation in various formats.

\vspace{.25in}

\raggedright
Allin Cottrell \\
Wake Forest University \\
\texttt{cottrell@wfu.edu} \\
September 2015

\end{document}

%%% Local Variables: 
%%% mode: latex
%%% TeX-master: t
%%% End: 
