Suggested development workflow

1. Fork your own copy of amdovx-modules to your account

Public can access your repository from http://github.com/USER/amdovx-modules where USER is your GitHub username.

See GitHub help for more details.

2. Setup your development environment

2.1 Install dependencies

CMake 2.8 or newer
OpenCL SDK
OpenCV 3 SDK (optional)

2.2 Setup local copy of your personal repository

% cd ~/work
% git clone --recursive -b develop http://github.com/USER/amdovx-modules
% cd amdovx-modules
% git remote add GPUOpen http://github.com/GPUOpen-ProfessionalCompute-Libraries/amdovx-modules
% git fetch --all
% git checkout -b develop-GPUOpen --track GPUOpen/develop
% git pull
% git checkout develop
% git pull

2.3 Make sure you can build

% cd ~/work
% mkdir build
% cd build
% cmake -DCMAKE_BUILD_TYPE=Release ../amdovx-modules
% make
% ls -l bin
... all the binaries will be in ~/work/build/bin folder ...

3. Start the development work

3.1 Sync personal repository and create a new branch before making any local changes

% cd ~/work/amdovx-modules
% git fetch --all
% git checkout develop-GPUOpen
% git pull
% git checkout develop
% git pull
% git merge develop-GPUOpen
% git push
% git checkout -b your-name-initials/new-branch-name

Here is an example of new branch name: rg/stitching-examples

3.2 Make source code changes, build, and unit test

% cd ~/work/amdovx-modules
% ... edit source files ...
% cd ~/work/build
% make
% ... unit test using binaries in ~/work/build/bin folder ...

3.3 Review your source code changes before commit

% cd ~/work/amdovx-modules
% git status
... review changes and make sure that only files that you intended to change are listed ...
% git diff
... review every change to source code files ...
% git add list-of-file(s)
% git status
... review changes again and make sure that only files that you intended to change are listed ...
% git commit -m "describe your changes"
% git push
... this will push local commits into your personal repository on github ...

3.4 Create a pull request to GPUOpen-ProfessionalCompute-Libraries/amdovx-modules

select base fork as GPUOpen-ProfessionalCompute-Libraries/amdovx-modules
select base branch as develop
select head fork as USER/amdovx-modules
select compare branch as your-name-initials/new-branch-name
type in the title and comment
scroll down and review all code change once more
scroll up and click Create pull request button to submit the pull request