<?xml version="1.0"?>
<document>

  <properties>
    <author email="reinhard@spisser.it">Reinhard Spisser</author>
    <title>Gforge User Guide - Snippet Library</title>
  </properties>

  <body>

<section name="Snippet Library">
<p>
The Snippet Library function of gforge is very interesting; it allows to collect all the type of information/knowledge which is not a complete piece of code and which is usually difficult to organize/share.
<br/>
A tipical example are sophicistated shell commands, javascript functions, perl one-liner, SQL expressions that perform special queries, an algorithm, etc.

 
</p>
</section>
<section name="Inserting a new snippet">
<p>
You can insert a new Snippet by clicking on the "Submit a New Snippet" link.
<br/>
A form appears, where the following information can be inserted:

<ol>
<li><b>Title</b><br/>
Insert the title of the snippet. This will be displayed in the list of the snippets.
</li>
<li><b>Description</b><br/>
Inser the description of the snippet. 
</li>
<li><b>Type</b><br/>
Select the type of the snippet: function, full script, Howto, class, Readme
</li>
<li><b>License</b><br/>
</li>
<li><b>Language</b><br/>
Select the language of the snippet.
</li>
<li><b>Category</b><br/>
</li>
<li><b>Version</b><br/>
You should insert here the version of the snippet. For a new snippet, insert 1.0.
</li>
<li><b>Code</b><br/>
Paste here the code of the snippet.
</li>

</ol>


</p>
</section>
<section name="Browsing snippets">
<p>

You can browse snippets by clicking the "Browse" link.
<br/>
You can browse snippets by Language or by Category. The resulting table shows the list of all snippets of the Language/Category. You can click on the snippet number to view the detail of the snippet.

</p>
</section>
<section name="Modifying a snippet">
<p>
You cannot modify an existing snippet, but you can add a new version of the snippet by clicking on the Submit a new version link on the bottom part of the detail page of the snippet.

<br/>
Adding a new version does not delete the old version, all previous versions will be available.


</p>
</section>
</body>
</document>
