Polyphony GIT Repository README

git://github.com/adamfranco/polyphony.git is the official Polyphony GIT repository, maintained by Adam Franco.
Please note: This repository location is temporary while we wait for a more permanent server to be set up (in July, 2008). A posting will be made to the Harmoni project news (RSS) at the time of that move.

Subsequent to Harmoni 1.2.0/Polyphony/1.1.0, we have ceased using the SourceForge CVS for source-code management and are now using GIT. You can clone this repository to access the full development history of Polyphony.

Working with this repository

For more information on installing and using GIT, please refer to the GIT manual.

These examples assume you are putting your source-code in your public_html directory (~/public_html/) to make it web-accessible. If you are putting it elsewhere, use that other path instead.

Getting your copy of Polyphony

  1. Polyphony needs Harmoni, so clone the Harmoni repository:
    cd ~/public_html/
    git-clone git://github.com/adamfranco/harmoni.git harmoni
  2. Clone the Polyphony repository:
    cd ~/public_html/
    git-clone git://github.com/adamfranco/polyphony.git polyphony
  3. Polyphony requires several 3rd-party libraries. These can be downloaded from the libraries directory or from their original distributers.
    cd ~/public_html/
    wget http://community.middlebury.edu/~afranco/git/libraries/domit.zip
    unzip domit.zip
    rm domit.zip
    cd ~/public_html/
    wget http://community.middlebury.edu/~afranco/git/libraries/PHP_JPEG_Metadata_Toolkit_1.11.zip
    unzip PHP_JPEG_Metadata_Toolkit_1.11.zip
    rm PHP_JPEG_Metadata_Toolkit_1.11.zip
    cd ~/public_html/polyphony/javascript/
    wget http://community.middlebury.edu/~afranco/git/libraries/fckeditor.zip
    unzip fckeditor.zip
    rm fckeditor.zip
  4. Polyphony requires the Archive/Tar PEAR library. If this is not installed on your machine you will need to install it (probably as root).
    pecl install Archive_Tar

Updating your copy of Polyphony

  1. Fetch and merge changes for Harmoni:
    cd ~/public_html/harmoni
    git-pull
  2. Fetch and merge changes for Polyphony:
    cd ~/public_html/polyphony
    git-pull

Submitting patches

See also: Submitting patches GIT documentation

  1. Prepare the patch. This will create a series of files named something like 0001-First-line-of-commit-message.patch:
    cd ~/public_html/polyphony
    git-format-patch
  2. Email the patches to afranco@middlebury.edu
  3. If the patches are accepted, they will be available through this repository when a git-pull is done.

More about Harmoni/Polyphony