Return to preface.tex CVS log

Up to [CCP4] / ccp4 / manual

More updates.

\chapter{Preface}

\begin{chapquote}
  $>$ \idx{Alice in Wonderland}: the best book on computer science for the
  layman.\\
  The best book on {\/\em anything} for the layman.\\
  --- Anon., Usenet book recommendations.\footnote{The quotations by
      or relating to Lewis Carroll\index{Carroll, Lewis} have some
      significance because
      Carroll (Dodgson) was born at Daresbury, administrative base of
      \ccp4.  Also the original editor was never previously far from
      either Looking Glass House or Dodgson's college.}
\end{chapquote}

This manual attempts to provide documentation of the
\ccp4 program package at a level above that of detailed input
requirements for individual programs.  Sadly over the years material
has become incomplete in places.  Suggestions for improvement are
welcome, particularly in the form of new passages for inclusion!

Although there is tutorial material included here, novices will need
background material e.g., from textbooks like
\cite{blundell/johnson,glusker/trueblood,luger,stout/jensen,drenth,%
giacovazzo-etal,perutz,rhodes} and sources such as \cite{int-tab-a}.

It is also worth noting that the HTML formatted documentation 
included with the \ccp4 suite itself contains much supplementary
material - see for example the documents under the \texttt{General}
section of the main program index.

Cross-references in the text of the form `\S$n$.$m$' refer to chapter
$n$, section $m$ etc.

\section*{Credits}

This document contains material from various sources.  It is mostly
based on the previous manual (which was mainly an installation guide)
and Wojtek Rypniewski's\index{Rypniewski, Wojtek} `overview' {\tt man}
`page'.  The previous manual was updated by Dave Love\index{Love,
  Dave} from a version containing contributions from Peter
Daly,\index{Daly, Peter} Kim Henrick\index{Henrick, Kim} and Wojtek
Wolf.\index{Wolf, Wojtek} Chapter \ref{sec:intro} contains material
originating from Phil Evans\index{Evans, Phil} and John
Campbell.\index{Campbell, John}  Chapter~\ref{sec:ir} was originally
based on material by
Silvia Onesti.\index{Onesti, Silvia}  Some of \S\ref{sec:solflat} was
taken from material by Andrew
Leslie\index{Leslie, Andrew} and Kevin Cowtan\index{Cowtan, Kevin}.
The description of the
MTZ file format was taken from Sandra Mc~Laughlin's\index{Mc Laughlin,
  Sandra} {\tt mtzlib} documentation and that for \texttt{maplib} from
John Campbell and Phil Evans'.  Several of the sections outlining
procedures and
program usage are taken from lecture notes by Eleanor
Dodson and often have accompanying example files (in the
\file{examples} directory) derived from that course.\index{Dodson, Eleanor}

Wojtek Rypniewski's acknowledgements for what he wrote include:
``I had asked various people for help and comments.  I would like to
thank Ian Tickle for reading very thoroughly the chapter on molecular
replacement and making several corrections.  Fred Antson did the same
for molecular averaging.  Sandra McLaughlin helped me write some
guidelines on programming standards.''

Dave Love edited, designed and typeset this document.
Subsequent updates from Martyn Winn and Peter Briggs.

Many people have contributed both to the software and
documentation---see the program
writeups---but Eleanor Dodson\index{Dodson, Eleanor} Phil
Evans\index{Evans, Phil} and Ian Tickle\index{Tickle, Ian} deserve
special mention.

% Local Variables: 
% mode: latex
% TeX-master: "manual"
% End: