Skip to content
Snippets Groups Projects
Forked from Utils / KWSys
322 commits behind the upstream repository.
  • Brad King's avatar
    6b9c233c
    clang-format.bash: update to clang-format-6.0 · 6b9c233c
    Brad King authored
    Update `.clang-format` with configuration to make the 6.0 format as
    close as possible to what 3.8 produced before.  Then revise the style:
    
    * Indent preprocessor directives (a feature new since 3.8)
    * Add a newline and indentation before inheritance `:` and `,`
    6b9c233c
    History
    clang-format.bash: update to clang-format-6.0
    Brad King authored
    Update `.clang-format` with configuration to make the 6.0 format as
    close as possible to what 3.8 produced before.  Then revise the style:
    
    * Indent preprocessor directives (a feature new since 3.8)
    * Add a newline and indentation before inheritance `:` and `,`
After you've reviewed these contribution guidelines, you'll be all set to contribute to this project.
CONTRIBUTING.rst 1.90 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 version 6.0 to define our style for C++ code in the KWSys source tree. See the .clang-format configuration file for our style settings. Use the clang-format.bash script to format source code. It automatically runs clang-format on the set of source files for which we enforce style. The script also has options to format only a subset of files, such as those that are locally modified.

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.