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