Doxygen output can be found at: http://hallaweb.jlab.org/parity/prex/japan/Doxygen/html. This will get updated from time to time.
You can also generated your own locally (with your latest changes) by installing doxygen on your system (from the root directory of this code) and running:
doxygen Doxyfile
To get the repository from a remote you "clone" -> once you have the repository you "pull" to get changes from the remote repository locally -> to change branches locally you "checkout" to the other branch -> you "commit" your changes to the local repository -> you propagate your local commits to the remote repository by a "push"
Use this if you plan to do work and want to propagate changes to the repository for others to see:
git clone git@github.com:JeffersonLab/japan-MOLLER
Are you getting an error? Do you need access to the repository? Contact cipriangal, paulmking or kpaschke.
Alternately just get a copy that you just want to run (without making changes to the repository):
git clone https://github.com/JeffersonLab/japan-MOLLER
Prerequisites: boost, root
mkdir build; cd build
cmake ../
make
Compiles on linux machines but has issues on Macs (see JeffersonLab/japan#2).
If you want to use XCode on mac use:
mkdir buildXcode
cd buildXcode
cmake -G Xcode ../
An example command to generate a mock-data file would be:
build/qwmockdatagenerator -r 4 -e 1:20000 --config qwparity_simple.conf --detectors mock_newdets.map --data .
The command to analyze that mock-data file and produce a root file is:
build/qwparity -r 4 --config qwparity_simple.conf --detectors mock_newdets.map --data-handler mock_datahandlers.map --data . --rootfiles .
The parameter files are searched for within the Parity/prminputs directory.
Before starting work make sure you have the latest changes from the remote repository:
git pull
Create a branch (see https://git-scm.com/book/en/v2/Git-Branching-Basic-Branching-and-Merging for more details on branching) for the issue/improvement you are trying to add:
git checkout -b issueName
You are now in new branch named "issueName". If you want others to see your work make sure you setup tracking of this branch on the remote repository:
git push -u origin issueName
Modfiy any file you need. For the modified files:
git add folder/modifiedFile.hh
git commit -m "Message for this commit"
At this point your code is tracked and committed on the local repository. To make changes available to others:
git push
To have your name properly tracked when committing (so that we know who is responsible for changes) please utilize the "author" tag
git commit --author=username