2009-05-29  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* configure.ac: 
	  switched to version 2.4.1

	* regression-tests/nightly-check.pl: 
	  added -only XX option for running just the test with index XX
	
	* fastjet-config.in: 
	  ensured that --rpath=no removes the RPATH that is there with CGAL.

2009-05-29  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* fastjet-config.in:
	  fixed the returned compilation flags for
	  fastjet-config --cxxflags --libs
	

2009-05-28  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* configure.ac: 
	  if CGAL is explicitly requested and not found (or not functional),
	  return an error (and exit)

	* regression-tests/test-all-algs.pl (setRefResults): 
	  added checksums for PxCone

	* src/ClusterSequenceAreaBase.cc (get_median_rho_and_sigma),
	  include/fastjet/ClusterSequenceAreaBase.hh:
	  disregarded jets with 0 area in the computation of the median
	  rho and sigma. Added a warning wheh a 0-area jet is
	  encountered.
	

2009-05-28  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* example/fastjet_timing_plugins.cc: 
	* regression-tests/test-all-algs.pl: 
	  inexistent algs no longer crash, and real crashes are now reported
	  by test-all-algs as *** BAD (crash) ***
	
	* autogen.sh: 
	  ensured that recursion for creation of configure files is only
	  inside the plugin directory (e.g. no $srcdir/tmp-* directories)

	* regression-tests/nightly-check.pl: 
	  simplified output of fail messages;
	  now if update changes the nightly check, then it reruns itself;
	  it should now also output a summary message about what it has done

2009-05-28  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* configure.ac:
	  moved the test for Fortran at a more flexible and nice-looking place.

	* include/fastjet/ClusterSequenceActiveAreaExplicitGhosts.hh (ClusterSequenceAreaBase): 
	  commented out ghost_area()

	* fastjet-config.in:
	  --rpath set to the form --rpath[=yes|no] (yes by default).

	* configure.ac:
	  . enabled shared libs by defaut (following a long discussion
	    regarding static vs. shared libraries, we finally decided to
	    make a minimal modification compared to the previous release,
	    i.e. keep shared libraries on). 
	    By default, shared libs will be built and used and a -rpath
	    will be added. You can switch back to static libs by adding
	    --shared=no to fastjet-config. The rpath can be removed using
	    --rpath=no or turned into a runpath using --runpath (ELF
	    platforms only)
	  . set a CONFIG_CXXFLAGS variable that allows one to specify the
	    compilation arguments in fastjet-config independently of the
	    ones used to compile fastjet.
	
2009-05-27  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  added facility for running some of the tests on remote hosts,
	  and included a bunch of remote runs by default.  Also set up a
	  fairly long series of combinations that will be tested...

2009-05-26  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  made it possible to have several set of configure/link/nev
	  options within a single run (e.g. to test out-of-the box
	  running, as well as a configure with full set of algs).

	  Current tests include:
	  - out-of-the-box
          - all cxx plugins + CGAL
	  - shared enabled, static disabled, wtih --runpath
	
2009-05-26  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* fastjet-config.in:
	  fixed a typo with the runpath argument
	  allows use of --cxxflags and --libs at the same time

2009-05-26  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* configure.ac: 
	  following Gregory's suggestion, fixed a typo related to
  	  temporary CXXFLAGS (this solves a problem on testing some
	  algs, which seems to have been related to marginally different
 	  handling of floating point operations). 

2009-05-25  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* fastjet-config.in (Usage): 
	  added support for a --rpath and a --runpath option to
	  fastjet-config

	* configure.ac: 
	  . switched back to static libs by default
	  . check if the compiler/linker supports -Wl,-enable-new-dtags
	    i.e. add support for the runpath (on supported platforms)

2009-05-25  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/ClusterSequenceArea.hh: 
	* include/fastjet/ClusterSequenceActiveArea.hh: 
	* include/fastjet/ClusterSequenceActiveAreaExplicitGhosts.hh: 
	* src/ClusterSequenceActiveAreaExplicitGhosts.cc: 
	* src/ClusterSequenceActiveArea.cc: 

	  renamed area_spec -> ghost_spec, in a few places where they
	  won't affect users (but this helps readability)
	

	* fortran_wrapper/fastjetfortran.cc: 
	* fortran_wrapper/fastjet_fortran_example.f: 

	  changed interface so that we have generalised kt
	  (fastjetppgenkt_) as the main way of accessing the
	  seq.rec. algorithms.

2009-05-21  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/fastjet_timing_plugins.cc (print_jets_and_sub): 
	  expanded output on the -subdcut flag.

	* src/ClusterSequence.cc (ClusterSequence::exclusive_subdmerge_max): 
	  added some comments about output (zero) when nsub >= number of constituents
	
2009-05-20  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* fortran_wrapper/fastjetsiscone.cc: *** DELETED ***
	* fortran_wrapper/fastjetfortran.cc: *** ADDED ***
	* fortran_wrapper/fastjet_fortran_example.f: (was siscone_example.f)	
	
	  extended the wrappers to have some seq.rec. pp algorithms as well
	
2009-05-10  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* autogen.sh: 
	  fixed a sh script problem (replaced [[ "x"=="y" ]] w [ "x"="y" ])

	* src/Makefile.am, example/Makefile.am,
	  plugins/usage_examples/Makefile.am,
	  plugins/D0RunIICone/Makefile.am, plugins/SISCone/Makefile.am,
	  plugins/Jade/Makefile.am, plugins/CDFCones/CDFcode/Makefile.am,
	  plugins/CDFCones/Makefile.am, plugins/NestedDefs/Makefile.am,
	  plugins/CMSIterativeCone/Makefile.am,
	  plugins/TrackJet/Makefile.am, plugins/EECambridge/Makefile.am,
	  plugins/ATLASCone/Makefile.am, plugins/PxCone/Makefile.am,
	  include/fastjet/internal/Makefile.am:
	  replaced a bunch of ${VAR} by $(VAR)
	
	* configure.ac:
	  - specified the tar-ustar option for automake. This solves a
	    problem with filenames of length larger than 99 that were not
	    included in the distribution under Ubuntu.
	  - moved F77 to FC (and related) so that gfortran is
	    automatically detected if available.	
	  - added a bunch of comments regarding the recommendation to use
	    AC_CONFIG_MACRO_DIR([m4]) in the latest libtool
	    versions. Nothing is done (and justified!)
	
	
2009-05-10  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/ATLASCone/fastjet/ATLASConePlugin.hh: 
	* plugins/ATLASCone/ATLASConePlugin.cc: 
	  added R,seedPt,f to description + removed extraneous headers

	* plugins/TrackJet/fastjet/TrackJetPlugin.hh: 
	* plugins/TrackJet/TrackJetPlugin.cc: 
	  moved some headers out of .hh into .cc

	* plugins/CMSIterativeCone/fastjet/CMSIterativeConePlugin.hh: 
	* plugins/CMSIterativeCone/CMSIterativeConePlugin.cc
	  fixed description so that it includes the radius and seed
	  threshold + removed extraneous headers.

2009-05-08  Gavin Salam  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  added some comments for how this might evolve in future

