Index: /trunk/MagicSoft/CvsDoku/welcome.html
===================================================================
--- /trunk/MagicSoft/CvsDoku/welcome.html	(revision 285)
+++ /trunk/MagicSoft/CvsDoku/welcome.html	(revision 285)
@@ -0,0 +1,278 @@
+<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
+<html>
+<head>
+   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+   <meta name="GENERATOR" content="Mozilla/4.51 [en] (X11; I; Linux 2.2.5 i586) [Netscape]">
+   <title> CVS for Magic Software Development </title>
+</head>
+<body>
+<! This is my first attempt at my personal WWW home page.        ><! It has become necessary to create this mainly because my      ><! hotlist has grown into something so extremely large that it   ><! is impossible to find a way through it any longer...          >
+<center>
+<h1>
+CVS for Magic Software Development</h1></center>
+
+<hr>
+<h3>
+<font color="#FF0000"><font size=+2>Introduction</font></font></h3>
+More than one software developer are involved in the progress of Software
+for the MAGIC telescope. Because the developers are distributed all over
+Europe, a version control system is needed. There exists more than one
+possibility of such version control systems, but for the beginning we take
+CVS ( Concurrent Versions System ).
+<p>CVS is a version control system, which allows you to keep old versions
+of files (usually source code), keep a log of who, when, and why changes
+occurred, etc., like RCS or SCCS. Unlike the simpler systems, CVS does
+not just operate on one file at a time or one directory at a time, but
+operates on hierarchical collections of directories consisting of version
+controlled files. CVS helps to manage releases and to control the concurrent
+editing of source files among multiple authors. CVS allows triggers to
+enable/log/control various operations and works well over a wide area network.
+<p>CVS keeps a single copy of the master sources. This copy is called the
+source ``repository''; it contains all the information to permit extracting
+previous software releases at any time based on either a symbolic revision
+tag, or a date in the past.
+<p>For CVS updates, more information on documentation,&nbsp; software related
+to CVS, development of CVS, and more, see:
+<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="http://www.cyclic.com">http://www.cyclic.com</a>
+<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+<a href="http://www.loria.fr/~molli/cvs-index.html">http://www.loria.fr/~molli/cvs-index.html</a>
+<br>&nbsp;
+<p>
+<hr WIDTH="100%">
+<br><font color="#FF0000"><font size=+2>Repository</font></font>
+<p>The single copy of the master source for all MAGIC software is held
+in the repository on the alpha cluster in Max-Planck-Institut f&uuml;r
+Physik in Munich. As a developer you must declare the
+<br>environment variable
+<p>setenv&nbsp;&nbsp; CVSROOT&nbsp; /hd60/CvsRepository/&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+for tcsh (use the syntax of your shell)
+<br>&nbsp;
+<p>All the Software is inside the directory. The structure of the sub directories
+is following one:
+<br>&nbsp;
+<br>&nbsp;
+<table BORDER=0 CELLPADDING=10 COLS=7 WIDTH="100%" NOSAVE >
+<tr>
+<td><font size=+3><a href="#Anchor_MagicSoft">MagicSoft</a></font></td>
+
+<td><font size=+3><a href="#Anchor_CvsDoku">CvsDoku</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td><font size=+3><a href="#Anchor_Simulation">Simulation</a></font></td>
+
+<td><font size=+3><a href="#Anchor_Corsika">Corsika</a></font></td>
+
+<td><font size=+3>mmcs</font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td></td>
+
+<td><font size=+3><a href="#Anchor_Detector">Detector</a></font></td>
+
+<td><font size=+3><a href="#Anchor_Reflector">Reflector</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td><font size=+3><a href="#Anchor_include-GENERAL">include-GENERAL</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td><font size=+3><a href="#Anchor_include-CORSIKA">include-CORSIKA</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td><font size=+3><a href="#Anchor_include-MC">include-MC</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td><font size=+3><a href="#Anchor_include-Classes">include-Classes</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td><font size=+3><a href="#Anchor_Analysis">Analysis</a></font></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+
+<tr>
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+
+<td></td>
+</tr>
+</table>
+
+<hr WIDTH="100%">
+<br>&nbsp;
+<h3>
+<font color="#FF0000"><font size=+2>Detail of subdirectories in the repository</font></font></h3>
+
+<p><br><a NAME="Anchor_MagicSoft"></a><font color="#CC33CC"><font size=+2>MagicSoft</font></font>
+<p>In this directory of the cvs-repository you find all software that is
+developed for MAGIC using CVS.
+<br>This directory contain four sub directories, CvsDoku, Simulation, Analysis
+and include-Classes.
+<br>&nbsp;
+<blockquote><a NAME="Anchor_CvsDoku"></a><font color="#CC33CC"><font size=+2>CvsDoku</font></font>
+<p>In this directory of the cvs-repository you find some html pages like
+the one you are looking at the moment. This documentation is written as
+a guideline for MAGIC developers using the CVS tool. Also the documentation
+for CVS usage is using CVS!!
+<p><a NAME="Anchor_Simulation"></a><font color="#CC66CC"><font size=+2>Simulation</font></font>
+<br>For MAGIC a lot of programs were developed to simulate the behavior
+of Air Showers, the Mirrors and the Camera. All this things you need for
+simulation is inside this directory.
+<br>&nbsp;
+<blockquote><a NAME="Anchor_Corsika"></a><font color="#CC33CC"><font size=+2>Corsika</font></font>
+<br>All things needed for the simulation of AirShowers. All this simulation
+are based on the CORSIKA program of the KASCADE group in Karlsruhe.
+<br>&nbsp;
+<p><a NAME="Anchor_Detector"></a><font color="#CC33CC"><font size=+2>Detector</font></font>
+<br>&nbsp;Every thing that is needed to transfer the simulated events to
+the common raw data forrmat. There are a lot of different tools inside
+this directory, mainly based on the work of Jose Carlos Gonzales.
+<br>&nbsp;
+<blockquote><a NAME="Anchor_Reflector"></a><font color="#CC33CC"><font size=+2>Reflector</font></font>
+<br>&nbsp;Here you find the source code of the reflector program. This
+is written to read the CORSIKA (mmcs) output. With this data you can simulate
+the behaviour of the MAGIC mirrors. But to compile and run the program
+some other subdirectories are needed.
+<p><a NAME="Anchor_include-CORSIKA"></a><font color="#CC33CC"><font size=+2>include-CORSIKA</font></font>
+<br>Here you can find a implementation to read the CORSIKA output. This
+classes are needed by the reflector program.
+<p><a NAME="Anchor_include-MC"></a><font color="#CC33CC"><font size=+2>include-MC</font></font>
+<br>Here you can find a implementation to write and read the output of
+the reflector program. This classes are needed by the reflector and the
+camera program.
+<p><a NAME="Anchor_include-GENERAL"></a><font color="#CC33CC"><font size=+2>include-GENERAL</font></font>
+<br>Here you can find some header file that are needed by reflector and
+camera. For example the declaration of the runlib is found here.
+<br>&nbsp;</blockquote>
+</blockquote>
+<a NAME="Anchor_include-Classes"></a><font color="#CC66CC"><font size=+2>include-Classes</font></font>
+<p>In this directory you can find all Classes (C++ and hopefully OOP )
+that are used for simulation and for analysis. An example is the RawDataFormat
+used in the Analysis and the Camera programs.
+<p><a NAME="Anchor_Analysis"></a><font color="#CC66CC"><font size=+2>Analysis</font></font>
+<p>In this directory you can find all Programs to analyze data of MAGIC.
+Here you will find tools to look on single Events, to calculate the Hillas
+parameters and to find the periodicity of one special source. (But all
+this is still under construction!!!! Here the must development is needed
+in the future!!!)
+<br>&nbsp;</blockquote>
+
+<br>&nbsp;
+</body>
+</html>
