HowTo add a new stand alone team
================================

$Id: AddNewTeam.txt,v 1.9 2005/09/22 10:17:24 frehe Exp $
Created 2000-09-16 by Fredrik Heintz
Last updated 2005-09-22 by Fredrik Heintz


The purpose of this HowTo is to describe how to
create a new stand alone team that can be used to
implement a RoboCup team using RoboSoc.
I will use NoAI as an example. All paths
are relative to the directory above RoboSoc.


Hint: Copy this file and then search and replace NoAI with
      the name of the team you want to create. Then you can copy
      the commands from this file without very many changes.


-1. Go to the RoboSoc directory.

0. Make sure that the template directory is updated.

   %> cvs update -d Framework/template/


1. Create a new directory outside the RoboSoc tree.

   %> cd ..
   %> mkdir NoAI


2. Copy the content of RoboSoc/Framework/template/Team to the new directory.

   %> cp -r RoboSoc/Framework/template/Team/* NoAI


3. Remove the CVS directories created by RoboSoc.

   %> cd NoAI
   %> \rm -r CVS
   %> cd src
   %> \rm -r CVS


4. Change the names of the files in the NoAI/src directory.

   %> mv Team-s NoAI-s
   %> mv Team.cc NoAI.cc
   %> mv TeamDecision.h NoAIDecision.h
   %> mv TeamDecision.cc NoAIDecision.cc


5. Change the names inside the files.

   %> emacs NoAI-s NoAIDecision.h NoAI.cc client.conf \
	Makefile.am NoAIDecision.cc 
      C-x b NoAI-s		(change buffers to NoAI-s)
      goto top of the file
      M-% Team NoAI		(search and replace)
      C-x b Makefile.am		(change buffers to Makefile.am)
      replace Team with NoAI as above
      C-x b client.conf		(change buffers to client.conf)
      replace Team with NoAI as above
      C-x b NoAI.cc		(change buffers to NoAI.cc)
      replace Team with NoAI as above
      goto top of the file
      C-s Created by		(search Created by)
      change the name and date
      C-s $Log			(search for $Log)
      remove everything between $Log ...$ and */
      C-x b NoAIDecision.cc	(change buffers to NoAIDecision.cc)
      replace Team with NoAI and description as above
      C-s CP_		        (search for CP_)
      change CP_NoAI to CP_team (this will only be found if you replaced
				 team with NoAI)
      C-x b NoAIDecision.h	(change buffers to NoAIDecision.h)
      replace Team with NoAI and description as above
      C-s @class		(search for @class)
      change the description of the class to include a description
      of the agent and the team its a part of.
      C-x C-f NoAI/configure.ac (open file)
      replace Team with NoAI as above
   

6. Update the AUTHORS, README, NEWS, and ChangeLog files.

   write the names of the authors in AUTHORS
   write instructions on how to use the team in README
   describe the differences between releases in NEWS
   describe all fixes to the team in ChangeLog

   To create a release of the team use 'make dist' it will
   create a file called TeamName.tar.gz that will can be used
   to install your team on another system.


7. Update the configuration of the new team.

   %> ./bootstrap (in NoAI)


8. Test the team

   %> ./configure (in NoAI)
   %> make


9. Do *not* add the team to the RoboSoc CVS. If you want to use a
   CVS to control the development of the team install a local
   CVS-repository. It is not hard, see the documentation of CVS.
   The support for CVS (using the $Keyword$) is already included.