2009-05-08  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

	* example/fastjet_example.cc:
	* example/fastjet_subjets.cc:
	* example/fastjet_timing.cc:
	* include/fastjet/ClusterSequenceActiveAreaExplicitGhosts.hh:
	* plugins/usage_examples/run_jet_finder.cc:
          added #include <cstdio> for compatibility with g++-4.4
          (pointed out by <peter.elmer@cern.ch>

2009-05-07  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  put back the svn update lines.

2009-05-01  Gavin Salam  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  removed the --enabled-shared option in the configure; 

	* moved siscone back over to the trunk...

2009-04-29  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* include/fastjet/ClusterSequenceActiveAreaExplicitGhosts.hh (ClusterSequenceAreaBase): 
	  added a ghost_area() method to get the info about the ghost area
	  used with this clusterSequence

2009-04-29  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* src/ClusterSequence.cc: 
	* src/ClusterSequence_N2.cc: 
	* include/fastjet/ClusterSequence.hh: 

	  replaced void ClusterSequence::_dummy_N2_cluster_instantiation()
	  (dummy instantiation of template to make it available elsewhere)
	  with _simple_N2_cluster_BriefJet() and
	  _simple_N2_cluster_EEBriefJet() (they are to be called and
	  should directly run the template).

	
2009-04-27  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* src/ClusterSequence.cc:
	  restored the warning about dangerous request for exclusive 
	  jets (removed earlier today) with a more reasonnable
	  list of algorithms for which no warnings are given.

	* include/fastjet/JetDefinition.hh: 
	* plugins/Jade/fastjet/JadePlugin.hh: 
	* plugins/EECambridge/fastjet/EECambridgePlugin.hh: 
	  added a 'exclusive_seqence_meaningful' member allowing to know
	  if a plugin gives meaningful exclusive jets (default=false). 
	  Set to true in Jade and EECambrigde.
	
	* configure.ac: 
	  include/fastjet/config_win.h:
	  DoxyFile:
	  switched version number to 2.4.1-devel

	* test-compare.sh:
	  discard lines with "WARNING" (occurs in non-predictable
	  positions due to flushing issues)

	* src/ClusterSequence.cc:
	  removed the WARNING previously given when extracting exclusive
	  jets for algorithms other than pp and e+e- kt

	
2009-04-16  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* plugins/SISCone/fastjet/SISConeBasePlugin.hh: 
	  Switched back to an implementation without templates
	  (we're now using virtual function overloading)

	* plugins/CMSIterativeCone/fastjet/CMSIterativeConePlugin.hh:
	  Added a plugin for the CMS iterative cone
	  (see plugins/CMSIterativeCone/README for details)
	  
2009-04-13  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh (dot_product): 
	  added dot_product binary operator...

2009-04-10  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* m4/CGAL.m4: 
	  updated comments to make it clearer what goes with 3.3.x v. 3.4.

2009-04-06  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* src/ClusterSequenceAreaBase.cc: 
	* include/fastjet/ClusterSequenceAreaBase.hh: 
	  changes to comments
	
	* doc/fastjet-doc.tex: 
	  sorted out a few details here and there about local ranges, and
	  added info on running with hard jets excluded.
       
	
	* include/fastjet/CircularRange.hh: 
	  added check that a center has been properly defined

2009-03-31  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/fastjet_timing_plugins.cc (main): 
	  move root printout in with main jet printout (so you can get
	  root even for exclusive jets)

2009-03-18  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* src/ClusterSequence.cc (ClusterSequence::add_constituents): 
	  When the jet is made of a single particle, add explicitly that
	  particled instead of the given 'jet'. This ensures that calling
	  add_constituents with a subtracted jet containing only one
	  particle will work.    

2009-03-11  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* m4/CGAL.m4
	  m4/compiler_flags.m4:             *** ADDED ***
	  check if the compiler supports -frounding-math
	  (for the moment, just discard it if it's not supported)
	

2009-03-11  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  switched over to using CGAL 3.4.

	* plugins/CDFCones/fastjet/CDFJetCluPlugin.hh: 
	  removed default overlap for jetclu...

	* set svn:keywords to be "Id" on a bunch of files where this was
	  missing 

2009-03-07  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* plugins/Jade:                      *** ADDED *** 
	  Added a plugin for the JADE algorithm

	  It is an e+e- sequential recombination algorithm with
	  interparticle distance
	      dij = 2 E_i E_j (1 - cos theta_ij)
	  or equivalently
	      yij = dij/E_{visible}^2
	
	  This corresponds to the distance measured used in
	    "Experimental Investigation of the Energy Dependence of the
	    Strong Coupling Strength."  JADE Collaboration (S. Bethke et
	    al.)  Phys.Lett.B213:235,1988
	
	  The JADE article carries out particle recombinations in the
	  E-scheme (4-vector recombination), which is the default
	  procedure for this plugin.
	
	  NOTE: other widely used schemes include E0, P, P0; however they
	        also involve modifications to the distance measure. Be
	        sure of what you're doing before running a JADE type
	        algorithm.
	
	  To access the jets with a given ycut value (clustering stops
	  once all yij > ycut), use
	      vector<PseudoJet> jets = cluster_sequence.exclusive_jets_ycut(ycut);
	  and related routines.
	

2009-03-02  Gavin Salam  <salam@lpthe.jussieu.fr>

	* regression-tests/test-all-algs.pl: 
	  fixed commented entry for d0runiicone with 10events

2009-03-02  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* configure.ac: 
	  Added options --enable-allplugins and --enable-allcxxplugins
	  Allow to enable all the (CXX) plugins at a go.
	
	  We do actually only change the set of default values, so
	  combinations like
            ./configure --enable-allplugins --disable-pxcone
	  will enable everything but PxCone
	
	  On top of that, --disable-all(cxx)plugins is automatically
	  defined by autoconf Therefore, we implement it so as it does
	  what it is supposed to do i.e. disable all the plugins. Again,
	  --disable-allplugins --enable-siscone will work and just enable
	  the SISCone plugin


2009-02-18  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* m4/CGAL.m4: put the resulting info on CGAL compilation
	  requirements into CGAL_xyz variables rather than the global
	  vars.


2009-02-18  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/NNH.hh: 
	  modified this so that one can now also use NNH<BJ,Info> where
	  Info is an information class. One then uses the constructor
	  
              NNH<BJ,Info>(const vector<PseudoJet> & particles, Info * info)
     
	  and the briefjets get initialised via the call
	
	      BJ->init(const PseudoJet & jet, Info * info)

	  if you want to make sure that info does get modified, use
	  NNH<BJ, const Info>. 

	  The original NNH<BJ> continues to work without the Info in the
	  constructors/initialisation calls.
	

2009-02-13  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* example/fastjet_timing_plugins.cc (main): 
	  added a -ycut comand-line argument

	* plugin/EECambridge: *** ADDED ***
	  Added a plugin for the e+e- Cambridge algorithm.
	  Default: enabled.
	  This plugin takes ycut as a parameter.

	* plugins/ATLASCone: *** ADDED ***
	  Added a plugin for the e+e- Cambridge algorithm.
	  Default: disabled.
	  This plugin takes as a parameter a cone radius, a seed
	    threshold (2.0 GeV by default) and an overlap
	    threshold (default:0.5). See the header file for a comment on
	    the default values.

	  This plugin is derived from the SpartyJet implementation of the
	  ATLAS cone algorithm.
	

2009-02-12  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* m4/CGAL.m4: added support for CGAL 3.4 (and cleaned)
	  A Makefile can still be provided using the
	  --with-cgalmakefile=...  option, so backward compatibility is
	  not broken. On top of that, a path to an installation of CGAL
	  can be specified using --with-cgal-directory=PATH in which case
	  the headers and lib will be searched in PATH/include and
	  PATH/lib respectively. Finally, if no argument (except
	  --eanble-cgal) are specified, CGAL is searched in standard
	  locations.
	
	* makefile.static: added support for CGAL 3.4
	  this is done in line with CGAL.m4 by allowing the specification
	  of a CGAL_DIRECTORY instead of the CGAL_MAKEFILE variable.
	  

2009-02-12  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/ClusterSequence.cc (ClusterSequence::_initialise_and_run): 
	  arranged for ee algos with an R value to behave sensibly when
	  R > pi (i.e. last pair of particles gets recombined into one).

	* example/fastjet_example_v1_interface.cc -> example/graveyard
	* example/Makefile.am: 
	  moved fastjet_example_v1_interface into the graveyard (no
	  longer 
	
	* example/fastjet_timing_plugins.cc: 
	  tried to improve documentation of various options and added
	  -excly; -ee-print for printing jets in terms of px,py,pz,E; 	
	  common output file for a range of jet output options.
	
	* include/fastjet/ClusterSequence.hh: 

	  added exclusive_ymerge, exclusive_ymerge_max,
	  n_exclusive_jets_ycut, exclusive_jets_ycut so as to provide more
	  helpful access to things in e+e- Jade and kt algorithms

	* moved  plugins/Jade/NNH.hh -> fastjet/include/NNH.hh
	  so as to make it available to other algorithms too
	
	* include/fastjet/ClusterSequence.hh: 
	* src/ClusterSequence.cc (ClusterSequence::_fill_initial_history): 
	  added Q() to return total energy in the event (relevant for e+e-)

	
2009-02-11  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/internal/ClusterSequence_N2.icc: *** ADDED ***
	* include/fastjet/ClusterSequence.hh
	* src/ClusterSequence_N2.cc
	* include/fastjet/internal/Makefile.am

	  reorganised things internally so that plugins should now have
	  access to the templated N2 implementation.
	
2009-02-10  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh (class PseudoJet): 
	  removed some consts following PAD's report of compilation
	  warnings un gcc 4.3 (with fastjet-2.3.4).

2009-01-26  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* Doxyfile: 
	  updated to avoid warnings with doxygen 1.5.7

2009-01-23  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* experimental/coding-guidelines.txt:   *** ADDED ***
	  following GS's suggestion...

2009-01-21  Matteo Cacciari <cacciari@lpthe.jussieu.fr>
        
        * include/fastjet/RangeDefinition.hh and CircularRange.hh
          Reinstated set_position(), added is_localizable() to base
          class (RangeDefinition) and derived one (CircularRange)


2009-01-16  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* for each plugin, put everything under the namespace 
	    fastjet::<plugin_name>
	  to avoid any conflict with other codes
	
	
	* plugins/TrackJet/fastjet/TrackJetPlugin.hh 
	  plugins/TrackJet/TrackJetPlugin.cc 
	  plugins/NestedDefs/fastjet/NestedDefsPlugin.hh
	  plugins/NestedDefs/NestedDefsPlugin.cc: 
          aligned with previous naming conventions (i.e. used _var for
	  private vars)
	

	* test-compare.sh:
	  extended the check down to pt=0 (instead of only jets with pt>5)

	
2009-01-16  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* example/fastjet_timing_plugins.cc: 
	  adapted this to use modern forms of constructors

	* include/fastjet/JetDefinition.hh: 
	* src/JetDefinition.cc: 
	  put in a constructor without R (for eekt) and a default
	  constructor, as well as a check that the jet algorithm has been
	  constructed with the right number of parameters.

	  *** BACKWARDS COMPATIBILITY BREAK ***
	      CALLING USUAL PP JET ALGS WITH NO R NOW
	      GIVES A RUN-TIME ERROR.
	
	* test-compare.sh: 
	  fixed problem with pxcone mixing f77/c++ output order according
	  to system, which caused problems in make check

	* plugins/D0RunIICone/D0RunIIConePlugin.cc: 
	  Attempt to sort out compilation problem on a mac


2009-01-15  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* include/fastjet/PseudoJet.hh (class PseudoJet): 
	  added Et() and Et2() to compute the transverse energy
	

2009-01-14  Gavin Salam  <salam@lpthe.jussieu.fr>

	* doc/fastjet-doc.tex (subsection{SISCone Plugin}): 
	* plugins/SISCone/SISConePlugin.cc (SISConePlugin::description): 
	* plugins/SISCone/SISConeSphericalPlugin.cc (SISConeSphericalPlugin::description): 
	* plugins/SISCone/fastjet/SISConeBasePlugin.hh: 

	  extras now contains a function int pass(jet), which returns the
	  pass of the jet; 

	  added function to set, query the use of the jet-definition's own
	  recombiner (which then overrides the presence of the pass in the
	  jets' user-index).

	  documented the whole lot.

	* example/fastjet_timing_plugins.cc: 
	  -cones also prints out passes of jets, user-index, etc.

2009-01-14  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* test-compare.sh: 
	  added options to specify additional params
	  added options to specify another event
	  added genkt, eekt and eegenkt
	  
	  added multiple values of R
	

	* configure.ac: 
	  even though they're enabled by default, AM_ENABLE_SHARED has to
	  be called so that ${enable_shared} is set to 'yes' instead of ''
	

	* test-compare.sh:
	  - dealt with a missing ${srcdir}
	  - cleaned a bit more the output
	

2009-01-13  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* configure.ac: 
	  switched shared libs to enabled by default 
	  note that the static libs are also built. 


2009-01-13  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* src/ClusterSequence.cc: 
	* src/ClusterSequenceVoronoiArea.cc: 
	* src/ClusterSequenceActiveArea.cc: 

	  made modifications to allow zero-particle events to work
	  fine. Tested various areas, as well as plain runs, including
	  plugins (or at least SISCone).
	
	* src/ClusterSequence_TiledN2.cc: 
	  added a lower limit on the tile size to avoid huge memory use
	  with tiny jet radii.

	* include/fastjet/RangeDefinition.hh: 
	  removed set_position and associated variables (will go back in
	  -> 2.5)

2009-01-13  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* test-compare.sh 
	  test-script-output-orig.txt: 
	  used now fastjet_timings_plugin rather than many_algs_examples
	  to test the output of each installed algorithm/plugin.

2009-01-12  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* src/ClusterSequence.cc (ClusterSequence::_initialise_and_run): 
	  changed the transition N for the anti-kt algorithm to
	  35000/R^1.15 (based only on R=0.7)
	

	* regression-tests/nightly-check.pl: 
	  added --enable-shared, to test that Gregory's new option works
	  fine (probably want a manual test anyway...)

2009-01-11  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* include/fastjet/RangeDefinition.hh (class RangeDefinition):  
	  - initialised _phispan in the default constructor
	  - bound the phi range to twopi in the computation of total_area

2009-01-09  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* include/fastjet/RangeDefinition.hh (class RangeDefinition): 
	  sorted out the issue of periodicity for generic phi ranges.
	

2009-01-09  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/test-all-algs.pl (setRefResults): 
	* doc/fastjet-doc.tex
	* src/ClusterSequence.cc: 

          switched R in eegenkt to be in radians, not
	  sqrt(2(1-\cos\theta))!! Updated docs and regression tests also,
	  and deposited test results in in usual place, 
	  ~salam/work/fastjet/validation-ref-2008-10-30
	
	* example/ktjet_timing.cc: 
	  added -get-all-dij option to print out the full list of dij
	
	* example/fastjet_timing_plugins.cc: 
	  added -get-all-dij option to print out the full list of dij
	  + fixed up up output on -excld (removed squared pt)
	  
	  Ran tests on 1k events 

	./fastjet_timing_plugins -nev 1000 -eekt -get-all-dij < ../../data/Pythia-PtMin1000-LHC-1000ev.dat | grep '^d for'
	./ktjet_timing           -nev 1000 -eekt -get-all-dij < ../../data/Pythia-PtMin1000-LHC-1000ev.dat | grep '^d for'

	  and it passed it fine (modulo some small rounding error issues
	  here and there.
	
	
2009-01-05  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* plugins/TrackJet/TrackJetPlugin.cc: 
	  released the TrackJet plugin.
	  Adapted many_algs_examples, fastjet_timing_plugins and
	  all build scripts accordingly
	

2008-12-18  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/test-all-algs.pl: 
	  added documentation on how to add a new algorithm.

	* regression-tests/nightly-check.pl: 
	  adding a little more info to output

2008-11-17  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/RangeDefinition.hh: 
	  added a check that phimax <= twopi in constructor

2008-10-31  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: 
	  finished a first version of this, with a fairly complete set of
	  checks.

2008-10-30  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/nightly-check.pl: *** ADDED ***

	  started work on this script for running a full swathe of regular
	  checks

	* regression-tests/test-all-algs.pl: *** ADDED ***
	  
	  script to help test correctness of fastjet, by running many algs
	  and, for each, comparing checksum of numerical part of results
	  to a previously stored checksum.

	* example/fastjet_timing_plugins.cc: 
	  various small changes to ease test-all-algs.pl behaviour

2008-10-30  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

        * include/fastjet/RangeDefinition.hh:
	  replaced methods place_at() and place() with set_position()

2008-10-29  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo 

	* include/fastjet/ClusterSequenceActiveAreaExplicitGhosts.hh: 
	* include/fastjet/ClusterSequenceAreaBase.hh: 
	* include/fastjet/ClusterSequenceArea.hh: 

	  added a virtual function has_explicit_ghosts(), which returns
	  true if the clusterSequence has explicit ghosts within the jets.

	* src/ClusterSequenceArea.cc: 
	  
	  if has_explicit_ghosts() is true, then don't bother with fancy
	  estimations of empty_area in
	  get_median_rho_and_sigma(...). Instead set it to zero, and
	  assume that the corresponding information is provided by the
	  pure ghost jets.

          NB: the empty_area(range) routine also returns zero if
	  has_explicit_ghosts(); the empty_area(jets, range) does not, on
	  the grounds that the user may have deliberately passed some
	  incomplete set of jets within the range.
	
2008-10-27  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

	* src/ClusterSequence.cc: 
	
	  updated banner link to www.fastjet.fr

2008-10-13  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

        * include/fastjet/RangeDefinition.hh
          Added method place_at(jet) and place_at(rap,phi), to be used by
          derived local ranges to place the range at a jet's position,
          after having defined the range only once with just its
          geometrical parameters. Moved _rapjet and _phijet from
          private to protected. Correspondingly modified CircularRange.hh
	
2008-10-09  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/fastjet_boosted_higgs.cc:     *** ADDED ***
	* example/data/HZ-event-Hmass115.dat:  *** ADDED ***
	* example/Makefile.am: 
	* example/data/Makefile.am: 

	  added an example to show how to carry out subjet decomposition
	  for finding boosted objects
	
	* example/Makefile.am: 
	* example/fastjet_subjets.cc: 
	  tidied this up a little & arranged for it to be compiled

2008-09-04  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* plugins/CDFCones/CDFJetCluPlugin.cc: 
	  in transfer part of plugin, sorted the constituents of a jet (into
 	  ascending fjindex), to work around the problem that JetClu may
	  return constiuents in different orders when soft ghost-particles
	  are added.

	  Note: JetClu seems to be IR unsafe (at the 10^{-4} level in toy
	  events) even when the seed threshold is non-zero. The frequence
	  is higher in real events and means that passive areas, and
	  active areas with repeat > 1, will throw fastjet::Error(...);
	  users should catch this if they want to continue running.

	  tested on 1k events against unmodified jetclu plugin in 2.3.4

-----------------------------------------------
released 2.3.4 on 2008-08-15
it contains jetclu & "exit" bug fixes from below + siscone 1.3.3
-----------------------------------------------	

2008-08-15  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/CDFCones/CDFJetCluPlugin.cc: 
	  switched over to the use of PhysicsTower::fjindex for
	  bookkeeping a jet's contents (rather than a map, which had led
	  to a bug report by James Monk).
	
	* plugins/CDFCones/CDFcode/PhysicsTower.hh (class PhysicsTower):
	  add fjindex member variable to this class to allow bookkeeping
	  needed by the JetClu plugin.


2008-08-11  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/GhostedAreaSpec.hh (class GhostedAreaSpec): 
	* src/GhostedAreaSpec.cc (GhostedAreaSpec::add_ghosts): 

	  added constructor and implementation for asymmetric ghost range
	  (different min & max rapidities), following request by Roman
	  Kogler <roman.kogler@desy.de> (H1 is asym in rap).

	* example/fastjet_timing_plugins.cc: 	

	  dense coverage switched over to using GhostedAreaSpec (will
	  change root pictures relative to earlier), used also for testing
	  the new asymmetric range of ghosts.

	
2008-08-06  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* example/fastjet_timing_plugins.cc (main): 
	  when appropriate, delete the plugin at the end of the execution.
	

2008-07-24  Matteo Cacciari <cacciari@lpthe.jussieu.fr>

        * src/ClusterSequenceAreaBase.cc
          Added copy of user_index over to subtracted jet
          in subtracted_jet() [previously fogotten]


2008-07-23  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* NEWS: 
	  updated the warnings about IR safety of the spherical
	  implementation of SISCone

	* example/Makefile.am,
	  plugins/usage_examples/Makefile.am: 
	  adapted the compilation flags to use the new version of the
	  plugin (requires inclusion of the SISCone headers)

	* plugins/SISCone/fastjet/SISConeBasePlugin.hh,
	  plugins/SISCone/fastjet/SISConePlugin.hh,
	  plugins/SISCone/fastjet/SISConeSphericalPlugin.hh,
	  plugins/SISCone/SISConePlugin.cc,
	  plugins/SISCone/SISConeSphericalPlugin.cc: 
	  Added a template plugin and made the two current plugins 
	  derive from it.
	

2008-07-18  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* configure.ac: 
	  removed the unnecessary -I../included flag from AM_CXXFLAGS
	

2008-07-18  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* example/CmdLine.cc: 
	* example/CmdLine.hh: 

	  put in a missing "const" & included cstdlib in the .cc (for
	  access to exit)
	
	
2008-07-17  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* include/fastjet/Makefile.am (nodist_fastjetinclude_HEADERS): 
	  config_auto.h removed from the package distribution as it 
	  may conflict with the configure-generated one when building
	  in a separate directory.
	

2008-07-16  Gavin Salam  <salam@lpthe.jussieu.fr>

	* mksnapshot.sh: 
          included fix for ensuring the windows include file is correct in
	  the snapshot.
	
2008-07-14  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/PseudoJet.cc: 
	* include/fastjet/PseudoJet.hh: 
          added sorted_by_pz() (used for safety tests on new algs)
	
2008-07-12  Gavin Salam  <salam@lpthe.jussieu.fr>

	* NEWS: 
	  added mention of spherical siscone

	* example/fastjet_timing_plugins.cc:
	  added -sisconespheri option for running spherical siscone; 
	  changed scale of "dense" additions to separate them better from
	  normal particles.

	* plugins/SISCone/fastjet/SISConeSphericalPlugin.hh: 
	  added comments about differences relative to the cylindrical
	  algorithm

	  NB: some other files have changed with minor typographical fixes

2008-07-11  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* include/fastjet/ClusterSequenceAreaBase.hh:
	  added a comment to notice that putting a negative
	  value for 'exclude_above' means the cut is discarded
	  (in parabolic_pt_per_unit_area).

	* configure.ac (ENABLE_PLUGIN_SISCONE)
          examples/Makefile.am
          plugins/usage_examples/Makefile.am:
	  added libsiscone_spherical to the list of libs to link 
	  against when using the SISCone plugin.

	
2008-07-11  Matteo Cacciari <cacciari@lpthe.jussieu.fr>

        * fixed CircularRange.hh (wrong filenme and missing fastjet 
          namespace)   


2008-07-07  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* plugins/SISCone/SISConeSphericalPlugin.cc: 
	  plugins/SISCone/fastjet/SISConeSphericalPlugin.hh: 
	  added a plugin for the spherical version of SISCone.
	  It is named SISConeSplericalPlugin and included in 
	  the same plugin library as the main plugin
	

2008-06-28  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* plugins/NestedAlgs/fastjet/NestedAlgsPlugin.hh
	  plugins/NestedAlgs/NestedAlgsPlugin.cc: 
	  - rename NestedAlgs in NestedDefs
	  - internally, call 'algorithms' 'definitions', for consistency
	  - do not put the last alg. recomb at the end but at the moment
	    they appear.
	  - keep the dij, diB for the last def; and set all others to
	    zero? That way people can run sub-jet tools on the last
	    jet-def without worrying about strange conflicts with the
	    previous dij's which have a different meaning.
      	  - do some renaming of the internal variables for readability


2008-06-22  Gavin Salam  <salam@lpthe.jussieu.fr>

	* doc/fastjet-doc.tex: 
	  updated the documentation to contain information about the e+e-
	  algorithms; added note on accessing version info; 

	* src/ClusterSequence.cc: 
	  removed warning about exclusive jets for the ee_kt alg. 

	  Added test of ee_kt R value. 

	  Arranged distance-measure normalisations such that dij has 1/R^2
	  for ee_gen_kt, but not for ee_kt (the former matches on directly
	  to gen_kt, the latter onto the usual e+e- convention).

	* include/fastjet/JetDefinition.hh: 
	* src/JetDefinition.cc (JetDefinition::JetDefinition): 

          moved the code for the constructor into the .cc file; 

	  For the ee_kt_algorithm, set the R value explicitly (R=4), to
	  avoid the user getting something that isn't the original kt
	  algorithm without realising. Also removed the mention of $R$ in
	  the description.

	  NB: functionality of R for this alg can be obtained with
	  ee_genkt. 


2008-06-19  Gavin Salam  <salam@lpthe.jussieu.fr>

	* TESTING:
	  ran basic tests on behaviour of eegenkt for a set of simple
	  events; checked that eegenkt with p=1 gives same as eekt (for
	  R=2); and rechecked once again against original KtJet. 

	* include/fastjet/JetDefinition.hh: 
	  removed inappropriate restriction on R for eegenkt.


2008-06-14  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/JetDefinition.hh (enum JetAlgorithm): 
	* src/JetDefinition.cc (JetDefinition::description): 
	* src/ClusterSequence.cc (ClusterSequence::_initialise_and_run, inclusive_jets): 
	* src/ClusterSequence_N2.cc (ClusterSequence::_bj_set_jetinfo<EEBriefJet>):

	  added support for the ee_genkt_algorithm [should double check
	  ee_kt (some mods may have affected it, though quick tests done)
	  and check genkt more extensively [e.g. with spherical plots?]

2008-06-02  Gregory Soyez  <gsoyez@quark.phy.bnl.gov>

	* plugins/NestedAlgs/NestedAlgsPlugin.cc: 
	  Added a new plugin which does the clustering by applying
	  successively a set of algorithms.
	  The usage simply goes as follows
	    list<JetDefinition> jet_list;
	    // add here the list of algs you want (the first one
	    // you want to be applied goes first) to 'jet_list' 
	    JetDefinition jet_def = new NestedAlg(jet_list);
	    ClusterSequence(particle_list, jet_def);
	  As for the other plugins, NestedAlgs can be enabled or
	  disabled at configure-time using --enable-nestedalgs or
	  --disable-nestedalgs (enabled by default).
	
2008-05-28  Gavin Salam  <salam@lpthe.jussieu.fr>


	* plugins/D0RunIICone/fastjet/D0RunIIConePlugin.hh: 

	  Following discussions with Christophe Royon and Lars
	  Sonnenschein, removed the default value for the min_jet_Et in the
	  D0RunIIConePlugin, since two different values have been used
	  over the years.

	* test-script-output-orig.txt: 
	* example/fastjet_timing_plugins.cc: 
	* plugins/usage_examples/many_algs_example.cc: 
	  updated these to use min_jet_Et to 6 GeV (was 8) for the
	  d0runiicone 
	
2008-05-23  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/PseudoJet.cc: 
	* include/fastjet/PseudoJet.hh: 

	  Added a delta_phi_to(...) member function to calculte phi
	  distance to another PseudoJet
	
2008-05-21  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/ClusterSequence.hh: 
	* src/ClusterSequence.cc: 

	  Rather than have an inline virtual destructor, moved it into
	  the .cc file (no particular reason)
	
2008-05-17  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/ClusterSequenceAreaBase.cc: 
	* include/fastjet/ClusterSequenceArea.hh: 
	* include/fastjet/ClusterSequenceAreaBase.hh: 

	  Added an extra version of get_median_rho_and_sigma which takes
	  an explicit list of jets and calculates the median from that ---
	  intended to help easily consider multiple R values within the
	  C/A algorithm. Also added empty_area_from_jets()

	  NB: "gmrs" also takes an extra argument to indicate
	  whether the supplied jets are inclusive or not (affects
	  assumptions it makes in calculating number of empty jets)

	  NB2: when playing these games, the estimate of the number of
	  empty jets is very hard to get in "plain" area classes for
	  non-inclusive jets. Currently it's done by estimating the
	  empty_area and dividing this by the mean_area of the non-empty
	  jets; however there are situations where this procedure becomes
	  dodgy (still to be understood why)...
	
	* TODO: 
	  updated this to reflect the current status of things

2008-05-16  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* NEWS: 
	  updated this to reflect main current changes

2008-05-14  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

        * include/fastjet/CircularRange.hh ADDED
          added derived class for circular range
	  
2008-05-12  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/root/jet-plots.C: 
	  - changed histograms to doubles so that ghosting gives visible results. 
          - JetHist::default_etamax and default_nbins can now be set
            by user

	  - showjets now plots labels on axes
	  - it reads a comment from the file and uses it as a label
	    if none is supplied
          - it returns a pointer to the canvas, for user's subsequent
	    manipulation
	
	* src/ClusterSequence.cc (ClusterSequence::print_jets_for_root): 
	* include/fastjet/ClusterSequence.hh: 

          added alternative interface for print_jets_for_root, which takes
	  filename and optional comment

	* include/fastjet/ClusterSequence.hh: 

          *** COULD BREAK COMPILED LIBRARIES?? ***

	  added virtual ~ClusterSequence () {} destructor; necessary in
	  order to get deletion of pointers to generic ClusterSequence type
	  objects working correctly (e.g. ClusterSequence *, that points to
	  a ClusterSequenceArea).

	  Leaving this out originally was related to the fact that we did
	  not originally forsee derived classes from ClusterSequence.
	
-----------------------------------------------
released 2.3.3 on 2008-04-28
it contains bug fixes from below
-----------------------------------------------	

2008-04-28  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/internal/SearchTree.hh: 
	  added a missing typename (pointed out by Belyaev).

	* include/fastjet/Makefile.am (fastjetinclude_HEADERS): 
	  added config_auto.h which was not being installed.

2008-04-18  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* mksnapshot.sh: 
	  added this script for creating snapshots, numbered both with
	  date and revision number

2008-04-04  Gavin SALAM  <salam@lpthe.jussieu.fr> later

	****  TESTS CARRIED OUT ****

	  tested 1000 events from ../data/Pythia-PtMin1000-LHC-1000ev.dat
	  between fastjet_timing_plugins and ktjet_timing with dcut = 10
	  and dcut = 2000; both give identical results.

          Commands used were:
	    ./ktjet_timing -eekt -nev 1000 -excld 2000 < ../../data/Pythia-PtMin1000-LHC-1000ev.dat 
	    ./fastjet_timing_plugins -eekt -R 2.0 -nev 1000 -excld 2000 < ....

          NB: R > sqrt(2) is mandatory within the current interface
	
	* example/fastjet_timing_plugins.cc: 
	* example/ktjet_timing.cc: 
	  added e+e- kt run options to these programs

	* include/fastjet/ClusterSequence.hh: 
	* src/ClusterSequence_N2.cc: 
	* src/ClusterSequence.cc: 

          modifications so that the _simple_N2_cluster() routine becomes a
	  template, whose action depends on specific type of BriefJet with
	  which it is called.

	  Added the EEBriefJet type, together with minimal functions, so
	  as to get a form of the e+e- algorithm.

	* include/fastjet/PseudoJet.hh
	  added the modp2() member function which returns the squared
	  modulus of the 3-vector part of the PseudoJet

	* include/fastjet/JetDefinition.hh
	  added the ee_kt_algorithm;
	
2008-04-04  Gavin SALAM  <salam@lpthe.jussieu.fr> earlier

	* plugins/CDFCones/fastjet/CDFMidPointPlugin.hh: 
	* plugins/SISCone/fastjet/SISConePlugin.hh: 
	  removed the default value for the overlap_threshold (was 0.5 and
	  this caused physics problems in the past; 0.75 is recommended).

2008-04-03  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* NEWS: 
	  updated NEWS to reflect changes made on the 2.3.2-devel bug-fix
	  branch

-----------------------------------------------
released 2.3.2 on 2008-04-03
it contains a subset of what is listed below
-----------------------------------------------	

2008-04-03  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* BUGS:
	  updated this file to reflect current status

2008-04-01  Gregory SOYEZ  <soyez@tycho.lpthe.jussieu.fr>

	* src/Voronoi.{hh,cc}
	  BUGS: 
	  declared some variables as volatile.
	  Those were subject to "==" tests which lead to segmentation
	  faults when the registers did not have the same precision as a
	  regular double.

	  This closes the following bug:
	  . The Voronoi area evaluation (=Passive for the kt algorithm), is
	    known to crash on events in which the momenta lie on a exact grid in
	    rapidity,phi (i.e. a calorimeter). An unsatisfactory workaround is
	    to slightly displace input momenta away from the exact grid.
	    Work is in progress to address this issue.


	* src/ClusterSequenceVoronoiArea.cc (VAC::VoronoiAreaCalc): added bits of comments

2008-03-28  Gregory Soyez  <g.soyez@ulg.ac.be>

	* src/ClusterSequenceActiveArea.cc (ClusterSequenceActiveArea::_transfer_areas): 
	  fixed array-size issue when there are unclustered particles.

2008-03-26  Gregory Soyez  <g.soyez@ulg.ac.be>

	* configure.ac:
	  fix a bug with AM_CXXFLAGS being overwritten at some point

2008-03-23  Gavin Salam  <salam@lpthe.jussieu.fr>

	* configure.ac: 
	  fix CXXFLAGS in such a way as to allow the user to set their own
	  default. 

	* include/fastjet/ClusterSequenceArea.hh (class ClusterSequenceArea): 
          added some missing Doxygen comments to this class
	
2008-03-15  Gavin Salam  <salam@lpthe.jussieu.fr>

        * src/Voronoi.cc
        * plugins/SISCone/siscone
        * include/fastjet/ClusterSequence1GhostPassiveArea.hh
        * include/fastjet/ClusterSequencePassiveArea.hh
        * include/fastjet/ClusterSequenceActiveArea.hh
        * include/fastjet/internal/Voronoi.hh
	  got rid of using namespace std in the headers
	
2008-03-15  Gavin Salam  <salam@lpthe.jussieu.fr>

	* did svnmerge.py uninit on the D0ILConePlugin branch
	 
	* merged the D0ILConePlugin Branch, which provides the D0 Run II
	  Cone, the genkt algorithm, and a full set of subjet tools (still
	  to be tested in part?)

============== MERGE OF D0ILConePlugin Branch =====================
	
2008-01-12  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* example/fastjet_timing_plugins.cc: 
	  changed position of a #ifdef ENABLE_PLUGIN_SISCONE so that when 
	  we merge it doesn't logically conflict with a parallel change in
  	  the trunk).

2007-12-29  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/ClusterSequence.hh: 
	* src/ClusterSequence.cc: 
	  added a full set of subjet functions, in analogy with what's
	  available for normal exclusive jets. Not yet documented
	
2007-12-28  Gavin Salam  <salam@lpthe.jussieu.fr>

	* doc/fastjet-doc.tex
	  documented genkt and subjet work; 

	  NB: MORE FUNCTIONALITY (SPLIT TO N JETS, ETC.) NEEDED 
	  FOR THE SUBJET WORK.

	* include/fastjet/JetDefinition.hh: 
	* src/JetDefinition.cc: 
	* src/ClusterSequence.cc: 
	  Got genkt working.

	* example/fastjet_timing_plugins.cc:
	  added option (-subdcut) for carrying out subjet analysis on
	  every jet; various methods are programmed internally, and the
	  subjet analysis was checked by making sure that for each method,

	  ./fastjet_timing_plugins -nev 1000 -cam -subdcut 0.25 \
	       < ~/work/fastjet/data/Pythia-PtMin50-TeV-1000ev.dat
 
	  gave identical results (similarly also for kt). This validates
	  the ClustSequence::exclusive_subjets(...) routine.

	  Also added -doruniicone option.
	
	* plugins/D0RunIICone/fastjet/D0RunIIConePlugin.hh: 
	  added default values for min_jet_Et and split_ratio, such that
	  the algorithm can be called with just the cone radius and it
	  will correspond to what is used by D0.

	* example/fastjet_subjets.cc: 
	  added some explicit subjet analysis

	* src/ClusterSequence.cc: 
	  corrected a couple of bugs in exclusive_subjets

2007-12-21  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/ClusterSequence.cc: 
	* include/fastjet/ClusterSequence.hh: 
	  added the exclusive_subjets(jet,dcut) routine to find out 
	  about the subjets at scale (dcut) inside a given jet

          -----------------------------------------------------	
	* from revision 989 onwards, add subjet analysis
          -----------------------------------------------------	

2007-12-14  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/fastjet_timing_plugins.cc: 
	  fixed compilation bug when siscone is disabled

	* plugins/usage_examples/many_algs_example.cc: 
	* test-script-output-orig.txt: 
	* test-compare.sh
	  modified these so that D0 cone is tested as well + fixed bug
	  in check when siscone is disabled

	* [various]/Makefile.am
	* configure.ac
	  added compilation of D0 code & plugins
	
	* plugins/D0RunIICone/fastjet/D0RunIIConePlugin.hh:  *** ADDED ***
	* plugins/D0RunIICone/D0RunIIConePlugin.cc:  *** ADDED ***

	  added these both, modified the D0RunIICone to get easy access to
	  jet constituents, and tested that it gives correct answers on
	  sample event sent by Lars Sonnenschein.

	* plugins/D0RunIICone/ *** ADDED ***
	  - put in untarred version of D0RunIIcone/
	  - copied main pieces into top directory
	  - made modifications for compilation
	  - added index entry to HepEntity
	  
	
2007-12-14  Gavin Salam  <salam@lpthe.jussieu.fr>
          -----------------------------------------------------	
	* on branch (from revision 981) for adding D0 cone...
          -----------------------------------------------------	

============== END OF MERGE OF D0ILConePlugin Branch =====================
	
	
2008-03-15  Gavin Salam  <salam@lpthe.jussieu.fr>

	* initialised svnmerge.py on
	  svn+ssh://tycho/ada1/lpthe/salam/svn/fastjet/branches/fastjet-release-devel-D0ILConePlugin 

	
	  
2008-03-15  Gavin Salam  <salam@lpthe.jussieu.fr>

	* doc/fastjet-doc.tex (subsection[$k_t$ jet algorithm]): 
	  added refs separately to inclusive and exclusive when describing
	  jet-alg (subsequent to mails from Piergiulio Lenzi who was
	  having trouble understanding what was happening).
	
2008-03-07  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* configure.ac: 
	  switched version number over to 2.4-devel

-----------------------------------------------
released 2.3.1 on 2008-03-07
-----------------------------------------------	

2008-03-07  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* configure.ac
	* test-compare.sh
	* src/genconfig.sh
	* src/makefile.static
	* include/fastjet/config.h         *** ADDED ***
	* include/fastjet/config_win.h     *** ADDED ***

	  Moved to a structure of config_auto.h (with autotools and unix
	  static makefiles), and  config_win.h (under windows). 
	  The config.h file now detects the system and includes the
	  appropriate one

2008-02-28  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

        * src/ClusterSequenceAreaBase.cc:
          Revisited part of the change made on 2008-02-18: subtracted 
          jets with unphysical momentum now also get a valid index
          
2008-02-25  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* src/ClusterSequence.cc: 
	  in exclusive_dmerge(njets) and exclusive_dmerge_max(njets),
	  fixed assert(njets > 0)  to njets >= 0;
	  Bug reported by Piergiulio Lenzi <lenzip@fi.infn.it>.


2008-02-18  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

        * src/ClusterSequenceAreaBase.cc:
	  in subtracted_jet(), copied cluster_hist_index from original
	  jet to sub_jet, so that one can then directly analyse sub_jet 
	  (for instance in terms of its constituents). Feature request
          by Juan Rojo
                

2008-01-28  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/SISCone/fastjet/SISConePlugin.hh: 
	  added note about recommended value for overlap_threshold
	  different from the default.
	
	* Doxyfile: 
	  updated this to reflect new plugin header locations
	
	* CHECKLIST: 
	  added this to indicate what's needed for a release
	  

2008-01-17  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/genconfig.sh (configfile): 
	  can now take a first argument to generate a file of whatever
	  name user likes.

2008-01-15  Gregory Soyez  <g.soyez@ulg.ac.be>

	* plugins/PxCone/pxcone.h:
	  fix name conventions for VC compilation

	* plugins/CDFCones/CDFcode/LorentzVector.hh (M_PI): 
	* plugins/CDFCones/CDFcode/Centroid.hh (M_PI): 
	* plugins/CDFCones/CDFcode/CalTower.hh (M_PI): 
	  added a definition of M_PI in case not already defined (VC compilation)

	* include/fastjet/internal/SearchTree.hh: 
	  added 'typename' where required (VC compilation)

	* src/ClusterSequenceVoronoiArea.cc: 
	  - added the limis header (VC compilation)
	  - replaced M_PI by pi (defined in fastjet/internal/numconsts.hh)

	* src/ClusterSequenceActiveArea.cc:
	  - added the algorithm, cmath and valarray headers (VC compilation)
	  - fixed a type/operator confusion in
	    ClusterSequenceActiveArea::_postprocess_AA (VC compilation)

	* src/PseudoJet.cc: 
	* src/ClusterSequence_TiledN2.cc: 
	* src/ClusterSequenceAreaBase.cc: 
	* src/ClosestPair2D.cc:
	  added the algorithm header (VC compilation)
	

2008-01-15  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/CDFCones/CDFcode/MidPointAlgorithm.cc (MidPointAlgorithm::iterateCone): 
	  fixed speed issue with optimized compilation by making some
	  local variable volatile (Gregory's proposal). The problem was
	  that on 32 bit machines a 64 bit stored variable was being
	  compared to an 80 bit register -- making everything volatile
	  forces thing to go into memory and solves the problem.
	
2008-01-14  Gavin Salam  <salam@lpthe.jussieu.fr>

        * plugins/SISCone/siscone
	  switched this back over to the SISCone trunk, in preparation for
	  Belyaev's bug fixes.

2008-01-11  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* TODO: 
	  updated this a little

	* test-compare.sh: 
	  fixed typo that caused make check failure when siscone is disabled

	* example/fastjet_timing_plugins.cc: 
	  bug-fix in conditional compilation to get things to still work when
	  siscone is disabled.

	* configure.ac: 
	  switched over to 2.3.1-devel

2008-01-04  Gavin Salam  <salam@bison>

	* BUGS: 
	  added remark about pt=0 and ambiguities in clustering inputs on
	  a perfect y-phi grid + VC7.1 compilation.

-----------------------------------------------
released 2.3.0 on 2008-01-03
-----------------------------------------------	

2008-01-03  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* BUGS           *** ADDED ***
	* prepared things for the 2.3.0 release

2007-12-24  Gavin Salam  <salam@lpthe.jussieu.fr>

	* NEWS: 
	  added information summarising 2.1 -> 2.3

2007-12-18  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* Makefile.am: 
	  added Doxyfile to EXTRA_DIST


2007-12-11  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/root/jet-plots.C: 
	  minor fix to get it working with modern (5.16) version of root. 

2007-12-04  Gavin Salam  <salam@lpthe.jussieu.fr> + Gregory

	* include/fastjet/ClusterSequenceArea.hh: 
	* include/fastjet/ClusterSequenceAreaBase.hh: 
	  made 4-argument get_median_rho_and_sigma virtual, and added a
	  4-argument overridden version to ClusterSequenceArea; this was
	  necessary because when you redefine one version with a given
	  name, then you need to explicitly override all other versions
	  with the same name.

2007-12-04  Gavin Salam  <salam@lpthe.jussieu.fr>

	* configure.ac
	  moved version number over to 2.3-beta1-devel

	* NEWS
	  renamed 2.2-beta1 -> 2.3-beta0
	 
	* ClusterSequenceActiveArea.cc|hh
	  Commented out the parabolic_pt_per_unit_area function, since it
	  is provided by the AreaBase class. This should also avoid the
	  compilation warning about the base class function being hidden.

	* example/fastjet_areas.cc: 
	  added more explicit comments about some of the alternatives that
	  are currently commented out.

2007-12-03  Gavin Salam  <salam@lpthe.jussieu.fr> + Gregory

	* TAGGED the 2.3-beta0 release

2007-11-30  Gregory Soyez  <g.soyez@ulg.ac.be>

	* include/fastjet/Makefile.am: remove config.h from the list of
	  headers included in the distribution. It should be generated
	  from config.h.in at configure time. When included, it also seems
	  to cause trouble for make distcheck.

	* test-compare.sh: add write permissions to the temporary copy of
	  the original output (read-only by default for make
	  distcheck). Also, explicitely remove the files generated by make
	  ckeck in case it succeeds (also required for make distcheck to
	  work.)

2007-11-29  Matteo Cacciari <cacciari@lpthe.jussieu.fr>

        * src/ClusterSequenceAreaBase.cc 
	  very minor fix to subtracted_jets() (use of int in loop was
	  giving a warning, *this was useless, eliminated debugging comments)

        * src/ClusterSequence.cc 
          Updated the banner (PLB + anti-kt)

        * configure.ac 
          Version number moved to 2.3-beta0 (from 2.3-beta0-devel)
	  
	* INSTALL
	  - single line version for compiling and linking external program  
	  - replaced output example vith version 2.3-beta0 (only the banner
	    changes)
	    
	    
2007-11-26  Matteo Cacciari <cacciari@lpthe.jussieu.fr>

        * src/ClusterSequenceAreaBase.cc [+.hh] :
          * fixed comment of subtracted_jet()
          * added the methods subtracted_jets() which
            returns a vector of PseudoJet by acting on inclusive_jets()

        * added fortran wrapper to TODO list

        * typo-fixing in documentation

        * include/fastjet/JetDefinition.hh
          include/fastjet/ClusterSequence.hh [.cc]
	  Replaced JetFinder by JetAlgorithm, and (_)jet_finder
	  by (_)jet_algorithm, in keeping with Les Houches convention.
	  Also replaced accordingly _default_jet_finder and the jet_finder()
	  method.
	  Backward compatibility is assured at the user-level by a 
	  typedef and by doubling functions containing the word "jet_finder"
         
	  NB. THERE IS ONE EXCEPTION: _default_jet_finder and _jet_finder
	  were protected variables of ClusterSequence: the replacement
	  will break derived classes using them. They should be replaced
	  everywhere by "_default_jet_algorithm" and "_jet_algorithm"

        * src/ClusterSequenceAreaBase.cc
	  src/ClusterSequencePassiveArea.cc
	  src/JetDefinition.cc
	  replaced jet_finder() by jet_algorithm()

        * example/fastjet_subtraction.cc
	  median rho is now calculated using ...per_unit_area_4vector
	  when used in 4-vector subtraction along with area_4vector
	  
	* example/fastjet_subtraction.cc
	          fastjet_areas.cc
		  fastjet_example.cc
		  fastjet_timing.cc
		  fastjet_timing_plugin.cc
          replaced "finder" with "algorithm"
	  
	    
2007-11-22  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo

        Tidying up in anticipation of 2.3-beta0 release; in addition to
	what's mentioned below, various bits of old commented code
	removed.
	
	* include/fastjet/JetDefinition.hh    
	  introduced jet_algorithm() (does same as jet_finder());
	
	* src/ClusterSequenceArea.cc:  *** ADDED *** +.hh
	* src/ClusterSequenceAreaBase.cc:  + .hh

	  set get_median_rho_and_sigma (and parabolic...) to be virtual,
	  overloaded it in ClusterSequenceArea so as to check that if
	  ghosts were used they're over a suitably large rapidity range.

	* src/ClusterSequenceAreaBase.cc: 
	  removed explicit code for median_pt_per_unit_something -- it now
	  just calls get_median_rho_and_sigma and returns the median;
	  tested that results are identical!

	* include/fastjet/RangeDefinition.hh: 
	  modified comment for _numerical_total_area; added
	  virtual get_rap_limits() to find out what rapidity limits the
	  range has. Mentioned it in the documentation too.
	
	* src/ClusterSequenceActiveArea.cc (_initialise_AA): 
	* [and elsewhere]
	  removed commented lines with old "maxrap" interface for setting
	  range when finding median etc.	
	
	* configure.ac: 
	  switched version number to 2.3-beta0

	* plugins/SISCone/
	  put siscone onto tagged version 1.3.0
	
2007-11-10  Gavin Salam  <salam@lpthe.jussieu.fr>

        Summary of places where tests carried out in past few days:
        
        name     |  system    | tarball v autoconf+automake | conf
        -------------------------------------------------------------
        ramses   | OSX 10.3   | t + a 2.61+1.10 (DIY)       | ??
        tycho    | FC 7       | a 2.61+1.10                 | cp
        bison(me)| Ubun 7.04  | a 2.61+1.9.6                | cps
        bison(me)| cygwin     | a ???                       | p?(s?)
        lxplus   | SLC4       | t + a 2.59+1.9.2            | ps
        zetes    | SLC4?      | t                           | ps
        lpnui    | SLC3       | t                           | ps
        
        The "conf" column indicates which of cgal, pxcone and shared were enabled,
        when I can remember... Lowest libtool: 1.5.6
	
	
	* plugins/PxCone/Makefile.am: 
	  added missing pxcone.h to EXTRA_DIST

	* test-compare.sh: 
	  fixed bug causing it to fail when build takes place in a
	  separate directory.

	* test-static.sh:  *** RENAMED FROM *** test-script.sh
	  modified it so that it uses test-compare.sh for carrying out the
	  tests.

	* src/makefile.static: 
	  adapted it so that it uses install-sh for the installation in
	  lib/ (works around issue with absent lib/ directory in the
	  distribution) 

	* Makefile.am: 
	  included test-script.sh in EXTRA_DIST
	
	* example/Makefile.am: 
	  removed test-*.sh from EXTRA_DIST (since the scripts have been removed)
	
	* plugins/usage_examples/Makefile.am: 
	  removed test-*.sh from EXTRA_DIST (since the scripts have been removed)
	  added -I../../include so as to get the
	  ../../include/fastjet/config.h when building in a separate directory.
	
2007-11-09  Gregory Soyez  <g.soyez@ulg.ac.be>

	* test-compare.sh:
	  test-script-output-orig.txt:
	  Allow to test the complete set of installed plugins.

	* plugins/usage_examples/many_algs_example.cc (main): 
	  append the anti-kt clustering algorithm

	* fastjet-config.in: sort out the -static issue
	  Now, shared lib is used by default if enabled. You can still
	  use the static one using the --shared=no flag
	

2007-11-09  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/FjPseudoJet.hh: 
	* include/FjClusterSequence.hh: 
	  added obscolescence warning

	* put version number over to 2.2-beta1-devel (-beta ensures it
	  comes alphabetically before 2.2.0)
	
2007-11-08  Gregory Soyez  <g.soyez@ulg.ac.be>

	* test-compare.sh: all tests will be launched from here
	  This allows to test examples before plugins examples

	* plugins/(PxCone|CDFCones|SISCone)/...Plugin.hh:
	  added a #warning to tell the user to switch to new version
	

2007-11-08  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* plugins/(PxCone|CDFCones|SISCone)/Makefile.am: 
	* plugins/(PxCone|CDFCones|SISCone)/...Plugin.hh: ***ADDED***
	  added 

	* example/root/Makefile.am: * example/Makefile.am: * configure.ac:
  	  put in some stuff missing from the
	  distribution (example/makefile.static, example/root/...)

2007-11-08  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* MERGED svn/fastjet/branches/fastjet-release-autoconf (Rev 938)
	  back into the trunk; assembled the Changelogs to be in date
	  order across the two groups of chages.

2007-11-08  gavin salam  <salam@lpthe.jussieu.fr>

	* configure.ac: 
	  removed EXEEXT for fastjet-config (relevant presumably only for
	  cygwin, where, as a script, it should not have the extension).

	* example/Makefile.alt: 
          removed explicit path to fastjet-config
	
2007-11-07  Gregory Soyez  <g.soyez@ulg.ac.be>

	* m4/CGAL.m4: move the local m4 macro defs in the m4 subdir
	* Makefile.am (ACLOCAL_AMFLAGS): add info on the local m4 macros
	* autogen.sh: search local aclocal m4 macros in the m4 subdir
	* INSTALL: add info regarding autoreconf
	

2007-11-07  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* autogen.sh: 
          removed lines replacing libtool->glibtool on MAC, since with
	  fresh compilation of recent autoconf, automake and libtool, it's
	  all working fine.
	
	* doc/Makefile.am *** ADDED ***
	  added doc/ to the tarfile

	* fortran_wrapper/siscone_example.f: 
	* fortran_wrapper/Makefile -> Makefile.alt
	* fortran_wrapper/Makefile.am
	* Makefile.am
	* configure.ac
          got the fortran wrapper example working
	
2007-11-07  Gavin SALAM  <salam@lpthe.jussieu.fr>
	* configure.ac: 
	* example/Makefile.am: 
	* plugins/usage_examples/Makefile.am: 

          when pxcone is enabled, the following macros get called
	    AC_PROG_F77
            AC_F77_LIBRARY_LDFLAGS
          they set up FLIBS, which is then used where relevant
	

2007-11-07  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh:
	  modified reset(...) a little so that we have:
	  - version with 4 args (px,...,E) and template (vectorial) version
          - version that takes a PseudoJet
	  The first ones reset the indices to default values; the latter
	  just copies the PseudoJet;

	  Also coordinated the resetting of indices.

2007-11-06  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh: 
	  added PseudoJet::reset(...) for modifying the 4-momentum.

2007-11-06  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* src/ClusterSequence.cc: 
	  promoted Gregory to full author status.

	* include/fastjet/version.hh: 
	* configure.ac: 
	* src/genconfig.sh: ***ADDED***

	  arranged things so that we generate include/fastjet/config.h
	  even with the makefile.static options, and we also use the
	  version number from config.h in fastjet output...

          + fixed some dependence  issues in other makefiles

	* example/fastjet_timing_plugins.cc: 
	* example/fastjet_areas.cc: 
        * plugins/usage_examples/cdfmidpoint_example.cc
        * plugins/usage_examples/siscone_example.cc
        * plugins/usage_examples/many_algs_example.cc
        * plugins/usage_examples/pxcone_example.cc

	  adapted them to get rid of PLUGINS_NOT_IN_FASTJET and use
	  instead config.h

	* example/Makefile.alt: 
	  documented a bit better

2007-11-05  Gregory Soyez  <g.soyez@ulg.ac.be>

	* fastjet-config.in: 
	  configure.ac:
	  Previous replacement of AM_LIBS by CONFIG_LIBS had
	  some influence on fastjet-config that was not properly
	  taken into account. This should be fixed now.

	* plugins/SISCone/fastjet
	  plugins/CDFCones/fastjet
	  plugins/PxCone/fastjet:
	  Those 3 directories now contain the header files for the
	  corresponding plugins

	* plugins/SISCone/fastjet/Makefile.am
	  plugins/CDFCones/fastjet/Makefile.am
	  plugins/PxCone/fastjet/Makefile.am:
	  Files added for autotools support

	* plugins/SISCone/SISConePlugin.cc
	  plugins/CDFCones/CDFJetCluPlugin.cc
	  plugins/CDFCones/CDFMidPointPlugin.cc
	  plugins/PxCone/PxConePlugin.cc
	  plugins/usage_examples/Makefile.am
	  plugins/usage_examples/siscone_example.cc
	  plugins/usage_examples/cdfmidpoint_example.cc
	  plugins/usage_examples/pxcone_example.cc
	  plugins/usage_examples/many_algs_example.cc
	  examples/Makefile.am
	  example/fastjet_timing_plugins.cc
	  example/fastjet_areas.cc:

	  update to match the new include path structure

	
2007-11-01  Gregory Soyez  <g.soyez@ulg.ac.be>

	* INSTALL: add a bit more details

	* CGAL.m4 (ACX_CHECK_CGAL):
	  fix the previous changes. CGAL check starts by looking
	  for a --with-cgalmakefile option. If this is absent it 
	  looks for a defined CGAL_MAKEFILE variable. Otherwise,
	  the default location is used.

2007-10-31  Gavin Salam  <salam@lpthe.jussieu.fr>

	* CGAL.m4 (ACX_CHECK_CGAL): 
	  hopefully fixed problem with it not finding the CGAL makefile  
	
	* autogen.sh: 
	  fixed minor incompatibility with plain sh (in Darwin "if")

2007-10-27  Gregory Soyez  <g.soyez@ulg.ac.be>

	* example/fastjet_timing_plugins.cc: 
	  plugins/usage_examples/many_algs_examples.cc: 
	  use config.h to get the info on the available plugins
	  For the static build (using makefile.static), we
	  explicitely define the SISCone and CDFCones flags.
	
	* example/test-areas.sh:                  *** ADDED ***
	  example/test-example.sh:                *** ADDED ***
	  test-compare.sh:                        *** ADDED ***
	  test-script-output-orig.txt
	  example/Makefile.am:
	  add tests accessible through "make check".
	  Note that the comparison results file has been reorganised
	  to follow the order in which tests are run now (the latter 
	  being a consequence of the build/Makefile order).

	* plugins/usage_examples/Makefile.am: 
	  build many_algs_example and the enabled plugins tests

	* example/Makefile.am:
	  - build different executables: 
	    fastjet_example fastjet_example_v1_interface
	    fastjet_areas fastjet_subtraction
            fastjet_timing fastjet_timing_plugin

	* autogen.sh: Add test to use glibtool(ize) under Darwin (Mac)
	

2007-10-24  Gregory Soyez  <g.soyez@ulg.ac.be>

	* series of small fixes to have a working make distcheck:
	  - correctly set the include dirs in case one builds into a
	    directory which is not the one containing the sources
	  - fix issues with the conditional build of plugins to make sure
	    that distribution-related make goals include all directories

	
2007-10-24  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/fastjet_areas.cc: 
	* example/fastjet_timing_plugins.cc: 
	  Arranged for these to work both with new compilations and old
	  (with ifdefs at beginning to decide where to search for
	  plugins), using the PLUGINS_NOT_IN_FASTJET define for the old case
	
	* makefile.static: 
	  added
	  CXXFLAGS += -DPLUGINS_NOT_IN_FASTJET
          to signal to example programs what is going on -- maybe sort
	  this out more elegantly later?

	* test-script.sh: 
	  arranged for it to use makefile.static (for now)
	
	* example/makefile.static
	  put this in (things had got lost)

	* example/Makefile.alt
	  this one should provide an example of how to get things to work
	  with the new build/install procedure
	  

2007-10-24  Gregory Soyez  <g.soyez@ulg.ac.be>

	* plugins/PxCone/Makefile.am        *** ADDED ***
	  plugins/Makefile.am
	  configure.ac:
	  Add autotools support for the PxCone plugin

	* configure.ac:
	  - add options to enable plugins:
	      --enable-siscone  (default=yes)
	      --enable-cdfcones (default=yes)
	      --enable-pxcone   (default=no)
	  - add recursion into the SISCone autotools build
	  - the --enable-shared cmd-line option is already handled by
	    libtool. We just need to add AM_DISABLE_SHARED to disable the
	    shared lib by default (can still be changed by using
	    --enable-shared)

	* fastjet-config.in: added a '--prefix' option which returns the
	  installation dir

	
2007-10-24  Gavin Salam  <salam@lpthe.jussieu.fr>

	* configure.ac: 
          included mention of the new Makefiles
	
	* Makefile.am, example/Makefile.am, example/data/Makefile.am
	  Added the latter two and hopefully the example should now be
	  included in the tarball (but testing seems to be awkard)
	
	* fastjet-config.in: 
	  fixed bug left in from previous mod

2007-10-23  Gregory Soyez  <g.soyez@ulg.ac.be>

	* Makefile.am: the script is installed ad bin_SCRIPT!!!!
	

2007-10-23  Gavin Salam  <salam@lpthe.jussieu.fr>

	* fastjet-config.in: 
	  removed -static ouput in case where things only built with
  	  static option (but not tested)

          changed some a+="b" to a=$a"b" for compatibility with mac
	
2007-10-22  Gavin SALAM  <salam@tycho.lpthe.jussieu.fr>

	* example/Makefile.alt *** ADDED ***
	  illustration of how to compile things with the new structure.

2007-10-20  salam  <salam@BISON>

	* INSTALL: 
	  started adding some instructions

	* configure.ac: 
	  sorted out order of libraries for siscone plugin in fastjet-config

2007-10-19  Gregory Soyez  <g.soyez@ulg.ac.be>

	* configure.ac: 
	  plugins/SISCone/Makefile_main_SISCone.am  *** ADDED ***

	  We add an additional Makefile.am to avoid the '/' in the SUBDIRS
	  in plugins/SISCone/Makefile.am which does not seem supported by
	  older vesions of automake

	  We also replace each occurence of VAR+="value" by
	  VAR=${VAR}"value" which is more portable and apparently
	  supported by older versions of autoconf
	

2007-10-19  Gavin Salam  <salam@lpthe.jussieu.fr>

	* configure.ac: 
	  changed version number by hand here to reflect what we have in
  	  the code (this needs to be dealt with properly at some point),
	  so that tarballs can't get confused with those already released.


2007-10-18  Gregory Soyez  <g.soyez@ulg.ac.be>

	* configure.ac: 
	  fastjet-config.in
	  include/Makefile.am                   *** ADDED ***
	  include/fastjet/Makefile.am        	*** ADDED ***
	  include/fastjet/internal/Makefile.am	*** ADDED ***
	  plugins/CDFCones/Mkefile.am		*** ADDED ***
	  plugins/CDFCones/CDFcode/Makefile.am  *** ADDED ***

	  A set of updates:
	   - added installation of fastjet headers
	   - added build of the CDFCones plugin
	   - and fixed issues with the SISCone plugin
	   - fixed bug in fastjet-config wrt plugins

	
2007-10-17  Gregory Soyez  <g.soyez@ulg.ac.be>

	* plugins/Makefile.am           *** ADDED ***
	  plugins/SISCone/Makefile.am   *** ADDED ***
	  These two files, together with modification of the main
	  configure.ac and Makefile.am allow for the SISCone plugin to be
	  installed
	
	* modify the main Makefile.am so the fastjet-config program is
	  installed
	
	* autogen.sh           *** ADDED ***
	  configure.ac	       *** ADDED ***
	  config.h.in	       *** ADDED ***
	  fastjet-config.in    *** ADDED ***
	  CGAL.m4 	       *** ADDED ***
	  Makefile.am 	       *** ADDED ***
	  src/Makefile.am      *** ADDED ***
	  This is the base files for an automake/autoconf-generated build
	  of fastjet. With those files, building of the main lib can be
	  done by issuing ./autogen.sh <configure-options>; make; make
	  install
	  There are configure options to configure the type of lib (shared
	  or static) and the CGAL support.
	
	* Change the external reference to the SISCone svn so that
	  it points to the development trunk. This allows to use
	  the makefile.static and autoconf things already implemented
	  there.

	* rename "ReleaseNotes' into "NEWS" and added "AUTHORS"
	  This is done to satisfy GNU standards

	* move all Makefile to makefile.static
	  In doing that, we have updated the makefile contents so
	  that the recursive behaviour is not broken
	
2007-10-17  Gregory Soyez  <g.soyez@ulg.ac.be>
	* BRANCHED (REVISION 889) -> svn/fastjet/branches/fastjet-release-autoconf
	  for autoconf related work
?
2007-10-16  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/CDFCones/CDFcode/MidPointAlgorithm.cc: 
	  added protection in midpoint code for cases when no stable cones are
	  found (e.g. because all particles are below seed threshold).

	
2007-09-30  Gavin Salam  <salam@lpthe.jussieu.fr>

	* AutoConfSpecs: *** ADDED ***
	  added this outline of what we might like from autoconf.

2007-08-24  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* bug-examples/:                           *** ADDED ***
	* bug-examples/voronoi-square-problem.*    *** ADDED ***
	  added this directory as a common place for putting code that
	  highlights bugs that need solving, together with a specific
	  example bug.
	
	* include/fastjet/PseudoJet.hh: 
	* src/PseudoJet.cc: 
	  added a PtYPhiM(...) function for creating a pseudojet
	  from pt, y, phi, m (alternative would be a constructor from some
	  new type that just held pt,y,phi,m?)
	
2007-08-01  Matteo & Gavin SALAM  <salam@lpthe.jussieu.fr>

	* fortran_wrapper/        *** ADDED ***
	  wrote a wrapper to show how to use parts of fastjet from
	  Fortran.	
	
2007-07-30  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* src/Makefile:
	  removed the pedantic option because CGAL 3.3 fails with it.

	* example/fastjet_timing_plugins.cc
	  added output of fastjet version
	  

2007-07-26  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/GhostedAreaSpec.hh: 
	  added GhostedAreaSpec::generator_at_own_risk() for access to the
	  internal generator object.

2007-07-18  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo


	* include/fastjet/ClusterSequence.hh|cc: 
	  added version of has_child which returns a pointer to the
	  child (more efficient) and also introduced object_in_jet

	  Corrected bugs in has_child and has_partner, related to the
	  treatment of cases near beam jets;

	  introduced a new protected member function
	  _potentially_valid(jet), for checking the use of a jet won't
	  lead to crash-causing nonsense (it may still lead to meaningless
	  answers).	
	
	  NB: now adding [RETHINK-IF-CHANGE-NUMBERING: ...] in
	  neighoburhood of things that may be affected if we ever decide
	  to give inclusive jets their own separate identify.	
	
2007-07-12  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/SISCone/SISConePlugin.cc: 
	  added output of SISCone version number within the plugin
	  description.

	* include/fastjet/JetDefinition.hh: 
	* src/ClusterSequence.cc: 
	  added fastjet_version_string() function which returns a string
	  along the lines of "FastJet version 2.2beta1-devel"
	
2007-06-28  Matteo Cacciari  <cacciari@lpthe.jussieu.fr>

        * added subtracted_jet and subtracted_pt methods
	  to ClusterSequenceAreaBase

2007-06-28  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/GhostedAreaSpec.hh: 
	  added deprecated access to intenal random number generator (for
	  internal development purposes) -- not guaranteed to stay.
	
	* include/fastjet/ClusterSequenceAreaBase.hh: 
	* include/fastjet/ClusterSequenceArea.hh: 
	  Added is_pure_ghost as a virtual function in the area base
	  class (implemented -- gives false by default) and added a proper
	  version to ClusterSequenceArea.

	* test-script.sh + test-script-output-orig.txt: 
	  sorted out some little hiccups in test script output

-----------------------------------------------
released 2.2beta0 on 2007-06-28
-----------------------------------------------	
	
2007-06-27  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/version.hh
	  updated version number to 2.2beta0

	* test-script-output-orig.txt
	  adapted this to current version

	* example/fastjet_subtraction.cc
	  sorted out some poor naming
	
2007-06-25  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* moved SISConePlugin/siscone over to 1.2.0 tag of siscone

2007-06-22  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* regression-tests/regression-test.pl:   *** ADDED ***
	  regression-tests*.res                  *** ADDED ***

	  added this directory for carrying out regressions tests and
	  output files, so as to (help) ensure that each new version of
	  fastjet is giving consistent results.

	* ChangeLog (this file!): 
	  moved contents of INTERNAL_CHANGELOG (deleted) into here.

	* include/fastjet/JetDefinition.hh: 
	  updated comments relating to optimal strategy for a given N

	* README: adapted this to reflect current situation with plugins
	  and anti-kt

2007-06-17  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/JetDefinition.hh: 
	  introduced typedef so that JetAlgorithm == JetFinder

	* src/PseudoJet.cc: 
	  added pseudorapidity() method.

	* plugins/CDFCones/CDFJetCluPlugin.hh: 
	  added control of ratcheting to quick constructor for
	  CDFJetCluPlugin. 

2007-06-16  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo

	* ClusterSequence--various-area-classes.cc|hh
	  adapted all the derived classes so that they take the
	  RangeDefinition rather than maxrap -- this is subsequent to
	  changes made below

        * plugins/Makefile 
          plugins/CDFCones/Makefile
          fixed error on Macs (case-insensitive file system)

2007-06-16  Matteo Cacciari <cacciari@lpthe.jussieu.fr>

        * RangeDefinition.hh
	  Added. Allows one to define the range in which to average
	  pt/area points in terms of rapmin,rapmax,phimin,phimax

        * ClusterSequenceAreaBase.cc|hh
          added parabolic_pt_per_unit_area, essentially copied from
	  ClusterSequenceActiveArea except for the raprange, which has
	  now no default and must be specified.

2007-06-14  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo

	* ClusterSequence.cc|hh: 
	  added has_parents(...), has_child(...) and has_partner(...)
	  methods for acccessing the branching structure.

2007-06-06  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* src/ClusterSequenceActiveAreaExplicitGhosts.cc: 
	  amplified warning message.
	
	* src/ClusterSequenceActiveArea.cc: 
	  added extra checking when matching different sequences (bounds,
	  making sure we match dij with dij and not dij with diB).

	* include/fastjet/JetDefinition.hh: 
	  added enum entry for the genkt_algorithm

2007-06-05  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* test-script-output-orig.txt
	  updated this so that it corresponds to current results (concerns
	  areas and banners)

2007-06-04  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/internal/LimitedWarning.hh: *** ADDED ***
	  added this for dealing with warnings that should appear a
	  limited number of times

	* src/ClusterSequenceActiveAreaExplicitGhosts.cc|hh: 
	  fixed bug (a missing "!") in determination of
	  has_dangerous_particles, and switched warnings over to the
	  LimitedWarning class.
	
	* src/ClusterSequenceAreaBase.cc: 
	  added warnings about jet alg used in median determination (if
	  not kt, cam)

2007-06-03  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/ClusterSequenceActiveArea.cc: 
	  made error for unmatched sequences more explicit and provided a
	  explanation of origin (based on has_dangerous_particles()
	  below), when the suspected cause is particles with low pt.

	  Also added (but did not test) has_dangerous_particles().
	
	* src/ClusterSequenceActiveAreaExplicitGhosts.cc|hh: 
	  added max_ghost_perp2() and has_dangerous_particles() member
	  functions, as well as an explicit warning (first few times) in
	  cases which are dangerous (particle pt2 < ghost pt);

2007-05-28  Gavin Salam  <salam@lpthe.jussieu.fr>

	* TODO: *** ADDED ***
	  it was about time we had this in here, even if it's not yet
  	  complete. 

2007-05-16  Gregory Soyez  <g.soyez@ulg.ac.be>

	* src/ClusterSequenceVoronoiArea.cc: 
	  Clearing parts of the code

2007-05-14  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/ClusterSequenceWithArea.hh: *** ADDED ***
	* include/fastjet/ClusterSequenceActiveArea.hh: 
	* include/fastjet/ClusterSequenceArea.hh: 

	  switched to naming and backwards compatibility options decided
	  on 2007-05-11.
	
2007-05-11  Gavin SALAM  <salam@lpthe.jussieu.fr> (later)

	* include/fastjet/ClusterSequenceWithArea.hh
          -> include/fastjet/ClusterSequenceArea.hh

	  + corresponding renaming in various places -- designed to ensure
	  we really can get full backwards compatibility.
	
2007-05-11  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* include/fastjet/ClusterSequenceActiveArea.hh: 
	* include/fastjet/ClusterSequenceWithArea.hh: 

	  partially fixed the problem of backwards compatibility with v2.1
	  by #defining ClusterSequenceWithArea as ClusterSequenceAreaBase,
	  UNLESS ClusterSequenceWithArea is explicitly included anywhere.

	
2007-05-10  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* include/fastjet/AreaDefinition.hh: (later)
	  changed the enum values and order for AreaType (to make them
	  more logical)

	* include/fastjet/ActiveAreaSpec.hh: *** ADDED ***
	  new version of this file, which just defines ActiveAreaSpec =
	  GhostedAreaSpec, for backwards compatibility

	* ActiveAreaSpec -> GhostedAreaSpec: 
	  changed the name to reflect use of this class for passive &
	  active; 
	
	* AreaDefinition.hh|cc
          moved AreaType enum out of class. Sorted out the descriptions.

	* ClusterSequenceActiveAreaExplicitGhosts.cc|hh: 
	  sorted out empty_area for this case too.

	* plugins/SISCone/SISConePlugin.hh: 
	  fixed missing component in a constructor
	
	
2007-05-09  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo [later]

	* JetDefinition.cc|hh: 
	* plugins/SISCone/SISConePlugin.hh|cc: 
	  added mechanism for supporting ghosted passive areas in plugins

	* include/fastjet/ClusterSequencePassiveArea.hh  *** ADDED ***
        * src/ClusterSequencePassiveArea.cc              *** ADDED ***

	  put in support for this passive area class that redirects one to
	  the supposedly optimal passive-area determination for each each
	  algorithm.	


	* include/fastjet/AreaDefinition.hh:
        * include/fastjet/ClusterSequence1GhostPassiveArea.hh:
        * include/fastjet/ClusterSequencePassiveArea.hh:
        * include/fastjet/ClusterSequenceActiveArea.hh:
        * include/fastjet/ClusterSequenceWithArea.hh:

          various changes related to the above, including selection of the
	  PassiveArea from the WithArea class.


2007-05-09  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo

        * ClusterSequencePassiveArea -> ClusterSequence1GhostPassiveArea
	
	* JetDefinition.cc|hh: 
	* ClusterSequence.cc|hh: 
	  introduced cambridge_for_passive_algorithm (for internal use
	  only), and moved the jet_scale_for_algorithm routine into the
	  .cc file.

2007-05-09  Gavin Salam  <salam@lpthe.jussieu.fr>

	* src/JetDefinition.cc: 

	* src/ClusterSequence.cc: 
	  updated banner to reflect current status

	* example/Makefile (depend): 
	* src/Makefile: 
	  removed CXXFLAGS from make depend (it caused it to get all CGAL
	  files).
	
	* many places:
	  set the svn:keywords property to "Id" on many files where it was
	  missing. Sorted out some copyright statements (e.g. Voronoi.cc
	  we should not be claiming copyright!)
	
2007-05-09  Gregory Soyez  <g.soyez@ulg.ac.be>

	* include/fastjet/ClusterSequenceWithArea.hh: 
	  redirect to the ClusterSequencePAssiveArea class when area type
	  is set to passive_area

	* include/fastjet/AreaDefinition.hh: 
	  - added passive_area to the list of allowed area types.
	  - added a new ctor specifying an ActiveAreaSpec together with
	    an AreaType. This allow definition of active,
	    active_with_explicit_ghosts and passive areas.
	

2007-05-08  Gavin SALAM  <salam@lpthe.jussieu.fr> & matteo

	* include/fastjet/ClusterSequencePassiveArea.hh: ***ADDED***
	* src/ClusterSequencePassiveArea.cc:             ***ADDED***

	  added a passive class that scans a single ghost over the event,
	  repeating the clustering once for each ghost position -- the
	  name may well evolve in the coming days.

	* ClusterSequenceActiveArea.hh|cc: 
	  changed some private/protected statuses to allow the PassiveArea
	  to access whatever it needs to access, and split some of the
	  functions into pieces so that they can be used piecemeal from
	  derived class.

2007-05-08  Gregory Soyez  <g.soyez@ulg.ac.be>

	* src/ClusterSequenceVoronoiArea.cc: 
	  Fix problem with particles at phi=0
	

2007-05-08  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* ActiveAreaSpec.hh|cc: 
	  added get_random_statu(), set_random_status(),
	  checkpoint_random(), restore_checkpoint_random(), to facilitate
	  the user's life when then need correlated random numbers for the
	  areas.

	* include/fastjet/internal/BasicRandom.hh: 
	  added set_status and get_status routines in the <int> and
	  <double> versions.
	
2007-05-08  Gavin, Matteo & Gregory

	* example/fastjet_areas.cc: 
	  adapted example to new form of ClusterSequenceWithAreas

	* include/fastjet/AreaDefinition.hh: 
	  added default constructor for VoronoiAreaSpec

	* ActiveAreaSpec.cc|hh
	  changed default grid_scatter (1e-4 -> 1.0) [gives better
	  systematics at large ghost areas, and runs faster on cone], and
	  redefined scatter (kt and y,phi) to be around central values
	  (rather than an asymmetric shift as before).

	* ClusterSequenceWithArea.hh
	  added constructors that take ActiveAreaSpec and VoronoiAreaSpec
	  directly. 
	
2007-05-07  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* ClusterSequenceVoronoiArea.hh|cc: 
	  added area_4vector to class, based on sum of cell centers rather
	  than the 4vector for each cell.

2007-05-07  Gregory Soyez  <g.soyez@ulg.ac.be>

	* include/fastjet/ClusterSequenceWithArea.hh|cc: Append Voronoi
	  area computation.

	* src/ClusterSequenceVoronoiArea.hh|cc: Add a class to compute the
	  Voronoi area.

	* src/Voronoi.hh|cc: Add O'Sullivan C++ adaptation of Fortune's
	  code to compute Voronoi diagrams.

2007-05-07  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo

	* ClusterSequence.hh|cc: 
	  added the transfer_from_sequence(...) member, which copies the
	  information from another sequence into this one.

	* include/fastjet/ClusterSequenceWithArea.hh:  *** ADDED ***
	  class to access a generic type of area, as specified through an
	  AreaDefinition.

	* AreaDefinition.hh|cc    *** ADDED ***
          start of work towards an area definition, to be used as an input
	  to the future ClusterSequenceWithArea.hh|cc

	* RENAMED  ClusterSequenceWithArea.hh|cc 
	        -> ClusterSequenceAreaBase.hh|cc  

	  carried out this renaming in view of reusing the original name
	  not as a base class, but rather as a class that provides easy
	  access to all different types of areas.

	  NB: numerous associated changes, for things to carry on
	  working...	
	
2007-05-06  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* ClusterSequenceWithArea.hh|cc: 
	  added get_median_rho_and_error(...) to allow one to extract
	  the median together with the size of fluctuations around the
	  median (and the mean error, of use in doing converting
	  fluctuations to errors on individual jets).
	
2007-05-05  Gavin Salam  <salam@lpthe.jussieu.fr>

	* areas/jet_def_from_cmdline.cc|hh: 

	  added this so as to provide easy (and common) access to a jet
	  finder from the command-line

2007-05-02  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo

	* include/fastjet/ClusterSequenceWithArea.hh|cc: 
	  added empty_area(...), n_empty_jets(...),
	  median_pt_per_unit_area(...),
	  median_pt_per_unit_area_4vector(...), and the one that does the
	  work, median_pt_per_unit_something, as virtual functions, so
	  that these facilities can be accessed with any of the area
	  classes.

	* include/fastjet/ClusterSequenceActiveArea.hh|cc: 
	  added versions of empty_area(...), n_empty_jets(...), that make
	  use of all the information that's available from the ghosts.	
	
	* include/fastjet/JetDefinition.hh: 
        * plugins/*/*Plugin.hh:
	  added the double R() const abstract virtual member function to
	  the JetDefinition::Plugin class, and updated all the plugins, so
	  that one can get a sensible value of R out of any algorithm.
	  
	
2007-04-24  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* plugins/SISCone/SISConePlugin.hh|cc: 
	  added the split_merge_on_transverse_mass in the constructor (+
	  other ways of accessing it), which interfaces with SISCone's
	  SM_var2_hardest_cut_off variable.
	
2007-04-19  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo

	* src/ClusterSequenceActiveArea.cc|hh: 
          moved the check on equivalence of ghosted jets into a common
	  member function for ij and iB recombination -- now they both use
	  pt == ptref || E == Eref. At some point this check should be
	  made more robust (move away from momentum and towards tags or
	  something similar).
	
2007-04-18  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo

	* include/fastjet/JetDefinition.hh: 
	* include/fastjet/ClusterSequence.hh: 
	* src/JetDefinition.cc: 
	* src/ClusterSequence.cc: 

          introduced the "antikt" algorithm.

	* example/fastjet_timing_plugins.cc
	  got it working with antikt
	
2007-04-13  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* example/root/jet-plots.C: *** ADDED ***
	  root script for plotting output from print_jets_for_root(...);
	  see instructions at beginning for usage.

	* include/fastjet/ClusterSequence.hh|cc: 
	  added print_jets_for_root, which takes jets and outputs them in
	  a form suitable for the root script...

	* example/fastjet_timing_plugins.cc: 
	  fixed a bug that prevented compilation and added some extra
	  cone-related options.
	
-----------------------------------------------
released 2.1.0 on 2007-04-02
-----------------------------------------------	
	
2007-04-02  Gavin SALAM  <salam@lpthe.jussieu.fr> + MC

	* plugins/usage_examples/many_algs_example.cc: 
	  removed PxCone by default (compile with -DUSEPXCONE get it back
	  and adapt Makefile too).
	
	* test-script.sh
	  corrected bug related to G77LIBDIR; removed fortran related
	  stuff (pxcone now out by default)

2007-03-16  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* example/data/cone-midpoint-problem-ev1.dat
	* example/data/cone-midpoint-problem-ev2.dat
	  added these to illustrate the IR problem with midpoint
	
2007-03-14  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/SISCone/SISConePlugin.hh: 
	  changed the default number of passes to 0

	* plugins/SISCone/SISConePlugin.cc: 
	  fixed bug in choice of split-merge scale when recomputing jets
	  from a cached siscone run.
	  

2007-03-12  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* src/PseudoJet.cc|hh: 
	  added boost(...) and unboost(...) methods.

	* example/data/cone-darktower.dat: 
	* example/data/cone-sm-pt-problem-ev(1|2).dat: 
	  added two simple example events to illustrate the split-merge problem
	  with pt ordering, as well as the dark-tower problem in
	  single-pass algs.
	
2007-03-10  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/ActiveAreaSpec.hh: 
	  changed default repeat value to 1 (was 5);

	* plugins/CDFCones/CDFcode/ClusterComparisons.hh: 
	* plugins/CDFCones/CDFcode/Cluster.hh: 
	* plugins/CDFCones/CDFcode/MidPointAlgorithm.cc|hh: 
	  added support for the pt_tilde scale in the split-merge
	  procedure; note that the way this is done adds a small (1-3%)
	  speed penalty for all choices.
	
	
	* plugins/CDFCones/CDFMidPointPlugin.cc|hh: 
	  added the corresponding pt_tilde entry to the SplitMergeScale
	  enum.

	* plugins/SISCone/SISConePlugin.hh: 
	  changed default split_merge_scale to SM_pttilde; in legacy
	  interface, bool split_merge_on_transverse_mass now decides
	  between SM_mt and SM_pttilde;

2007-03-09  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/SISCone/SISConePlugin.cc|hh: 
	  introduced the SISConePlugin::SplitMergeScale enum (like the one
	  for the CDF plugin) and implemented the interface between this
	  and siscone's corresponding enum (NB: they must be ordered the
	  same way, otherwise you will get surprises...).

2007-03-06  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo

	* include/fastjet/version.hh: 
	  updated internal version number (to avoid confusion)

	* include/fastjet/ActiveAreaSpec.hh|cc: 
	  added description() member function

	* moved siscone external back onto siscone trunk
	
2007-03-04  Gavin Salam  <salam@lpthe.jussieu.fr>

	* doc/fastjet-doc.tex: 
	  Wrote the SISCone section; moved the example program forward,
	  since it uses only features from section 2, not all the
	  subsequence stuff. Updated intro.
	  

	* plugins/SISCone/SISConePlugin.hh: 
	  added the stable_cones() method to SISConeExtras, which is
	  identical to protocones() (but stable_cones is a more consistent
	  name).

2007-03-03  Gavin Salam  <salam@lpthe.jussieu.fr>

	* switched the plugins/SISCone svn:externals property to point to 
	  svn+ssh://login.hepforge.org/hepforge/svn/siscone/tags/siscone-1.1.0
	  rather than 
	  svn+ssh://login.hepforge.org/hepforge/svn/siscone/trunk

2007-03-01 (later) Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh: 
	  added transverse mass functions.

	* plugins/SISCone/SISConePlugin.cc|hh: 
	  added a new member function
	  SISConeExtras::most_ambiguous_split(), which returns the degree
	  of ambiguity of the most ambiguous decision about attributing a
	  particle to one or other jet during a split step.  Useful for
	  testing purposes.

	* example/fastjet_timing_plugins.cc: 
	  started adding minimal access to cone information with the
	  "-cones" option.

2007-03-01  MC

        * doc/fastjet-doc.tex
          Updated the documentation to describe the new options
          of pt_per_unit_area and parabolic_pt_per_unit_area
          concerning the use of area_4vector

2007-03-01  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh: 
	  fixed bug in phi_std() pointed out by Oscar Stal,
	  <oscar.stal@tsl.uu.se> 

	* test-script-output-orig.txt
	  updated this so that it corresponds to current output.
	
	* include/fastjet/ClusterSequence.hh: 
	  added the ClusterSequence::Extras class, as well as
	  ClusterSequence::extras() function which returns a (possibly
	  null) pointer to any extras.
	
	* plugins/SISCone/SISConePlugin.hh|cc: 
	  updated them to reflect a change in naming in siscone;
	  added SISConeExtras class (derives from
	  ClusterSequence::Extras), whose contents are set up from within
	  the plugin and which allows a user to access the protocones.

	* ReleaseNotes: 
	  updated to reflect recent additions

2007-02-28  Gavin Salam  <salam@lpthe.jussieu.fr> + MC

	* src/ClusterSequenceActiveArea.cc: 
	  switched over to use of the current recombination scheme when
	  averaging 4vector areas over multiple repeats with different
	  ghosts. 
	
	* include/fastjet/JetDefinition.hh: 
	  added Recombiner::plus_equal(A,B) to help simplify code in
	  various places  
	
        * src/ClusterSequenceActiveArea.cc|hh 
  	  Added median_4vector option to mean_pt_strategies for
  	  pt_per_unit_area 
	  Added use_area_4vector to parabolic_pt_per_unit_area
	  NB. Neither is the default.

        * src/JetDefinition.cc
	  Corrected bug in massless recombination schemes for when
	  the pt of both particles is zero
	
	* src/ClusterSequenceActiveAreaExplicitGhosts.cc
	  The area_4vector is now calculated with the same 
	  recombination scheme as the jets
	
	
2007-02-25  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/PxCone/pxcone.f: 
	  fixed some bugs in the way momenta are recombined relating to
	  2pi periodicity of phi; identified origin of a remaining problem
	  of jets depending on the order of input particles -- related to
	  the way the n-way midpoints are determined.

2007-02-24  Gavin Salam  <salam@lpthe.jussieu.fr>

	* include/fastjet/PseudoJet.hh: 
	  arranged for template constructor also to set default user and
	  cluster-history indices
	
2007-02-21  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* plugins/CDFCones/CDFMidPointPlugin.hh|cc: 
	  added the option of specifying the scale to be used in the
	  split-merge step (pt is default, but we also have Et and mt), to
	  take advantage of the modification made to the CDF code below.

	* plugins/CDFCones/CDFcode/MidPointAlgorithm.hh|cc:
	  added the option of specifying the scale to be used in the
	  split-merge step (pt is default, but we also have Et and mt)

	  NB: this means that the CDF code we release is now actually a
	  modified version of the original.

2007-02-20  Gavin Salam  <salam@lpthe.jussieu.fr>

	* example/CmdLine.*
	  updated these to recent versions

	* example/fastjet_timing_plugins.cc (main): 
	  added the -nomt option for choosing the ordering in siscone
	  split merge.
	
	* plugins/SISCone/SISConePlugin.cc|h: 
	  added the "bool split_merge_on_transverse_mass" parameter to
	  constructor, put in a corresponding member variable and used it
	  when calling siscone.

2007-02-18  Gavin Salam  <salam@lpthe.jussieu.fr>

	* plugins/SISCone/Makefile (libSISConePlugin.a): fixed some
	  dependencies wrt to the siscone distribution directory.

2007-02-12  Gavin Salam  <salam@lpthe.jussieu.fr>

	* updated test-script.sh to accept -j2 option for faster compilation

	* ADDED include/fastjet/version.hh which sets the version number;
	  this is used throughout, also in tarit.sh and in svntagit.sh

	* ADDED svntagit.sh which will one day deal with all the tagging...

	* updated the test script ref. output to reflect the new version
  	  numbers
	
2007-02-09  Gavin Salam  <salam@lpthe.jussieu.fr>

	* switched external reference to siscone over to new repository, 
	  svn+ssh://login.hepforge.org/hepforge/svn/siscone/trunk

2007-02-08  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* modified tarit.sh so that it indicates which svn commands to
	  use to tag the release

2007-01-24  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo
          
        * tweaked test-script.sh some more
        * added fastjet-release/test-script-output-orig.txt
        * modified tarit.sh accordingly

2007-01-23  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo
	
        * removed more (all?) extraneous semi-colons
	* added fastjet-release/test-script.sh
	* added protojet_ptmin argument to SISConePlugin constructor (etc.)
	
2007-01-19+20  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* removed some extraneous semi-colons after functions in many
	  places, and checked that library now compiles with the "-pedantic
	  -Wno-long-long -Wimplicit -Wreturn-type -Wunused -Wparentheses"
	  options. NB PxConePlugin needs some more work on it before it
	  will compile (variable length arrays).

2007-01-12  Gavin Salam  <salam@lpthe.jussieu.fr> + matteo

        * areas/SubtractionDefinition.hh
          definition class for a future subtraction class

        * areas/ClusterSequenceWithSubtraction.hh
          class for subtraction

        * areas/subtraction-HIeff-native.cc
          main program which will eventually use the new
          subtraction class

        * areas/subtraction-HIeff-iter.cc
          Added before. Slightly modified version of 
          subtraction-HIeff-tests.cc.
          Performs a multi-pass subtraction,
          the same which will eventually be performed by the
          "-native" file above.



2007-01-08  Gavin Salam  <salam@lpthe.jussieu.fr>

	* areas/area-plots/2point-areas-3alg.gp
	  Passive area for 3 algs

	* areas/areas-1gluon-for-root.cc
	  areas/root-games/ghosted_plots.C

          root-related stuff for when there's a single hard parton
	  (illustrate active areas)

	
	
2007-01-02  Gavin Salam  <salam@lpthe.jussieu.fr>

        * added the areas/hydjet_eff directory to repository

	
2006-12-28  Gavin Salam  <salam@lpthe.jussieu.fr>

	* Added a "caching" option to the SISCone plugin to allow runs
	  with multiple overlap_threshold values (and everything else
	  identical) to reuse the set of stable cones.	

	* in PseudoJet introduced the "have_same_momentum(jeta, jetb)"
	  function (used in SISCone plugin).
	
2006-12-26  Gavin Salam  <salam@lpthe.jussieu.fr>

        * Added SISCone to the list of plugins made automatically

        * SISCone plugin now sets the jet "user_index" to be equal to the
	  pass at which the jet was found; documentation added to the
	  beginning of the class...
	
	* adapated areas/areas-hist.cc to use midpoint and siscone plugins
	  as well...
	
	* dealt with renaming from scones -> siscone; 

	* added the siscone repository as an "external" repository to
	  fastjet, inside plugins/SISCone (so that it is updated
	  automatically each time fastjet is updated -- but note: commits
	  do not recurse automatically down...)

        * also updated the usage_examples (many_algs_example now also runs
	  siscone).	

	* made this version 2.1.0b1 (changed tarit, but did not "tag" it)
	
2006-12-21  Gavin Salam <salam@lpthe.jussieu.fr> + Gregory Soyez

	* Modified SCones plugin so that it provides information also on
	  the use of "wrong" split-merge procedure.
	
2006-12-18  Gavin Salam <salam@lpthe.jussieu.fr> + Gregory Soyez

	* Added output of description of the algorithm in the
	  fastjet_timing_plugins routine routines (and got the .pl script
	  to read it), so that one knows what it is one's been doing. 
	  

2006-12-14  Gavin Salam <salam@lpthe.jussieu.fr> + Gregory Soyez

	* Added static function set_print_errors(bool) to Error.hh class
	  so that user can request "quiet" exceptions. NOT YET TESTED...

	
2006-12-12  Gavin Salam <salam@lpthe.jussieu.fr> + Gregory Soyez

	* Added plugin for SCones (Gregory's seedless cones code);
	  ran some basic tests; note the seedless cone code is not yet
	  included here, and the Makefile is accordingly a bit rough...

        * added example/fastjet_timing_plugins for running the timing
	  tests with the various plugin algorithms.
	
2006-12-07  Gavin Salam <salam@lpthe.jussieu.fr>

        * Changed tar script so that it works by first creating a tar
	  file, unpacking it in /tmp, renaming the corresponding directory
	  and then recreating the tar file (all of this to get the proper
	  directory name while maintaining symbolic links)

	* added ClusterSequence::unclustered_particles(), which returns a
	  vector of unclustered particles.	

	* added warning (printed up to 5 times) when extracting exclusive
	  jets with an algorithm other than kt.

	* in main Makefile, changed default inclusion of fortran libraries
	  to avoid also getting multiple libstdc++ (when g77 uses a
	  different version of gcc than g++).
	
2006-11-30  Gavin Salam <salam@lpthe.jussieu.fr>

	* Renamed the plugin directories (to have capitalisation
	  corresponding to library names), added the CDF cone code
	  together with Makefiles etc.

        * added plugins/usage_examples to illustrate how to use the
	  plugins, and how to use multiple jet algorithms together; added
	  some documentation to the pxcone and midpoint plugins (jetclu
	  users are on their own for the time being...)

	* adapted Doxyfile to include the plugins directory; made it
	  non-recurisve so that it doesn't get the CDF code and as a
	  result had to add various directories by hand

	* added mention of plugins/ directory in documentation.

	* Updated the banner to include mention of plugins; compactified
	  the rest a little.

	* Updated ReleaseNotes to reflect the current status
	
2006-11-29  Gavin Salam <salam@lpthe.jussieu.fr>

	* Added the Et and Et2 schemes, as well as boost invariant BIpt
	  and BIpt2 schemes.
	
2006-11-28  Gavin Salam <salam@lpthe.jussieu.fr>

	* fixed problems with alternative orderings of arguments in
	  JetDefinition constructor; added constructor with external
	  recombination scheme; added "preprocess" virtual function to
	  recombination scheme so that it carries out necessary
	  modification of momenta before running the clustering (as in
	  ktjet), and checked that pt and pt2 schemes give results
	  identical to those in ktjet (albeit boost-dependent...)
	
2006-11-27  Gavin Salam <salam@lpthe.jussieu.fr>

        * added recombination scheme functionality, both via a plugin (not
	  currently tested much) and (for standard use) with a
	  RecombinationScheme enum; take a look at ReleaseNotes for things
	  that still need to be done/tested...

	  Modified example program so that it makes recombination scheme
	  freedom explicitly visible.
	
2006-11-23  Gavin Salam <salam@lpthe.jussieu.fr>

        * added areas/area-hist-plots/ which contains results of area
	  histograms for "idealized" soft clustering and clustering with a
	  single hard parton.
	
2006-11-13  Gavin Salam <salam@lpthe.jussieu.fr>

        * Added more stuff related to plots & sorted out some svn:ignore
	  properties 
	
2006-11-11  Gavin Salam <salam@lpthe.jussieu.fr>

        * added a whole bunch of plots and related material in the
	  area-plots directory that previously weren't in version control

	* added a QM2006/ directory which includes some material
	  (jet-finding on individual events) for illustrative plots.

	* in areas/ put a recent version of the CmdLine.* utility class.

	* added areas/README to help navigate that directory, which is
	  rapidly becoming too complex!
	
	
2006-11-06  Gavin Salam <salam@lpthe.jussieu.fr>

        * added squared_distance(...) to PseudoJet (does the same as
	  plain_distance, but the name is more logical).

        * added areas/subtraction-tests-HIeff.cc for carrying out
	  efficiency and purity studies.

	* areas/SimpleHist.hh got modified to provide more extensive
	  histogramming facilities (notably an overflow bin)

	* areas/run-mass-test.pl was modified to as to enable combined
	  hydjet+subtraction-tests-HIeff running. (Had previously also
	  been modified to have run_hydjet as the executable rather than
	  test2_hydjet).	
	
2006-10-25  Gavin Salam <salam@lpthe.jussieu.fr>

        * added m() method to PseudoJet (like CLHEP, for negative m2() it
	  returns -sqrt(-m2())).

	* to PseudoJet, added cluster_sequence_history_index() and
	  set_cluster_sequence_history_index(...) as alternative names for
	  cluster_hist_index() and set_cluster_hist_index(...), in the
	  hope that these new names might be more meaningful.

	* added a function particle_jet_indices(...) to ClusterSequence so
	  as to allow the user to easily identify which particles fall into
	  which jet (or no jet at all).	 [NOT YET DOCUMENTED]
	
2006-10-19  Gavin Salam <salam@lpthe.jussieu.fr>

	* replaced eta -> y (or rap) in documentation (was potentially
	  unclear before) and in ActiveAreaSpec class...
	
2006-10-16  Gavin Salam <salam@lpthe.jussieu.fr>

        Introduced plugin functionality (CCN28-76)
	
	* added description() member function to JetDefinition class
	  (involved adding src/JetDefinition.cc which returns a default
	  value).

	* added a JetDefinition::Plugin abstract base class, which serves
	  as a model for user-supplied plugins; added an JetDefinition
	  constructor that takes a pointer to a plugin.

        * added checks in ClusterSequence to see whether we're dealing
	  with a plugin -- if we are then the plugin clustering routine is
	  called instead of ours; 

	  modified the inclusive_jets() routine so that it behaves
	  sensibly regardless of the diB values and ordering of the
	  clustering returned by the plugin.

	  added "plugin_record_ij_recombination", etc., member functions
	  to allow the plugin to make a record of what it's done in the
	  cluster sequence.	
	
2006-10-12  Gavin Salam <salam@lpthe.jussieu.fr>
	    
	* in include/fastjet/ClusterSequence.hh added a slightly more
	  user-friendly message for the doxygen main page.

2006-10-09  Gavin Salam <salam@lpthe.jussieu.fr> + Matteo

	    --- release of fastjet-2.0.0 ---
	
	* added a wider range of arithmetic operations on PseudoJets;
	  added phi_std() and phi_02pi() which return values respectively
	  in the -pi..pi range and 0..2pi range; in the clustering code,
	  switched from use of phi() to phi_02pi() to allow for future
	  changes to action of phi().

	* switched fastjet_subtraction.cc over to new arithmetic
	  operations.

	* programmed improved formulae for automatic choice of best
	  strategy, including the choice also for the Cambridge algorithm.

	* switched a number of member function of PseudoJet over from
	  const double & to simply double.

	* various small changes made to the documentation.
	
2006-09-25  Gavin Salam <salam@lpthe.jussieu.fr> + Matteo

	* added areas/areas-hist.cc for getting the distribution of areas
	  for pure noise (+ option of anchor).

	* moved the SimpleHist.hh file into this directory from ../../chan
	
	
2006-08-24  Gavin Salam <salam@lpthe.jussieu.fr> + Matteo

	* Renamed old_median -> non_ghost_median

        * parabolic_pt_per_unit_area made const

2006-08-23  Gavin Salam <salam@lpthe.jussieu.fr>

	* Renamed NlnNCam2piMultD -> NlnNCam (for simplicity).
	
2006-08-22  Matteo Cacciari <cacciari@lpthe.jussieu.fr>

        * example/fastjet_subtraction.cc

          Added the subtraction using area_4vector. The results
          are compared in output to the "standard" subtraction.
          Added some comments.


2006-08-19  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* include/fastjet/Error.hh

          error message output now states that this is a fastjet::Error
	  error. 

	* include/fastjet/ClusterSequence.hh
	* src/ClusterSequence.cc

	  Put some of the bookkeeping code into specific member functions
	  (_transfer_input_jets, _decant_options), so that this
	  housekeeping can be more easily (reliably) carried out also by
	  derived classes.

	  These new functions, as well as _do_iB_recombination_step,
	  _do_ij_recombination_step have been made protected (as opposed
	  to private), again for access from derived classes.

	* src/ClusterSequenceActiveAreaExplicitGhosts.cc
	* include/fastjet/ClusterSequenceActiveAreaExplicitGhosts.hh
	 
	  Arranged for _is_pure_ghost(int history_index) to return false
	  for any negative value of history_index (so that e.g. BeamJet is
	  not considered a ghost).

	* include/fastjet/ClusterSequenceActiveArea.hh
	* src/ClusterSequenceActiveArea.cc

	  Rather than first running the clustering on the unghosted event
	  and then providing area info from runs on ghosted events, this
	  class now deduces the unghosted clustering sequence from a
	  ghosted event, so as to reduce the number of runs. This is
	  relevant for heavy-ions. If the requested number of repetitions
	  is zero, it reverts to the plain unghosted-clustering

	
2006-08-19  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* include/fastjet/internal/BasicRandom.hh   *** ADDED ***
	* src/BasicRandom.hh                        *** ADDED ***

	  Added these files, which are basically copies of the (GPL)
	  random-number generator from Zoltan Nagy's nlojet++ program.

	* include/fastjet/ActiveAreaSpec.hh
	* ActiveAreaSpec.cc

	  Added _our_rand() to return a random double between 0.0 and 1.0,
	  checked that it gave identical results to before and then
	  switched over to using the BasicRandom<double> class.

	  NOTE: currently the random number generator object for
	  ActiveAreaSpec is static (ie. there is a single sequence shared
	  among all instances of ActiveAreaSpec). One consequence of this
	  is that in areas-2point.cc, previously we restarted the sequence
	  from the beginning for each separation Delta eta (giving some
	  correlation between successive values of eta), whereas, now,
	  successive values of eta are completely uncorrelated.

	* include/fastjet/ClusterSequenceActiveArea.hh
	  
	  Commented the lines that reset the global C random seed and
	  wrote a warning about this.

	
2006-08-17  Gavin Salam  <salam@lpthe.jussieu.fr>  & Matteo

	* Reworked naming scheme, so that all includes are now in
	  include/fastjet/ and those not destined for the user are in
	  include/fastjet/internal; we've introduced a namespace (fastjet)
	  and a fastjet/internal/base.hh file where we define begin and
	  end macros for it; we've put everything into the namespace...

	  The "Fj" prefix has been systematically removed...
	
	  added private/fastjet-rename-v1-to-v2.pl, to help in much of the
	  renaming of internals.

	* Introduced include/FjPseudoJet.hh and
	  include/FjClusterSequence.hh files that provide access to
	  everything needed by programs based on the v1 legacy interface

	* Removed the CP2DCHAN compile definition -- now the Chan code is
	  always included.

	* Added areas code to main release: created a base class
	  ClusterSequenceWithArea, as well as derived classes:

            ClusterSequenceActiveArea                // was WithMeanArea
	    ClusterSequenceActiveAreaExplicitGhosts  // was WithArea

	  and also included the class

	    ActiveAreaSpec

	* Placed an explicit limit (via assertion) on R <= pi/2 (larger
	  than this can cause crashes in many places...)

	* Removed extraneous code in areas/, adapted remaining code to new
	  interface.
	
2006-08-15  Gavin Salam  <salam@lpthe.jussieu.fr>  & Matteo

	* Copied Chan method across from its development directory

	* Added a data/ directory with some sample input files

	* moved release number up to 1.9, in preparation for forthcoming
	  release 2
	
        * updated examples to use new interface for specifying jet finder
	
2006-08-11  Gavin Salam  <salam@lpthe.jussieu.fr> 

        * modified FjPseudoJet's rapidity calculation so that it gives
          answers that are not completely crazy for momenta where rounding
          error causes the difference between E and pz to be zero.
	
	* played around with passive areas (including a plot or two) --
	  they seem to work OK.

	* fixed a bug (when reaching last pair of objects to cluster) in
	  the CP2DChan strategies.

	* in the main Makefile (and Triangulations.h) added option for
	  using a simpler CGAL kernel -- this can give about 20% speed
	  gain but it's not clear how robust it is.
	
2006-08-10  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* incorporated a first passive areas class,
	  FjClusterSequenceWithPassiveArea. It is quite slow, and
	  currently seen only very limited testing, but seems to work in
	  the 2-particle case...

	  next steps: add gnuplot visulation, look at more complex events

	* modified order of includes in some other class definitions to
	  place private things after public ones.	
	
2006-08-04  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* switched remaining jet-finding strategies over to use of
	  "_do_XY_recombination_step".

	* updated thresholds for "Best" to take into account the
	  N2MinHeapTiled version (though perhaps this should wait until
	  we've incorporated MinHeap into our "standard" suite...	

	  Have not updated things to deal with the Cambridge algorithm --
	  not sure what the best option would be here, given that Chan's
	  approach is so cache dependent...
	
2006-08-04  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* added routines for clustering the Cambridge algorithm based on
	  Chan's closest pairs (CP) method. The new strategies are:

	    NlnNCam4pi          // all points duplicated
	    NlnNCam2pi2R        // points within R of 0,2pi duplicated
	    NlnNCam2piMultD     // two steps of clustering to reduce duplctn.
                                   [fastest]
	
          For 10^4 particles, on a dual core P4D with 2MB cache,
	  NlnNCam2piMultD seems to be about 2.5 times faster than NlnN
	  (and 1.7 times faster than N2MinHeapTiled described below).	

	  As N grows larger, the advantages of the NlnNCam routines seem
	  to disappear, presumably because we end up outside limits of
	  cache. (And on machines with a small cache, e.g. anubis with
	  512KB, the advantage of the Cambridge-specific routines seem to
	  disappear.	
	
	* added a version of the tiled N2 algorithm that makes use of the
	  MinHeap developed for the CP work:

	    N2MinHeapTiled
 
	  On a dual-core P4D with 2MB cache, it seems to be the fastest
	  general option for 400 \lesssim N \lesssim 16000. 

	* the above options currently all require the CP2DChan library
	  which is in cvs in ../chan/ -- compilation there uses scons:

	        scons libCP2DChan.a

          (was testing out scons as an alternative to make...). At some
	  point, we should probably merge that codebase into ours.
	
	* added FjClusterSequence::_do_ij_recombination_step and 
	  _do_iB_recombination_step so as to avoid rampant duplication of
	  the associated code. Not all clusterings have switched over to
	  this yet...

	
2006-07-17  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* added area-plots/midpoint-zmass-profile-N1947.eps to see what
	  cone timings are like...
	
2006-07-17  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* In FjJetDefinition.hh renamed _R -> _Rparam (single letter
	  with underscore caused problems under g++3.3)
	
	* Added results and associated files for the ttbar analysis.

	
2006-07-15  Gavin Salam  <salam@lpthe.jussieu.fr> 

        * FjPseudoJet: added operator+=,-=,*=,/=, which leave the
	  user and cluster_hist indices unchanged. It is natural (in a
	  sense) insofar as these operators act naturally just on the
	  momentum -- in practice it is also useful because a user may
	  want to correct a jet in some way while still have the jet
	  associated with its "history").	

	* subtraction-tests-ttbar: now gives a full panoply of results in
	  histograms so that one can get a semi-sensible analysis of
	  ttbar events.	

	* run-mass-test.pl: adapted it so that it deals nicely with the
	  ttbar cases too...
	
2006-07-14  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* *** ADDED include/FjJetDefinition.hh *** 
	  in which we now define:

                  enum FjStrategy       // unchanged
	          enum FjJetFinder      // was part of FjClusterSequence
	          class FjJetDefinition // new

	  The class is designed to hold all info that specifies a jet
	  algorithm (currently, just R, jet-finder ID and strategy)

	  In FjClusterSequence.* new interfaces have been introduced in
	  which the FjJetDefinition is used to specify the jet algorithm;
	  these interfaces are present both for the public constructor and
	  for the protected _initialise_and_run(...) routines...
	
	  In areas/, some minor changes have been made to account for these
	  changes...

	  Also got the limit on the inclusive pt for the Cambridge jets
	  working (introduced separate code inside the inclusive_jets
	  routine).	

	  Started work on the ttbar project...
	
	* In areas/FjClusterSequenceWith[Mean]Area.*

	  Introduced the class FjActiveAreaSpec, which contains the
	  specification of how one defines the active area. It is intended
	  to provide a somewhat cleaner way of passing the information
	  around, and should hopefully provide an easier way of dealing
	  with the random number issue for this class (at least it's now
	  a well separated).

	  Introduced new interfaces for the various area routines so that
	  one can refer to them in both the new way (with an
	  FjActiveAreaSpec object) and the old way (for backwards
	  compatibility).

	  For now the FjActiveAreaSpec is inside the
	  FjClusterSequenceWithArea.* files -- but perhaps at some point
	  it should be moved?	

	
2006-07-13  Gavin Salam  <salam@lpthe.jussieu.fr> 

	* Added areas/subtraction-tests-ttbar.cc
	        areas/FlavourHolder.hh
	        areas/FlavourHolder.cc

          as part of work towards an analysis of semi-leptonic ttbar
	  events. 
	
2006-07-10  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo Cacciari

        * Added option in FjClusterSequenceWithMeanArea of excluding
	  particles with pt/area greater than some threshold

2006-07-05  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo Cacciari

        * Minor bug-fixed to FjClusterSequenceWithMeanArea 
	  + some files added related to heavy-ion studies
	
2006-07-03  Gavin Salam  <salam@lpthe.jussieu.fr> + Matteo Cacciari

	* Added areas/subtraction-tests-inclpt.cc for looking at inclusive
	  pt distributions (designed for use with hydjet events, at least
	  initially).
	
	* To FjClusterSequenceWithMeanArea.* added
	  parabolic_pt_per_unit_area for carrying out a parabolic
	  (a+b*y^2) fit	to the pt/area.

	* areas/run-mass-test.pl adapted to deal with the hydjet case too

	* areas/area-plots -- all plots updated (for Florence talk and
	  Matteo's US visit [done some time ago...])

	
2006-06-18  Gavin Salam  <salam@lpthe.jussieu.fr>

	* to areas/FjClusterSequenceWithArea.* placed upper limit on
	  number of seed warnings messages; on subtraction-tests-mass,
	  also placed upper limit on output of info (to avoid eccessively
	  large mails when running jobs)

2006-06-18  Gavin Salam  <salam@lpthe.jussieu.fr>

	* to areas/FjClusterSequenceWithArea.* placed upper limit on
	  number of seed warnings messages; on subtraction-tests-mass,
	  also placed upper limit on output of info (to avoid eccessively
	  large mails when running jobs)

2006-06-18  Gavin Salam  <salam@lpthe.jussieu.fr>

	* to FjClusterSequenceWith[Mean]Area.* added 
	
	    FjPseudoJet extended_area(const FjPseudoJet & jet) const;
 
	  member function which returns a four vector corresponding to
	  E-scheme addition and averaging of the ghost vectors (with
	  appropriate normalisation for each).

	* adapated areas/subtraction-tests-mass.cc to use the new extended
	  area (i.e. four-vector subtraction) for an alternative
	  subtraction scheme ("hecr" "fecr" go into two extra columns at
	  end, so as not to mess up original file format).

	
2006-06-13  Gavin Salam  <salam@lpthe.jussieu.fr>

        * Found bug in reading of hydjet format (didn't skip particles
	  with istat/=1), but in practice they ended up having
	  non-sensical rapidities so got thrown out anyway (i.e. results
	  don't change); 

	  THIS BUG SHOULD BE FIXED EVERYWHERE ELSE TOO...
	
2006-06-06  Gavin Salam  <salam@lpthe.jussieu.fr>

	* Added vector<int> FjClusterSequence::unique_history_order(),
	  which returns a order in which to read the history such
	  branchings are then independent of irrelevant degeneracies in
	  the d_ij. This is basically a corrected version of the
	  _extract_tree function added yesterday to
	  FjClusterSequenceWithMeanArea (now removed from that class). 

	* Arranged for FjClusterSequenceWithMeanArea to use the new
	  unique_history_order to map jets between the plain clustering
	  and that with the active area measurement. First tests suggests
	  that it's behaving properly (i.e. giving same results as before
	  for the kt algorithm, and sensible looking results for the
	  cambridge algorithm).

	
2006-06-05  Gavin Salam  <salam@lpthe.jussieu.fr>
	* Added the _extract_tree private member function to
	  FjClusterSequenceWithMeanArea, which extracts a tree that should
	  have a unique ordering independently of degeneracies in the
	  labelling of the clustering. It comes along with some
	  helpers... Maybe it should be transferred into the main class?
	
2006-06-04  Gavin Salam  <salam@lpthe.jussieu.fr>

	* Added the jets(), history() and n_particles() member functions
	  to FjClusterSequence so that the user can access this raw
	  information if they want to (this was a solution to the problem
	  of accessing things when transferring info between area classes
	  -- somehow protected information of an object of a related class
	  is not available to "this"). These functions provide a const ref
	  (so hopefully the user can't do anything dangerous).

	* reworked transfer of information from the ...WithArea ->
	  ...WithMeanArea classes, so that now all jets should have a mean
	  area associated with them, and it might even work for the
	  Cambridge algorithm [though one has to watch out for possible
	  degeneracies there at the stage of jets -> inclusive jets].
	
2006-06-02  Gavin Salam  <salam@lpthe.jussieu.fr>

	* FjClusterSequenceWithMeanArea.* -- split this into .cc and .hh
	  files to make things a bit cleaner in future.

	* FjClusterSequenceWithArea.* added is_pure_ghost() function and
	  modified calculation of areas so that it occurs in a
	  post-processing stage; got areas-native to print out whether a
	  jet is a true one or a ghost one...
	
	* FjClusterSequence.cc: made _fill_initial_history reserve space
	  in _jets and _history.

2006-06-01  Gavin Salam  <salam@lpthe.jussieu.fr>

	* FjClusterSequence.cc: caused it to throw an error if the event
	  is empty. (Should think about what happens if the event contains
	  only one parton?)

2006-05-31  Gavin Salam  <salam@lpthe.jussieu.fr>

	* added -cone075 options for areas/subtraction-tests-mass.cc
  	  (overlap fraction of 0.75 with standard midpoint cone)
	
2006-05-29  Gavin Salam  <salam@lpthe.jussieu.fr>

	* added a few more options for areas/subtraction-tests-mass.cc
	  (one of them allowing one to eliminate the temporary
	  intermediate file in run-mass-tests.sh)
	
2006-05-27  Gavin Salam  <salam@lpthe.jussieu.fr>

	* added enum FjClusterSequence::FjJetFinder, which defines the
   	  kt_algorithm and the cambridge_algorithm; implemented
	  FjClusterSequence::set_jet_finder which determines which of the
	  two algorithms to use in the clustering. Added -cam option to
	  fastjet_timing and subtraction-tests-mass. Note that the
	  Cambridge impleemntation is extremely crude , that many
	  functionalities are still missing, and that we will almost
	  certain want to rethink the interface to it at some later
	  point...
	
	* added areas/merge-hist.pl for merging histograms and added a
	  -freq option to subtractes-tests-mass so as to allow output of
	  intermediate results.
	
2006-05-26  Gavin Salam  <salam@lpthe.jussieu.fr>

        * in areas/subtraction-tests-mass.cc: changed outnormalisation of
	  histograms so as to make it easy to compare histograms made with
	  different bin widths and different numbers of events.
	
	* in areas/subtraction-tests-mass.cc introduced -cone and
	  -searchcone options for running with the plain midpoint cone and
	  CDF's IR nearly unsafe midpoint searchcone algo.	
	
	* added areas/run-mass-test.pl which runs pythia and pipes its
	  output into subtraction-tests-mass (via a named pipe, splitting
	  up the options appropriately between the two programs).

	* copied areas/subtraction-tests.cc -> subtraction-tests-mass.cc and
	  started organizing it a bit better, removing extraneous material
	  etc.; added new option -bin (sets the bin width).

	* introduced -in and -out options for subtraction-tests.cc (naming
	  the files makes it easier to figure out what's going on when we
	  look at an output file later).



2006-05-25  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo for conception

	* added examples/test-correctness.sh for testing that all the
	  different algorithms are giving consistent results

	* in FjClusterSequence.hh, introduced jet_scale_for_algorithm,
	  which given a jet returns the scale to be used in the
	  clustering. Currently it is kt^2, but by replacing it with the
	  1, one gets the Cambridge/Aachen algorithm. Made modifications
  	  elsewhere so that everything should now be using the new form;
	  still need to check that with the scale set to 1 it gives the
	  same as the Cambridge algorithm code [and maybe want to examine
	  timings?].

2006-05-24  Gavin SALAM  <salam@lpthe.jussieu.fr>

        * In areas/, added basic histogramming class (CSHisto), and used
	  it to look at mass distribution of a reconstructed Z (decayed to
	  two jets).
	
        * In FjPseudoJet.* added m2() member function and one instance of
	  a multiplication operator.
	
	* In DynamicNearestNeighbours.hh and DnnPlane.cc, renamed
	  DNN_Error -> DnnError, and added a constructor for DnnError that
	  prints out an error message.

	* Added the file include/FjError.hh which defines a class FjError
	  that is used for throwing all exceptions (except those related
	  to DnnError -- maybe need to catch things there?)

2006-05-23  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo (part)

	* Added FjClusterSequenceWithMeanArea::play option when calling
	  FjClusterSequenceWithMeanAreapt_per_unit_area, for printing
	  out all sorts of bits and pieces; median was renamed old_median,
	  and now median gives a median which takes into account also the
	  average number of non-jets when calculating the median position.
          It is this new median that is now used also when determining
	  cuts for averages.
	  
          Mean pt/area ratios and overal pt/area ratios now also take into
	  account the non-jet number and area (respectively).
	

2006-05-22  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

        * modified (areas|examples)/CmdLine.* so as to have the facility
	  to find out if there are any unused/invalid options.
	
	* Added areas/subtraction-tests.cc for examining how subtraction
	  of underlying events etc works 

	* Added internal support for getting "non-jet" areas inside
	areas/FjClusterSequenceWithMeanArea.hh (but no external handles
	for time being).
	
	* modified a couple of comments in FjPseudoJet.hh to better
	  reflect return values of plain_distance().

2006-05-15  Gavin SALAM  <salam@lpthe.jussieu.fr> + Matteo

	* Added areas/areas-test-mean-class and
	areas/FjClusterSequenceWithMeanArea.hh to help automate the study
	of areas and relevant subtractions. Played with it a bit...
	
	* in FjClusterSequence.hh -> included cmath and switched abs ->
	std::abs (following compiler complaints with g++ 4.1.0, where we
	would have got int abs(int) rather than the double version).

	* in FjClusterSequence.hh: made the clustering history protected
	rather than private.
	
2006-05-12  Gavin SALAM + Matteo Cacciari  <salam@lpthe.jussieu.fr>

	* in areas/areas-histogramming.cc (not part of release) discovered
	that CGAL (probably) is playing with random numbers messing up our
	sequence for area studies via creation of ghosts; so currently
	set explicit new seed at each turn of loop. 

	Also fixed Makefile dependencies in areas/. 

	Also, writeout_combinations with FlClusterSequence_witharea now
	prints out the full list of particles (including ghosts) before
	clustering. 
	
	* discovered problem with gcc-3.2.3 and certain events,
	specifically: 

	./fastjet_timing -combine 10 -incl 0.0 -strategy 2 < ../../Pythia-1PtMin50+nMinBias-mansorted.dat

	The problem manifests itself when erasing things from the tree,
	but hasn't been identified beyond that; running it with valgrind
	it miraculously works (and gives no valgrind errors). It works
	also with gcc-3.3 (Mac) and gcc-3.4.3 (zetes). Some commented code
	is in FjClusterSequence_Delaunay to try to uncover what's
	happening, but no conclusion has been reached yet. Non-Delaunay
	variants work fine (3pi,4pi variants have problems for different
	event sets, e.g. -combine 12).
	
2006-04-04  Gavin SALAM  + Matteo Cacciari <salam@lpthe.jussieu.fr>

	* src/FjClusterSequence_Delaunay.cc: in _add_ktdistance_to_map,
	changed if (kt2i <  _jets[jj].kt2()) to 
                if (kt2i <= _jets[jj].kt2())
        so as catch the case when the two are equal.
	
2006-03-??  Gavin SALAM  + Matteo Cacciari <salam@lpthe.jussieu.fr>

        * some bug fixes to sanitization routines (appeared with different
	compiler version).
	
2006-02-28  Gavin SALAM  <salam@lpthe.jussieu.fr>

	* Replaced typedef std::pair<double,double> EtaPhi with a class
	that allows one to conveniently sanitize phi into the correct range.

	* From FjClusterSequence::_delaunay_cluster, called the
	sanitization routine when inserting a new point... Should make
	thing a bit more robust in cases where arithmetic rounding tricks
	cause confusion bewteen 0 and 2pi.
	
2006-02-26  Gavin Salam  <salam@lpthe.jussieu.fr>

	* adapted timing scripts so as to get reasonable behaviour for
	very high N (including subtraction of read time and limiting
	nstat). 

2006-02-17  Gavin SALAM  <salam@lpthe.jussieu.fr> & Matteo Cacciari

	This is release v1.0.0b3

	* fixed huge memory leak in the N ln N CGAL-based strategies.

	* changes to internal structure of FjClusterSequence class to
	simplify future developments.

2006-02-13  Gavin Salam  <salam@lpthe.jussieu.fr>

	This is release v1.0.0b2

	* added "#include <cassert>" in places where it's needed (thanks
	to Thomas Kluge for pointing out the need for this).

	* Improved error message in case of request for N ln N strategy
	when CGAL has not been compiled in.

	* when creating package, main Makefile is automatically modified
	to have USE_CGAL=no (the original is put back after creating the
	tarfile).
	
2006-02-13   v1.0.0b1
	* arranged for harmonisation of behaviour of the various example
	programs...
	
2006-02-04   v1.0.0b0
	* added minimal standard files (ChangeLog, LICENSE) and headers
	for GNU dist and included cvs ID string in all code files.

----------------------------------------------------------------------
2006/02/04 GPS
--------------

FjClusterSequence.hh
FjClusterSequence_TiledN2.cc
        fixed bug in tiling for R/=1 (assumptions about indices for
        wrapping in phi that were hard-coded for R=1).

example/ktjet_timing.cc  *** ADDED ***
        Makefile adapted too...

----------------------------------------------------------------------
2006/02/03 GPS
--------------

Various things done since copying across from previous directory in
preparation for release:

Name changes:        Fj prefix added to public types
FjStrategy:          turned into enum and renamed from "clever"
directory structure: src/, example/, lib/, include/ rather single dir
documentation:       added doc/fastjet-doc.tex as a manual

