This page is obosolete, please go to
https://twiki.cern.ch/twiki/bin/view/LHCb/CreateNewPackage

How to make a new package

( Document last updated 2nd December 2008 by Marco Cattaneo )

Important Note: from January 31st 2009, the CVSROOT variable is not part of the default LHCb environment any more. It has therefore to be added to commands which are not using the local CVS/Root file. This is the case for example for "cvs import" or  plain "cvs checkout". Namely one should read

> cvs -d :ext:isscvs.cern.ch:/local/reps/lhcb import ...

instead of

> cvs import ...

Anyway for regular checkout of existing directories, the getpack utility is doing the right job without any extra options.

Assume that you want to write a components package called MyComponents for subsystem Phys

• Create the package root directory

> cd $HOME/cmtuser
> mkdir -p Phys/MyComponents
> cd  Phys/MyComponents

• Create the package directory structure. For a components package, just cmt, doc, src are needed (no public includes)

> mkdir cmt
> mkdir doc
> mkdir src

• edit requirements (or copy them from a similar package...) and configure the package

> cd doc
> emacs release.notes
   -- edit the release notes --
> cd ../cmt
> emacs requirements
  -- edit the requirements file--
 > cmt config

• write some code and build a library

> cd ../src
  -- add *.cpp files
> cd ../cmt
> cmt make            ===> component library is built

• import the new package to cvs

> cd $HOME/cmtuser/Phys/MyComponents
-- Remove first all files you do not wish to import: binary directories, backup copies (*~), generated files in cmt directory (only requirements is needed)
> rm -r slc*
> rm */*~
> rm cmt/*.*
> rm cmt/*Make*
-- And now import to CVS
> cvs -d :ext:isscvs.cern.ch:/local/reps/lhcb import -m " first import of MyComponents under Phys" Phys/MyComponents myid v0r0
   myid is a "vendor-tag" in the CVS terminology.  I use my logon id

Please make sure that the import command is run from inside the directory you want to import ("cd $HOME/cmtuser/Phys/MyComponents")

• add your new package in the list of CVS modules

• getpack your new package from cvs   first move the original package under another version #

> cd $MYCOMPONENTSROOT
> cd ..
> mv MyComponents MyComponents.keep
> cd $HOME/cmtuser
> getpack Phys/MyComponents v1r0 head
> cd Phys/MyComponents/cmt
> cmt show uses
> cmt make

• if everything looks fine you can remove the original version

> cd ../..
> ls
   MyComponents MyComponents.keep
> rm -r MyComponents.keep