<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--
* $Rev$
* $Date$
*
* ***** BEGIN LICENSE BLOCK *****
*
* Version: MPL 1.1
*
* The contents of this file are subject to the Mozilla Public License Version
* 1.1 (the "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
* the specific language governing rights and limitations under the License.
*
* The Original Code is snippet_kinds.htm
*
* The Initial Developer of the Original Code is Peter Johnson
* (http://www.delphidabbler.com/).
*
* Portions created by the Initial Developer are Copyright (C) 2009-2012 Peter
* Johnson. All Rights Reserved.
*
* ***** END LICENSE BLOCK *****
-->
<html>
<head>
<meta http-equiv="Content-Type" content="text-html; charset=Windows-1252">
<title>
Snippet Kinds
</title>
<link rel="stylesheet" href="../css/codesnip.css" type="text/css">
</head>
<body>
<object
type="application/x-oleobject"
classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e"
>
<param name="ALink Name" value="SnippetKinds">
</object>
<h1>
<a name="snippet_kinds"></a>Snippet Kinds
</h1>
<p>
<em>CodeSnip</em> is more than just a simple repository for your code
snippets, it can do some other things like create compilable units and
test-compile your code that mean it needs to know something about your
code. For that reason each snippet must be identified as one of six
kinds, and there are rules governing the layout of the source code for
each kind. The four kinds are:
</p>
<ol>
<li>
A <em>routine</em><br>
This is simple function or procedure, not a method.<br>
<a href="snippet_routine.htm">Learn more</a>.
</li>
<li>
A <em>simple type</em> definition<br>
This is a basic type definition, not a class, object or advanced record.
<br>
<a href="snippet_type.htm">Learn more</a>.
</li>
<li>
A <em>constant</em> definition<br>
This is what it says – a definition of one or more constants or
typed constants.<br>
<a href="snippet_constant.htm">Learn more</a>.
</li>
<li>
A <em>class / advanced record</em> definition<br>
This is either a class or an advanced record (with methods). This type
of snippet has separate declaration and definition sections.<br>
<a href="snippet_class.htm">Learn more</a>.
</li>
<li>
A <em>unit</em><br>
This comprises a complete source code unit. A unit is test compiled on
its own and, for obvious reasons can't be inserted into generated units.
<br>
<a href="snippet_unit.htm">Learn more</a>.
</li>
<li>
<em>Freeform code</em><br>
A catch all for any snippet that is not one of the above types. Can
contain anything. Freeform code can't be included in a
generated unit and nether can it be test complied.<br>
<a href="snippet_freeform.htm">Learn more</a>.
</li>
</ol>
<p>
If you want to be able use all of <em>CodeSnip</em>'s functionality you
must designate each of your snippets as one of the the first five kinds.
Use the "learn more" links to find out what you need to do to
comply with the requirements. Another way to learn is to examine the code
from the main database, since it all conforms.
</p>
<p>
On the other hand if you only want to use <em>CodeSnip</em> as a
repository for your code snippets, and don't want test compiling, just
designate everything as freeform. Or mix and match.
</p>
</body>
</html>
