Index: contrib/trunk/DEVEL-GUIDELINES =================================================================== --- contrib/trunk/DEVEL-GUIDELINES (revision 1207) +++ contrib/trunk/DEVEL-GUIDELINES (revision 1208) @@ -1,251 +1,251 @@ Guidelines for the FastJet Contrib area --------------------------------------- The FastJet contrib area is intended for developers of FastJet-related C++ tools, so as to provide easy access to their work in a common, publicly accessible location. If you wish to add code to the fastjet-contrib repository, please follow the guidelines indicated below, intended to give users a reasonably uniform experience and to facilitate versioning and quality control. For further information about making contributions, please contact fastjet@projects.hepforge.org ====================================================================== Basic developer usage ===================== # to get started you will need a hepforge account. Go to # # https://www.hepforge.org/register # # to create it. # # Then you will need to set up access through an ssh key. Go to # # https://phab.hepforge.org/settings/user/USERNAME/page/ssh/ # # (replace USERNAME with your actual username), click on # "SSH Key Actions" and select "Upload Public Key". # check out the overall contrib directory - svn checkout svn+ssh://vcs@phab.hepforge.org/source/fastjetsvn/contrib/trunk fjcontrib + svn checkout https://svn.hepforge.org/fastjetsvn/contrib/trunk fjcontrib cd fjcontrib # get the existing contribs (optional, but useful) scripts/update-contribs.sh # start your new contrib, choosing your own "ContribName" (*) # Running this script produces a template for the new contrib # in the form of a new ContribName/ subdirectory of fjcontrib, # including a basic Makefile (further info below) scripts/new-contrib-from-template.sh ContribName # once you have something worth committing, write to the fastjet contrib # maintainers at to get write access to the # fjcontrib svn. We will need your username. # and then run scripts/register-new-contrib.sh ContribName # within your pre-existing ContribName/ directory you can now "svn # add" your files, commit them etc. # you should probably also run "svn propset svn:keywords Id *.cc *.hh" # so that their $Id$ tag automatically gets updated when you commit # when you're ready to make a versioned release, make sure that # # - all required files (AUTHORS, COPYING, NEWS etc.) are up to date # - VERSION includes the version number for the release # - "make check" and "make install" both work # - everything is committed # # At this point the fjcontrib maintainers are usually happy to have a # quick look through your code and provide comments based on # experience with other contribs. # # Once you're ready to make a release, run scripts/release-contrib.sh ContribName # send a mail to fastjet@projects.hepforge.org with a request for # that version to be made public (*) Note that if you have previously "registered" your contrib (i.e. you have run "scripts/register-new-contrib.sh ContribName") you can get it in a fresh checkout of the overall fjcontrib directory by running scripts/update-contribs.sh ContribName trunk Please refrain from developing other people's contribs without first consulting them! Note: currently there is no mechanism for handling external dependencies (ROOT, gsl, etc.), nor for handling dependencies between different contribs. ====================================================================== Further details =============== Each contribution is the responsibility of its authors. The FastJet authors will not provide direct support. Each contribution must be in a directory of its own. The name of the directory will also by default be used for the library component. Each contribution should be made available under the terms of the GNU General Public License (v2 or later), or if the author wishes, under a more permissive license that is compatible with the GNU GPL. Each contribution should include the following files (automatically put in place when you run scripts/new-contrib-from-template.sh, see below): - COPYING: giving license information - AUTHORS: names of authors, including current email addresses - README: giving a basic explanation of the scope and usage of the contrib and indication of which work should be cited by users of your code. Please mention any external dependencies, e.g. ROOT, GSL, Boost, etc. - at least one example program (e.g. example.cc) using the contrib tool or plugin, together with a file containing the expected output (example.ref). - VERSION: a version number, e.g. 1.0.x, which would be updated to 2.0.x in the event of a major change. - NEWS: to indicate what has changed in each new version - ChangeLog: finer grained details of day-to-day changes ====================================================================== Build system ============ Each contribution should include a Makefile. A reasonable default is generated when you run scripts/new-contrib-from-template.sh A few variables appearing at the top of the Makefile may need to be modified: - NAME - SRCS - EXAMPLES - INSTALLED_HEADERS Additionally you will need to ensure that "make check" works. By default it does the following: - builds the "example" program, - runs it, reading ../data/single-event.dat from standard input - compares the output to the "example.ref" file (after stripping lines that started with "#") In most cases, to get "make check" to work, it is sufficient to replace the template's example.ref file with the correct output from your program. If you want to use a different input file, modify the relevant line in the Makefile. You may also write your own Makefile (or adapt one from scripts/internal/Template/Makefile ). In this case - It should prominently define a variable FASTJETCONFIG near the beginning of the file. By default FASTJETCONFIG should be set to fastjet-config, i.e. the contribution should build out of the box if fastjet-config is in the user's path. - It should include the following targets . all . check . install . examples . clean . distclean ====================================================================== Structure of the svn repository =============================== The repository at svn+ssh://vcs@phab.hepforge.org/source/fastjetsvn/contrib/ (read-write) https://phab.hepforge.org/source/fastjetsvn/browse/contrib/ (browse) is organised as follows: # area for the overall fastjet-contrib scripts and information about # currently used version of individual contribs. Currently only # maintainers of the overall fjcontrib area have write acces # trunk/ # development version tags/ # official releases branches/ # branches # areas for individual contribs. Developers each have access # to all contribs by default (for simplicity) contribs/ContribName/trunk # development version contribs/ContribName/tags # official releases contribs/ContribName/branches # branches Within the main fastjet contrib directory, the file "contribs.svn" file indicates which contribs (and their version) are to be extracted by scripts/update-contribs.sh ====================================================================== Guidelines for reviewing contribs ================================= [This part of the guidelines is in the process of being drafted] - Does the contrib do something non-trivial? I.e. does it do something that cannot already be easily done with a few lines of FJ code? - Is the contrib well documented? All classes, constructors, member functions, etc., that are exposed to the user should have an instructive comment about what they do (or be so well named that a comment is redundant). - Does the example(s) demonstrate all the main features of the code? - Does the example indicate what command-line should be used to run it? - Does the contrib make sensible use of existing FastJet features and, where relevant, does its interface follow the pattern of standard FJ3 interfaces? (E.g. with FunctionOfPseudoJet, Selectors, etc.). Conforming with existing interfaces helps give users a uniform experience. - Are namings logical and similar to those in FastJet: e.g. if the contrib is simply a plugin, the class name should end in "Plugin" and the contrib name should probably be the same as the class name. - Are the tests carried out as part of make check reasonably exhaustive? Are the contents of the reference results file sufficient to have a reasonable chance of spotting future changes? (E.g. a single bool as the output has a 50% chance of coming out right even if the code is misbehaving). - If you run the example with valgrind, does it run free of errors and memory leaks? We've found that valgrind tests are often better carried out on linux machines than on macs. - Does "make fragile-shared" work? Some people rely on it. - Are the README, AUTHORS, NEWS and ChangeLog files sensible? Are line lengths suitable for web viewing (e.g. no more than 80 characters per line). - Are the $Id$ tags set correctly in the files? You can set them by doing the following in your directory svn propset svn:keywords Id *.cc *.hh Index: contrib/trunk/ChangeLog =================================================================== --- contrib/trunk/ChangeLog (revision 1207) +++ contrib/trunk/ChangeLog (revision 1208) @@ -1,989 +1,990 @@ 2018-12-04 Gavin Salam + * DEVEL-GUIDELINES: * scripts/internal/common.sh (svn_read): * README: updated links for read-only access. 2018-12-04 Gavin Salam * NEWS: * VERSION: prepared for release of 1.040 with ValenciaPlugin 2.0.1 * contribs.svn: updated ValenciaPlugin to 2.0.1 2018-10-31 Gavin Salam * scripts/internal/generate-html-contents.pl: * scripts/internal/common.sh: fixed issue with incorrect links generate-html-contents.pl and made it import svn_read address from environment variables set in common.sh 2018-10-31 Gavin Salam * NEWS: * VERSION: preparing for 1.039 release with LundPlane 1.0.2 2018-10-30 Gavin Salam * contribs.svn: updated LundPlane to 1.0.2 2018-10-25 Gavin Salam * DEVEL-GUIDELINES * README * scripts/internal/common.sh * scripts/internal/check-updates.sh * scripts/internal/generate-html-contents.pl * scripts/internal/release-fjcontrib.sh work in progress to move things over to the new hepforge system. 2018-08-30 Gavin Salam * VERSION: * NEWS: prepared release of 1.038 with LundPlane 1.0.1 * contribs.svn: added LundPlane version 1.0.1 2018-08-23 Gavin Salam + Matteo * scripts/internal/get-author-emails.py: added script to extract all author emails 2018-08-23 Gavin Salam * scripts/update-contribs.sh: documented the --force option in the help message 2018-07-20 Gavin Salam * VERSION: * NEWS: * contribs.svn: prepared release of 1.037 with ConstituentSubtractor updated to 1.3.1 2018-06-06 Gavin Salam * VERSION: * NEWS: prepared release of 1.036. * contribs.svn: updated Nsubjettiness to 2.2.5, with fix for bug involving undefined pointer for in AxesDefinition 2018-05-29 Gavin Salam * VERSION: * NEWS: prepared for the release of 1.035 * contribs.svn: updated RecursiveTools to 2.0.0-beta2 with bug fix for recent clang compilers. 2018-05-28 Gavin Salam * contribs.svn: updated ConstituentSubtractor to 1.2.7 (extra features, clearer examples) 2018-05-18 Gregory Soyez * VERSION: * NEWS: prepared for the release of 1.034 * contribs.svn: upped ConstituentSubtractor to 1.2.5 (fixing a bug) * scripts/internal/Template/Makefile added CXXFLAGS to the compilation of the examples 2018-02-15 Gregory Soyez * VERSION: * NEWS: prepared for the release of 1.033 * contribs.svn: upped EnergyCorrelator to 1.3.1 (fixing a memory leak) 2018-01-17 Gavin Salam * NEWS: * VERSION: prepared for release of 1.032 * contribs.svn: updated EnergyCorrelator to 1.3.0 2017-12-20 Gavin Salam * VERSION: * NEWS: upped version to 1.031 & prepared NEWS for release * contribs.svn: upped ConstituentSubtractor to 1.2.4 2017-11-13 Gavin Salam * configure: included patch from attila.krasznahorkay@cern.ch for issue with macOS sed. 2017-10-13 Gregory Soyez * VERSION: * NEWS: preapred to release v1.030 * contribs.svn: switched to v2.0.0-beta1 of RecursiveTools 2017-09-10 Gavin Salam * VERSION: * NEWS: prepared release 1.029 * contribs.svn: added FlavorCone tags/1.0.0 updated ConstituentSubtractor to 1.2.3 * scripts/release-contrib.sh: changed error and usage messages to reflect correct script name. 2017-08-30 Gregory Soyez * NEWS: * VERSION: switched to version 1.028 in view of release and updated NEWS accordingly. * contribs.svn: switched ConstituentSubtractor to 1.2.2 [added back an erronously-renamed function] 2017-08-10 Gavin Salam * NEWS: * VERSION: switched to version 1.027 in view of release and updated NEWS accordingly. * contribs.svn: updated ConstituentSubtractor to v1.2.1, which includes changes to the treatment of massive particles and speed improvements for whole-event subtraction. 2017-01-25 Gavin Salam * NEWS: * VERSION: switched to version 1.026 in view of release and updated NEWS accordingly. * contribs.svn: updated ConstituentSubtractor to v1.1.5, which includes new pileup subtraction options and rho-rescaling. 2016-10-07 Gavin Salam * NEWS: * VERSION: Switched version to 1.025 in view of a release; updated NEWS accordingly. * contribs.svn: switched EnergyCorrelator to version 1.2.0 2016-06-21 Gregory Soyez * VERSION: * NEWS: Switched version number over to 1.024 (in view of a release) Updated the release notes * contribs.svn: switched to Nsubjettiness 2.2.4 2016-06-01 Gregory Soyez * contribs.svn: switched VariableR over to v1.2.1 2016-04-28 Gregory Soyez * VERSION: * NEWS: Switched version number over to 1.023 (in view of a release) Updated the release notes * contribs.svn: switched to Nsubjettiness 2.2.3 2016-03-31 Gregory Soyez * VERSION: set version number to 1.022 prior to the release 2016-03-30 Gavin Salam * utils/check.sh (DIFF): provided more output in cases where the check fails. * NEWS: minor tweak to NEWS 2016-03-30 Gregory Soyez * NEWS: drafted for the release of fjcontrib-1.022 * contribs.svn: switched GenericSubtractor over to version 1.3.1 2016-03-29 Gregory Soyez * contribs.svn: switched VariableR over to 1.2.0 and Nsubjettiness to 2.2.2 2016-03-10 Gregory Soyez * scripts/internal/check-updates.sh: *** ADDED *** added an internal script that checks if the list in contribs.svn is up-to-date 2016-03-09 Gregory Soyez * contribs.svn: switched ConstituentSubtractor over to version 1.1.1 2015-10-12 Gregory Soyez * NEWS: * VERSION: prepared for release 1.021 including QCDAwarePlugin 1.0.0 * contribs.svn: added QCDAwarePlugin to the list of included contribs 2015-10-05 Matteo Cacciari * scripts/internal/release-fjcontrib.sh fixed harmless typo 2015-10-05 Matteo Cacciari * Makefile.in install permissions of libfastjetcontribfragile.so switched from 0644 to 0755 (reported by Dario Berzano). This will go into 1.020 * NEWS mentioned item above 2015-10-04 Matteo Cacciari * NEWS: * VERSION: prepared for release 1.020 with Nsubjettiness 2.2.1 2015-10-04 Gavin Salam * DEVEL-GUIDELINES: mentioned the need to check that "make fragile-shared" works. * scripts/internal/release-fjcontrib.sh: added a check that "make fragile-shared" works. 2015-09-28 Gregory Soyez * contribs.svn: switched to version 2.2.1 of Nsubjettiness [minor bug in Makefile] 2015-09-24 Matteo Cacciari * scripts/internal/generate-html-contents.pl set up to extract from svn date of tag of last version and output it in the table with the list of contribs 2015-09-21 Gregory Soyez * NEWS: * VERSION: prepared for release 1.019 GenericSubtractor 1.3.0 * contribs.svn: switched GenericSubtractor to version 1.3.0 2015-09-07 Gregory Soyez * NEWS: * VERSION: prepared for release 1.018 with Nsubjettiness 2.2.0 2015-07-23 Gregory Soyez * data/single-ee-event.dat: *** ADDED *** added a simple e+e- event for tests in e+e- coordinates 2015-05-05 Gavin Salam * NEWS: * VERSION: prepared NEWS and VERSION files for release 1.017 with ClusteringVetoPlugin 1.0.0 2015-05-04 Gavin Salam * contribs.svn: added ClusteringVetoPlugin 1.0.0 2015-04-07 Gavin Salam * VERSION: * NEWS: updated version to 1.016 and mentioned ValenciaPlugin 2.0.0 in NEWS * contribs.svn: added ValenciaPlugin (tags/2.0.0) 2015-02-20 Gavin Salam + Matteo * DEVEL-GUIDELINES: mentioned that people should set svn:keywords to Id on relevant files. * scripts/internal/Template/example.cc modified template example header to include a line showing how to run the example. 2014-11-25 Gavin Salam * NEWS: * VERSION: updated version 1.015 and prepared NEWS * contribs.svn: updated EnergyCorrelator to version 1.1.0 2014-08-17 Gavin Salam * NEWS: * VERSION: updated version to 1.014 and prepared NEWS * contribs.svn: added SoftKiller 1.0.0 2014-08-16 Gavin Salam * contribs.svn: updated JetCleanser version to tags/1.0.1 2014-07-09 Gregory Soyez * VERSION: * NEWS: updated version to 1.013 and prepared NEWS for release. * contribs.svn: . updated Nsubjettiness to version 2.1.0 . added release 1.0.0 of the new RecursiveTools contrib by G. Salam, G. Soyez and J. Thaler 2014-06-12 Gregory Soyez * configure (sorted_built_contribs): slightly enlarged the space for printing contribs summary 2014-06-03 Gavin Salam * VERSION: * NEWS: updated version to 1.012 and prepared NEWS for release. * contribs.svn: updated VariableR to version 1.1.1 2014-04-06 Gavin Salam * VERSION: * NEWS: upped version to 1.011 for new contrib with ConstituentSubtractor and prepared NEWS for the release. * contribs.svn: added release 1.0.0 of the new ConstituentSubtractor by Peter Berta et al. 2014-04-02 Gavin Salam * DEVEL-GUIDELINES: added details of how to set svn:keywords on source files. 2014-03-14 Gavin Salam * Makefile.in (distclean): distclean depended on CMS-shared-distclean when it should have been fragile-shared-distclean. 2014-03-01 Matteo Cacciari * scripts/internal/generate-html-contents.pl added (and set) option to list the contribs alphabetically. Also added (but not activated) option to include the date using the time stamp of the svn tag 2014-02-26 Matteo Cacciari * NEWS: * VERSION: upped version to 1.010 for release with new contrib JetsWithoutJets and added release date to NEWS. * contribs.svn added JetsWithoutJets v1.0.0 * configure - added a blank line in output to config.log - enabled alphabetically ordered output of enabled contribs 2014-02-03 Gavin Salam * NEWS: * VERSION: upped version to 1.009 for release and added release date to NEWS. 2014-01-31 Gavin SALAM + Gregory + Matteo * configure: * Makefile.in: added targets fragile-shared fragile-shared-install and fragile-shared-distclean; the fragile-shared(-install) builds (installs) a libfastjetcontribfragile.so file. This is currently very fragile, in that it relies on just the SRCS formatting in the individual contrib makefiles (all sources on a single line, without wildcards). 2014-01-20 Gavin Salam * Makefile.in: * utils/check.sh: arranged for make check to exit with error on failure from within subdirectories, but to exit OK on failure when called from the main directory (previous behaviour was to always exit OK). Removed redundant "exit 1" from the check.sh code (exit always handled by print_status_and_exit(...)). Also, when called directly from a subdirectory, make check no longer records its output in the test_summary.tmp file, and it now prints a colour-coded success/failure message. 2013-10-24 Gregory Soyez * scripts/internal/switch-to-version.sh: updated to add support for branches * scripts/update-contribs.sh (script_new_version): fixed an issue with checking out versions containing a '-' [the regular expression matching pattern was consifering these as "to-be-skipped"] 2013-10-21 Gavin Salam * DEVEL-GUIDELINES: added some first thoughts on guidelines for reviewing 2013-09-24 Matteo Cacciari * VERSION: * NEWS: released fjcontrib 1.008 with new contrib JetCleanser 1.0.0 * contribs.svn: added JetCleanser 1.0.0 2013-09-22 Matteo Cacciari * data/Pythia-Zp2jets-lhc-pileup-1ev.dat replaced with new file including also particle ID and charge. The events remain the same (up to, sometimes, differences in the last digit), the "make check" still work without changing the old reference files 2013-09-22 Matteo Cacciari * utils/check.sh added a safety check to verify if tput is present on the system before using it to set colors 2013-09-19 Matteo Cacciari * utils/check.sh added colors to Success/Failed output from "make check" * scripts/internal/generate-html-contents.pl a flag can now be set to get an alphabetically ordered output (currently set to false, i.e. same output as before) 2013-09-19 Gregory Soyez * Makefile.in: * utils/check.sh: instead of having "make check" exit with an error whenever a test fails, let it keep going and print a summary of what has failed and succeded at the end of everything 2013-09-03 Matteo Cacciari * contribs.svn: switched SubjetCounting to version 1.0.1 * NEWS: released fjcontrib 1.007 with new contrib SubjetCounting 1.0.1 and bugfix for exclusion and inclusion of more than one contrib 2013-09-03 Matteo Cacciari * VERSION: * NEWS: released fjcontrib 1.007 with new contrib SubjetCounting 1.0.0 and bugfix for exclusion and inclusion of more than one contrib (not actually released as a tarball, see entry above) * contribs.svn: added SubjetCounting 1.0.0 2013-08-28 Matteo Cacciari * configure fixed two bugs that were preventing specifying more than one contrib with the --only and --exclude options. The issues were a spurious "/" appearing in the replacement of commas with blanks in the contribs list, and a non-escaped command-line passed through sed when writing out the Makefile. 2013-08-27 Gregory Soyez * VERSION: * NEWS: released fjcontrib 1.006 including Nsubjettiness 1.0.3 * contribs.svn: switched NSubjetiness to version 1.0.3 2013-08-13 Gavin Salam * configure: identification of svn info fixed to work also with svn 1.8 (that version prints an absolute and relative URL, and configure was picking up both; now it picks up just the absolute URL). * scripts/internal/release-fjcontrib.sh: hopefully fixed bug where tagging comment didn't have version number (but '$version') 2013-07-24 Gavin Salam * DEVEL-GUIDELINES: mentioned that authors can ask for input from fjcontrib maintainers before making a release 2013-06-04 Gavin Salam * configure: improved error message when fastjet-config not found 2013-06-04 Gavin Salam * NEWS: * VERSION: released version 1.005, which adds ScJet 1.1.0 2013-06-03 Gavin Salam * contribs.svn: added ScJet 1.1.0 from Jeff Tseng 2013-05-28 Gavin Salam * NEWS: * VERSION: release of version 1.004 * contribs.svn: switched GenericSubtractor to version 1.2.0 2013-05-22 Gavin Salam * configure: for contribs obtained through an svn checkout (e.g. for developers), it now supplements version info from the ContribName/VERSION file with info about the svn location. 2013-05-07 Matteo Cacciari * scripts/internal/common.sh: further replacement [ \t] -> [[:space:]] for the fix mentioned below, since the first one fails to recognize tabs (only blanks worked) 2013-05-01 Gavin Salam * NEWS: * VERSION: release of 1.003 * contribs.svn: changed version of EnergyCorrelator to 1.0.1 * scripts/internal/common.sh: implemented suggested fix by J. Thaler for issue of already-checked out contribs not being recognized on some systems. 2013-04-30 Gavin Salam * contribs.svn: put in EnergyCorrelator 1.0.0 2013-04-29 Gregory Soyez + Matteo * scripts/update-contribs.sh: reworded comments at the top of the script to reflect the changes made with 'contribs.local' 2013-04-28 Matteo Cacciari + Gregory * scripts/update-contribs.sh * scripts/internal/common.sh * contribs.svn replaced contribs.local with local_svn to avoid confusion with the name of the file that will eventually be used to contain local modifications to contribs.svn. Fixed a regular expression in grep (allowing for mixture of spaces and tabs before the contrib name) Also reworded some comments. Added support for a contribs.local overriding default entries in contribs.svn. Added option to skip processing of a specific contribution by scripts/update-contribs.sh, by replacing version number with any number of dashes. 2013-04-27 Matteo Cacciari * utils/check.sh Fixed a few typos in comments 2013-04-12 Gregory Soyez * NEWS: * VERSION: prepared for 1.002 release * contribs.svn: GenericSubtractor switched to version 1.1.0 (was 1.0.0) 2013-02-23 Gavin Salam * NEWS: * VERSION: prepared for 1.001 release * contribs.svn: added VariableR 1.0.1 and Nsubjettiness 1.0.2 (from Jesse Thaler) * configure: now outputs version of each contrib (+ other small formatting) * Makefile.in: distclean now removes Makefile and .Makefile.inc 2013-02-22 Gavin Salam * utils/check.sh: now prints out the directory that it's running in 2013-02-21 Matteo Cacciari * DEVEL-GUIDELINES: Rephrased sentence about registering a new contrib and the note note about retrieving a registered contrib using scripts/update-contribs.sh ContribName trunk" 2013-02-21 Gregory Soyez * scripts/internal/Template/Makefile: added missing ; in make install 2013-02-21 Gavin Salam * DEVEL-GUIDELINES: added info on use of htpasswd to send us a password * scripts/internal/common.sh (svn_write): switched write URL from svn+ssh -> https 2013-02-21 Gavin Salam * README: fixed type for http checkout 2013-02-07 Matteo Cacciari * VERSION Pushed version to 1.000 for release * contribs.svn set version numbers to 1.0.0 for both GenericSubtractor and JetFFMoments 2013-02-06 Gavin SALAM + Matteo * scripts/internal/release-fjcontrib.sh: a few fixes wrt paths for the tarball, info on release date, parallel make, etc. 2013-02-06 Gavin SALAM + Matteo * scripts/update-contribs.sh: now does "exit 1" if it couldn't find a given contrib version on the svn. * scripts/internal/release-fjcontrib.sh: now allows user to carry on even if there are local modifications, but with a warning. * scripts/update-contribs.sh: tried to make sure that failure of switch-to-contrib results in failure of update-contribs too (important e.g. for release script) * configure (makefileinc): the .Makefile.inc file now has variables to override the install and check scripts (intended to help possible future changes + standalone functionality). * scripts/internal/check.sh -> utils/check.sh * scripts/internal/install-sh -> utils/install-sh moved these into a separate directory so that in the tarball we include utils, but can completely discard scripts/ * scripts/internal/Template/Makefile: this has been updated to use scripts in utils/* * scripts/internal/generate-html-contents.pl: now includes a link to the directory for the contrib * configure: fixed bug in output of prefix to .Makefile.inc (wasn't being output when it was derived from fastjet-config). * contribs.svn: JetFFMoments -> tags/0.99.1 * scripts/internal/release-fjcontrib.sh : fixed typo in checking of existing version; before asking about a release it now lists the contrib versions. * VERSION upped to 0.001 for more testing 2013-02-01 Gavin Salam * contribs.svn: GenericSubtractor -> 0.99.1 JetFFMoments -> 0.99 * configure: * Makefile.in: * scripts/internal/Template/Makefile: variables are now communicated to sub-directory Makefiles via a .Makefile.inc; trunks of JetFFMoments and GenericSubtractor also modified. * scripts/internal/release-fjcontrib.sh: contents now lives in a separate directory * scripts/update-contribs.sh: no longer query if the contrib isn't yet there. 2013-02-01 Gregory Soyez * scripts/internal/package.sh: (well... mostly Matteo) added a simple script to package a tarball 2013-01-31 Gregory Soyez * scripts/internal/release-fjcontrib.sh: . removed unneeded developer and svn-users files from the tarball . fixed a few typos and trivial bugs . check which fastjet-config to use when running tests . the script now upload the tarball and the relevant info for the webpage update * scripts/internal/generate-html-contents.pl: played with CSS styles so as to get a result that looks rather close to what is on the FastJet tools page * scripts/internal/common.sh: * scripts/update-contribs.sh: passed the default answer to get_yesno_answer as an argument rather than a pre-defined variable * scripts/internal/release-fjcontrib.sh: added a script to release fj-contrib it includes all the contrib in contribs.svn * configure: * README: used --fastjet-config=... rather than --fjconfig=... to specify the 'fastjet-config' file to use * scripts/update-contribs.sh: * scripts/internal/common.sh: allowed to run update-contribs.sh --force which will answer yes to all "yesno" questions asked * VERSION: *** ADDED *** added a VERSION file * scripts/internal/switch-to-version.sh: * scripts/register-new-contrib.sh: * scripts/new-contrib-from-template.sh: * scripts/release-contrib.sh: removed potential trailing / 2013-01-31 Gavin Salam + Gregory * DEVEL-GUIDELINES: *** ADDED *** * README tried to make these a little more compact. 2013-01-31 Gregory Soyez * scripts/make-release.sh -> scripts/release-contrib.sh: renamed for more consistency * scripts/internal/switch-to-version.sh: if the version starts with a digit, prefix it by "tags/" * scripts/internal/install-sh: added a script for installing files * scripts/make-release.sh: checked the full list of mandatory files when making a release 2013-01-31 Gavin Salam * scripts/update-contribs.sh: added -h option to update-contribs.sh 2013-01-31 Gregory Soyez * scripts/update-contribs.sh: if the svn up updated the update-contribs.sh script, re-run with the new version * AUTHORS: *** ADDED *** * COPYING: *** ADDED *** * scripts.internal/Template/COPYING: put this under GPLv2 and added the list of people maintaining the FastJet-contrib * README: mentioned new-contrib-from-template.sh instead of new-contrib-template.sh * scripts/internal/check.sh: checked that the expected output contains more than comments and empty lines 2013-01-31 Gavin SALAM + Matteo + Gregory * scripts/internal/Template/example.ref *** ADDED *** added a template reference output file for make check with instruction on what to do with it. * scripts/new-contrib-template.sh -> scripts/new-contrib-from-template.sh a more meaningful name. 2013-01-31 Gregory Soyez * scripts/internal/check.sh: default extension for expected output set to "ref" * scripts/internal/Template/example.cc: added missing header * scripts/internal/Template/Makefile * scripts/internal/check.sh: fixed some bash typos * scripts/switch-to-version.sh: *** DELETED *** * scripts/internal/switch-to-version.sh: *** ADDED *** * scripts/update-contribs.sh: moved switch-to version in internal/ * scripts/new-contrib-template.sh: *** ADDED *** * scripts/internal/Template: *** ADDED *** added a template to create a new contrib and is associated script * scripts/TODO: updated to reflect altest changes 2013-01-30 Gregory Soyez * scripts/switch-to-version.sh: * scripts/update-contribs.sh: if the versions agree, still run svn up * scripts/internal/common.sh: make sure the full contrib name is specified * scripts/update-contribs.sh: when updating a specified contrib, ask for confirmation * scripts/switch-to-version.sh: - use svn switch --relocate since svn relocate is not available with old svn version - give a write access when checking out the trunk * scripts/make-release.sh: gave access to check_pending_modifications * data/ *** ADDED *** added common event files for make check purpose * configure: *** ADDED *** * Makefile.in: *** ADDED *** added basic building mechanism * scripts/update-contribs.sh: allowed to run it with a contrib name and optional version This is then equivalent to calling switch-to-version.sh * scripts/update-contribs.sh: added "Template" to the list of ignored directories * scripts/* *** ADDED *** * README *** ADDED *** added a list of maintenance scripts (see README for details) * contribs.svn *** ADDED *** added an (empty) list of supported contribs