%
% LessTifh.tex -- The ``Inside LessTif'' documentation for all those
%                hungry programmers.
%
% (c) 1996, 97 The Hungry Programmers
% (c) 1996, 97 Harald Albrecht (albrecht@igpm.rwth-aachen.de)
% See the file PUBLIC for details.
%

% The documentclass is set in LessTif.single.tex or LessTif.double.tex,
% but here we just aim at a latex2html compatible version
\documentclass[11pt,a4paper,oneside,openany]{book}

\usepackage{times}% We use P*stScr*pt fonts!
\usepackage{mathptm}
\usepackage{makeidx}
\usepackage{graphicx}

\usepackage{Hungry}% This must be the last style package in the list!
%
% Enable indexing and other goodies.
%
\makeindex
%
% First define a few important (well, more or less...) brand names...
%
\newcommand{\CSF}{\textsc{CSF}}
\newcommand{\Motif}{\textsc{M\makebox[.35em]{\raisebox{-.5ex}{*}}tif}}
\newcommand{\Unix}{\textsc{Un\makebox[.35em]{\raisebox{-.5ex}{*}}x}}
\newcommand{\LessTif}{\textsc{LessTif}}
\newcommand{\INSIDEL}{``Inside LessTif''}
% -----------------------------------------------------------------------------
% Here we really start our booklet. Let's begin with a fancy title page. Here
% we bypass LaTeX as its title page style looks too severe. The title page
% also features a simple drawing...
%
\begin{document}
\frontmatter
\pagestyle{hungry}
\setcounter{page}{0}
\parskip 0cm
\tableofcontents
\newpage
\listoftables
\newpage
\listoffigures
\parskip 7pt
%
%
%
\chapter{Foreword}
\by{~}

When I first heard rumors of \LessTif{}, I was already struggling for
years with the famous \Motif{} graphical user interface on different
hardware platforms. Every new day unveiled another and -- so to say --
exciting feature not written down in the official
documentation.

Needless to say that that official documentation was, and still is,
lacking the \emph{really} interesting aspects: writing not-so-trivial
\Motif{} widgets, how \Motif{}'s own geometry management utilities
work, what the BaseClass stuff is for, and many other
goodies. Ordinarily, this would be the time to ``read the source,
Luke''. Unfortunately, the great creator of \Motif{} -- the
\textsc{Closed Software Foundation} (or CSF for short) -- reveals the
source only to those willing to pay (``pay-per-view principle'').

Fortunately, \LessTif{} upheld the flag of ``providing open
technology'' from its early beginning: the source is freely available
under the terms of the GNU Public Library License.  And it is common
knowlegde that the source is also the source of information (``may the
source be with you...'').

Although standing on its own feet, \LessTif{} provides deep insight
not only into itself but also into the abyss of that other graphical
user interface called ``\Motif{}''. But browsing through the source
and understanding all the intrinsic and intricate things inside
\LessTif{} isn't an easy task. You can easily get lost. Or to cite
Mitch Miers and his law \#37 of programming:

\begin{quotation}
\vspace{-11pt}
\noindent\emph{Real Programmers don't write documentation, they leave that
to the tech writers.\\It was hard to code, it should be hard to
understand.}
\vspace{-11pt}
\end{quotation}

This is where \INSIDEL{} comes into play. Written by the creators of
\LessTif{}, this book provides a deep and thorough insight into this
free \Motif{} ``clone''. We show you all the mechanisms and smart
improvements behind the scenes.

This book is definitely not a beginner's guide but is aimed at the
programmer who has already a working knowledge of programming with --
or should I say: fighting against -- \Motif{}. A basic knowledge about
the Xt Intrinsics' widget class mechanism is necessary too.

I wish to thank especially all the authors for writing down their
first-hand knowledge about \LessTif{}. They had to cut off many
valueable spare hours from their coding time to make this
documentation real. Also my special thanks to Rob Blue, who has taken
the (maybe daunting but nevertheless very important) part of
proofreading.

\begin{flushright}
Harald Albrecht
\end{flushright}

\vspace*{\fill}
P.S.: If you find \INSIDEL{} to be useful (and we -- the authors --
are sure you will) then we ask you to donate a reasonable amount to a
charitable institution.

%
% ----------------------------------------------------------------------------
% Now for the text itself...  %
\mainmatter
\input{SyntheticResources.tex}
\input{BaseClass.tex}
\input{Grab.tex}
\input{Geometry.tex}
%\input{GeoUtils.tex}
\input{DragNDrop.tex}
%\input{VirtKeys.tex}
%\input{XmStrings.tex}
%\input{Caches.tex}
%
%\appendix
%\input{Appendix.tex}
%
\backmatter
\cleardoublepage
\printindex 
\end{document} % That's it, folks!
% End of LessTifh.tex
