Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
1 result
Blame Permalink
Forked from Utils / KWSys
694 commits behind the upstream repository.
After you've reviewed these contribution guidelines, you'll be all set to contribute to this project.
CONTRIBUTING.rst 1.73 KiB

Contributing to KWSys

Patches

KWSys is kept in its own Git repository and shared by several projects via copies in their source trees. Changes to KWSys should not be made directly in a host project, except perhaps in maintenance branches.

KWSys uses Kitware's GitLab Instance to manage development and code review. To contribute patches:

  1. Fork the upstream KWSys Repository into a personal account.
  2. Base all new work on the upstream master branch.
  3. Run ./SetupForDevelopment.sh in new local work trees.
  4. Create commits making incremental, distinct, logically complete changes.
  5. Push a topic branch to a personal repository fork on GitLab.
  6. Create a GitLab Merge Request targeting the upstream master branch.

Once changes are reviewed, tested, and integrated to KWSys upstream then copies of KWSys within dependent projects can be updated to get the changes.

Code Style

We use clang-format to define our style for C++ code in the KWSys source tree. See the .clang-format configuration file for our style settings. Use clang-format version 3.8 or higher to format source files. See also the clang-format.bash script.

License

We do not require any formal copyright assignment or contributor license agreement. Any contributions intentionally sent upstream are presumed to be offered under terms of the OSI-approved BSD 3-clause License. See Copyright.txt for details.