1% BEGIN LICENSE BLOCK 2% Version: CMPL 1.1 3% 4% The contents of this file are subject to the Cisco-style Mozilla Public 5% License Version 1.1 (the "License"); you may not use this file except 6% in compliance with the License. You may obtain a copy of the License 7% at www.eclipse-clp.org/license. 8% 9% Software distributed under the License is distributed on an "AS IS" 10% basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See 11% the License for the specific language governing rights and limitations 12% under the License. 13% 14% The Original Code is The ECLiPSe Constraint Logic Programming System. 15% The Initial Developer of the Original Code is Cisco Systems, Inc. 16% Portions created by the Initial Developer are 17% Copyright (C) 2006 Cisco Systems, Inc. All Rights Reserved. 18% 19% Contributor(s): 20% 21% END LICENSE BLOCK 22 23\chapter{Sample Chapter} 24 25\section{Guidelines} 26 27\begin{enumerate} 28\item Prefer task-oriented structure over feature-oriented one. 29 E.g.\ {\em Reading Data From A File} is better than 30 {\em The read/3 Built-In}. 31\item Make short paragraphs with meaningful headings. 32\item Don't use subsubsections. 33\item Provide frequent summaries. 34\item Go for 50\% examples or pictures. 35\item Use tables and overviews where possible. 36\item Refer to where more detailed documentation can be found. 37\end{enumerate} 38 39\section{Layout} 40 41\begin{itemize} 42\item 43 For summaries and overviews use 44 $\backslash$quickref$[$width$]$\{caption\}\{text\} 45 which puts the text in a grey box in a figure. 46\item For pieces of code use 47$\backslash$begin\{code\} 48text 49$\backslash$end\{code\} 50\item For sample queries and toplevel interaction etc use 51$\backslash$begin\{quote\}$\backslash$begin\{verbatim\} text 52$\backslash$end\{verbatim\}$\backslash$end\{quote\} 53\item For see-also references use $\backslash$See\{text\}. 54\item For notes that the reader can safely skip on first reading, 55use $\backslash$Note\{text\}. 56\end{itemize} 57\Note{For notes that the reader can safely skip on first reading, 58use the Note command.} 59\See{Use the See command to refer to where more details can be found.} 60 61Here is a sample query 62\begin{quote}\begin{verbatim} 63?- X is 3+4. 64X = 7 65Yes. 66\end{verbatim}\end{quote} 67 68Here is sample code 69\begin{code} 70append([], C, C). 71append([A|B], C, ABC) :- append(B, C, BC). 72\end{code} 73\quickref{A Summary}{ 74Every section should have a summary 75\begin{itemize} 76\item For summaries and overviews use the quickref command. 77\end{itemize} 78} 79 80\section{References} 81 82