X-Git-Url: http://demsky.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FDeveloperPolicy.html;h=ef7ba39397c69b4f84a49f30120cb568e5ee88a2;hb=294e67861c9a497f4b7529a410d8817d36354d5a;hp=e5e7b12b5f8703a6db55be9bf21af95eee1e8d34;hpb=7d8012b602ee3456072bf61a10574d8753990eac;p=oota-llvm.git diff --git a/docs/DeveloperPolicy.html b/docs/DeveloperPolicy.html index e5e7b12b5f8..ef7ba39397c 100644 --- a/docs/DeveloperPolicy.html +++ b/docs/DeveloperPolicy.html @@ -2,6 +2,7 @@ "http://www.w3.org/TR/html4/strict.dtd"> + LLVM Developer Policy @@ -15,6 +16,7 @@
  • Stay Informed
  • Making a Patch
  • Code Reviews
  • +
  • Code Owners
  • Test Cases
  • Quality
  • Obtaining Commit Access
  • @@ -27,7 +29,6 @@
  • Copyright
  • License
  • Patents
  • -
  • Developer Agreements
  • Written by the LLVM Oversight Team
    @@ -36,189 +37,284 @@
    Introduction
    -

    This document contains the LLVM Developer Policy which defines the - project's policy towards developers and their contributions. The intent of - this policy is to eliminate mis-communication, rework, and confusion that - might arise from the distributed nature of LLVM's development. By stating - the policy in clear terms, we hope each developer can know ahead of time - what to expect when making LLVM contributions.

    -

    This policy is also designed to accomplish the following objectives:

    -
      -
    1. Attract both users and developers to the LLVM project.
    2. -
    3. Make life as simple and easy for contributors as possible.
    4. -
    5. Keep the top of tree CVS/SVN trees as stable as possible.
    6. -
    - -

    This policy is aimed at frequent contributors to LLVM. People interested in - contributing one-off patches can do so in an informal way by sending them to - the - llvm-commits mailing list and engaging another developer to see it through - the process.

    +

    This document contains the LLVM Developer Policy which defines the project's + policy towards developers and their contributions. The intent of this policy + is to eliminate miscommunication, rework, and confusion that might arise from + the distributed nature of LLVM's development. By stating the policy in clear + terms, we hope each developer can know ahead of time what to expect when + making LLVM contributions. This policy covers all llvm.org subprojects, + including Clang, LLDB, etc.

    +

    This policy is also designed to accomplish the following objectives:

    + +
      +
    1. Attract both users and developers to the LLVM project.
    2. + +
    3. Make life as simple and easy for contributors as possible.
    4. + +
    5. Keep the top of Subversion trees as stable as possible.
    6. +
    +

    This policy is aimed at frequent contributors to LLVM. People interested in + contributing one-off patches can do so in an informal way by sending them to + the + llvm-commits + mailing list and engaging another developer to see it through the + process.

    Developer Policies
    -

    This section contains policies that pertain to frequent LLVM - developers. We always welcome one-off patches from - people who do not routinely contribute to LLVM, but we expect more from - frequent contributors to keep the system as efficient as possible for - everyone. - Frequent LLVM contributors are expected to meet the following requirements in - order for LLVM to maintain a high standard of quality.

    +

    This section contains policies that pertain to frequent LLVM developers. We + always welcome one-off patches from people who do not + routinely contribute to LLVM, but we expect more from frequent contributors + to keep the system as efficient as possible for everyone. Frequent LLVM + contributors are expected to meet the following requirements in order for + LLVM to maintain a high standard of quality.

    Stay Informed
    -

    Developers should stay informed by reading at least the - llvmdev - email list. If you are doing anything more than just casual work on LLVM, - it is suggested that you also subscribe to the - llvm-commits - list and pay attention to changes being made by others.

    -

    We recommend that active developers register an email account with - LLVM Bugzilla and preferably subscribe to - the llvm-bugs - email list to keep track of bugs and enhancements occurring in LLVM.

    +

    Developers should stay informed by reading at least the "dev" mailing list + for the projects you are interested in, such as + llvmdev for + LLVM, cfe-dev + for Clang, or lldb-dev + for LLDB. If you are doing anything more than just casual work on LLVM, it + is suggested that you also subscribe to the "commits" mailing list for the + subproject you're interested in, such as + llvm-commits, + cfe-commits, + or lldb-commits. + Reading the "commits" list and paying attention to changes being made by + others is a good way to see what other people are interested in and watching + the flow of the project as a whole.

    + +

    We recommend that active developers register an email account with + LLVM Bugzilla and preferably subscribe to + the llvm-bugs + email list to keep track of bugs and enhancements occurring in LLVM. We + really appreciate people who are proactive at catching incoming bugs in their + components and dealing with them promptly.

    Making a Patch
    -

    When making a patch for review, the goal is to make it as easy for the reviewer to read it as possible. As such, we recommend that you:

    -
      -
    1. Make your patch against the CVS HEAD (main development trunk), - not a branch, and not an old version of LLVM. This makes it easy to - apply the patch.
    2. - -
    3. Similarly, patches should be submitted soon after they are generated. - Old patches may not apply correctly if the underlying code changes between - the time the patch was created and the time it is applied.
    4. + +
        +
      1. Make your patch against the Subversion trunk, not a branch, and not an old + version of LLVM. This makes it easy to apply the patch. For information + on how to check out SVN trunk, please see the Getting Started Guide.
      2. -
      3. Patches should be made with this command: -
        cvs diff -Ntdup -5
        - or with the utility utils/mkpatch, which makes it easy to read the - diff.
      4. - -
      5. Patches should not include differences in generated code such as the - code generated by flex, bison or tblgen. The - utils/mkpatch utility takes care of this for you.
      6. - -
      +
    5. Similarly, patches should be submitted soon after they are generated. Old + patches may not apply correctly if the underlying code changes between the + time the patch was created and the time it is applied.
    6. + +
    7. Patches should be made with svn diff, or similar. If you use + a different tool, make sure it uses the diff -u format and + that it doesn't contain clutter which makes it hard to read.
    8. + +
    9. If you are modifying generated files, such as the top-level + configure script, please separate out those changes into + a separate patch from the rest of your changes.
    10. +
    -

    When sending a patch to a mailing list, it is a good idea to send it as an - attachment to the message, not embedded into the text of the - message. This ensures that your mailer will not mangle the patch when it - sends it (e.g. by making whitespace changes or by wrapping lines).

    +

    When sending a patch to a mailing list, it is a good idea to send it as an + attachment to the message, not embedded into the text of the + message. This ensures that your mailer will not mangle the patch when it + sends it (e.g. by making whitespace changes or by wrapping lines).

    + +

    For Thunderbird users: Before submitting a patch, please open + Preferences → Advanced → General → Config Editor, + find the key mail.content_disposition_type, and set its value to + 1. Without this setting, Thunderbird sends your attachment using + Content-Disposition: inline rather than Content-Disposition: + attachment. Apple Mail gamely displays such a file inline, making it + difficult to work with for reviewers using that program.

    Code Reviews
    -

    LLVM has a code review policy. Code review is one way to increase the - quality of software. We generally follow these policies:

    -
      -
    1. All developers are required to have significant changes reviewed - before they are committed to the repository.
    2. -
    3. Code reviews are conducted by email, usually on the llvm-commits - list.
    4. -
    5. Code can be reviewed either before it is committed or after. We expect - major changes to be reviewed before being committed, but smaller - changes (or changes where the developer owns the component) can be - reviewed after commit.
    6. -
    7. The developer responsible for a code change is also responsible for - making all necessary review-related changes.
    8. -
    9. Code review can be an iterative process, which continues until the patch - is ready to be committed.
    10. -
    +

    LLVM has a code review policy. Code review is one way to increase the quality + of software. We generally follow these policies:

    + +
      +
    1. All developers are required to have significant changes reviewed before + they are committed to the repository.
    2. + +
    3. Code reviews are conducted by email, usually on the llvm-commits + list.
    4. + +
    5. Code can be reviewed either before it is committed or after. We expect + major changes to be reviewed before being committed, but smaller changes + (or changes where the developer owns the component) can be reviewed after + commit.
    6. + +
    7. The developer responsible for a code change is also responsible for making + all necessary review-related changes.
    8. + +
    9. Code review can be an iterative process, which continues until the patch + is ready to be committed.
    10. +
    + +

    Developers should participate in code reviews as both reviewers and + reviewees. If someone is kind enough to review your code, you should return + the favor for someone else. Note that anyone is welcome to review and give + feedback on a patch, but only people with Subversion write access can approve + it.

    +
    + + +
    Code Owners
    +
    + +

    The LLVM Project relies on two features of its process to maintain rapid + development in addition to the high quality of its source base: the + combination of code review plus post-commit review for trusted maintainers. + Having both is a great way for the project to take advantage of the fact that + most people do the right thing most of the time, and only commit patches + without pre-commit review when they are confident they are right.

    + +

    The trick to this is that the project has to guarantee that all patches that + are committed are reviewed after they go in: you don't want everyone to + assume someone else will review it, allowing the patch to go unreviewed. To + solve this problem, we have a notion of an 'owner' for a piece of the code. + The sole responsibility of a code owner is to ensure that a commit to their + area of the code is appropriately reviewed, either by themself or by someone + else. The current code owners are:

    -

    Developers should participate in code reviews as both reviewers and - reviewees. If someone is kind enough to review your code, you should - return the favor for someone else. Note that anyone is welcome to review - and give feedback on a patch, but only people with CVS write access can - approve it.

    +
      +
    1. Evan Cheng: Code generator and all targets.
    2. + +
    3. Greg Clayton: LLDB.
    4. + +
    5. Doug Gregor: Clang Frontend Libraries.
    6. + +
    7. Howard Hinnant: libc++.
    8. +
    9. Anton Korobeynikov: Exception handling, debug information, and + Windows codegen.
    10. + +
    11. Ted Kremenek: Clang Static Analyzer.
    12. + +
    13. Chris Lattner: Everything not covered by someone else.
    14. + +
    15. Duncan Sands: llvm-gcc 4.2.
    16. +
    + +

    Note that code ownership is completely different than reviewers: anyone can + review a piece of code, and we welcome code review from anyone who is + interested. Code owners are the "last line of defense" to guarantee that all + patches that are committed are actually reviewed.

    + +

    Being a code owner is a somewhat unglamorous position, but it is incredibly + important for the ongoing success of the project. Because people get busy, + interests change, and unexpected things happen, code ownership is purely + opt-in, and anyone can choose to resign their "title" at any time. For now, + we do not have an official policy on how one gets elected to be a code + owner.

    Test Cases
    -

    Developers are required to create test cases for any bugs fixed and any new - features added. Some tips for getting your testcase approved:

    -
      -
    1. All feature and regression test cases are added to the - llvm/test directory. The appropriate sub-directory should be - selected (see the Testing Guide for - details).
    2. -
    3. Test cases should be written in - LLVM assembly language unless the - feature or regression being tested requires another language (e.g. the - bug being fixed or feature being implemented is in the llvm-gcc C++ - front-end, in which case it must be written in C++).
    4. -
    5. Test cases, especially for regressions, should be reduced as much as - possible, by bugpoint or - manually. It is unacceptable - to place an entire failing program into llvm/test as this creates - a time-to-test burden on all developers. Please keep them short.
    6. -
    +

    Developers are required to create test cases for any bugs fixed and any new + features added. Some tips for getting your testcase approved:

    + +
      +
    1. All feature and regression test cases are added to the + llvm/test directory. The appropriate sub-directory should be + selected (see the Testing Guide for + details).
    2. + +
    3. Test cases should be written in LLVM assembly + language unless the feature or regression being tested requires + another language (e.g. the bug being fixed or feature being implemented is + in the llvm-gcc C++ front-end, in which case it must be written in + C++).
    4. + +
    5. Test cases, especially for regressions, should be reduced as much as + possible, by bugpoint or manually. It is + unacceptable to place an entire failing program into llvm/test as + this creates a time-to-test burden on all developers. Please keep + them short.
    6. +
    -

    Note that llvm/test is designed for regression and small feature tests - only. More extensive test cases (e.g., entire applications, benchmarks, - etc) should be added to the llvm-test test suite. The llvm-test - suite is for coverage (correctness, performance, etc) testing, not feature - or regression testing.

    +

    Note that llvm/test and clang/test are designed for regression and small + feature tests only. More extensive test cases (e.g., entire applications, + benchmarks, etc) + should be added to the llvm-test test suite. The llvm-test suite is + for coverage (correctness, performance, etc) testing, not feature or + regression testing.

    Quality
    -

    The minimum quality standards that any change must satisfy before being - committed to the main development branch are:

    -
      -
    1. Code must adhere to the - LLVM Coding Standards.
    2. -
    3. Code must compile cleanly (no errors, no warnings) on at least one - platform.
    4. -
    5. Bug fixes and new features should include a - testcase so we know if the fix/feature ever regresses in the - future.
    6. -
    7. Code must pass the dejagnu (llvm/test) test suite.
    8. -
    9. The code must not cause regressions on a reasonable subset of llvm-test, - where "reasonable" depends on the contributor's judgement and the scope - of the change (more invasive changes require more testing). A reasonable - subset is "llvm-test/MultiSource/Benchmarks".
    10. -
    -

    Additionally, the committer is responsible for addressing any problems - found in the future that the change is responsible for. For example:

    - +

    The minimum quality standards that any change must satisfy before being + committed to the main development branch are:

    + +
      +
    1. Code must adhere to the LLVM Coding + Standards.
    2. + +
    3. Code must compile cleanly (no errors, no warnings) on at least one + platform.
    4. + +
    5. Bug fixes and new features should include a + testcase so we know if the fix/feature ever regresses in the + future.
    6. + +
    7. Code must pass the llvm/test test suite.
    8. + +
    9. The code must not cause regressions on a reasonable subset of llvm-test, + where "reasonable" depends on the contributor's judgement and the scope of + the change (more invasive changes require more testing). A reasonable + subset might be something like + "llvm-test/MultiSource/Benchmarks".
    10. +
    + +

    Additionally, the committer is responsible for addressing any problems found + in the future that the change is responsible for. For example:

    + + -

    We prefer for this to be handled before submission but understand that it - isn't possible to test all of this for every submission. Our nightly - testing - infrastructure normally finds these problems. A good rule of thumb is to - check the nightly testers for regressions the day after your change.

    - -

    Commits that violate these quality standards (e.g. are very broken) may - be reverted. This is necessary when the change blocks other developers from - making progress. The developer is welcome to re-commit the change after - the problem has been fixed.

    +

    We prefer for this to be handled before submission but understand that it + isn't possible to test all of this for every submission. Our build bots and + nightly testing infrastructure normally finds these problems. A good rule of + thumb is to check the nightly testers for regressions the day after your + change. Build bots will directly email you if a group of commits that + included yours caused a failure. You are expected to check the build bot + messages to see if they are your fault and, if so, fix the breakage.

    + +

    Commits that violate these quality standards (e.g. are very broken) may be + reverted. This is necessary when the change blocks other developers from + making progress. The developer is welcome to re-commit the change after the + problem has been fixed.

    @@ -226,156 +322,169 @@ Obtaining Commit Access
    -

    -We grant commit access to contributors with a track record of submitting high -quality patches. If you would like commit access, please send an email to the -LLVM oversight group.

    +

    We grant commit access to contributors with a track record of submitting high + quality patches. If you would like commit access, please send an email to + Chris with the following + information:

    + +
      +
    1. The user name you want to commit with, e.g. "hacker".
    2. + +
    3. The full name and email address you want message to llvm-commits to come + from, e.g. "J. Random Hacker <hacker@yoyodyne.com>".
    4. + +
    5. A "password hash" of the password you want to use, e.g. "2ACR96qjUqsyM". + Note that you don't ever tell us what your password is, you just give it + to us in an encrypted form. To get this, run "htpasswd" (a utility that + comes with apache) in crypt mode (often enabled with "-d"), or find a web + page that will do it for you.
    6. +
    + +

    Once you've been granted commit access, you should be able to check out an + LLVM tree with an SVN URL of "https://username@llvm.org/..." instead of the + normal anonymous URL of "http://llvm.org/...". The first time you commit + you'll have to type in your password. Note that you may get a warning from + SVN about an untrusted key, you can ignore this. To verify that your commit + access works, please do a test commit (e.g. change a comment or add a blank + line). Your first commit to a repository may require the autogenerated email + to be approved by a mailing list. This is normal, and will be done when + the mailing list owner has time.

    If you have recently been granted commit access, these policies apply:

    +
      -
    1. You are granted commit-after-approval to all parts of LLVM. - To get approval, submit a patch to - - llvm-commits. When approved you may commit it yourself.
    2. +
    3. You are granted commit-after-approval to all parts of LLVM. To get + approval, submit a patch to + llvm-commits. + When approved you may commit it yourself.
    4. +
    5. You are allowed to commit patches without approval which you think are - obvious. This is clearly a subjective decision — we simply expect you - to use good judgement. Examples include: fixing build breakage, reverting - obviously broken patches, documentation/comment changes, any other minor - changes.
    6. -
    7. You are allowed to commit patches without approval to those portions - of LLVM that you have contributed or maintain (i.e., have been assigned - responsibility for), with the proviso that such commits must not break the - build. This is a "trust but verify" policy and commits of this nature are - reviewed after they are committed.
    8. -
    9. Multiple violations of these policies or a single egregious violation - may cause commit access to be revoked.
    10. + obvious. This is clearly a subjective decision — we simply expect + you to use good judgement. Examples include: fixing build breakage, + reverting obviously broken patches, documentation/comment changes, any + other minor changes. + +
    11. You are allowed to commit patches without approval to those portions of + LLVM that you have contributed or maintain (i.e., have been assigned + responsibility for), with the proviso that such commits must not break the + build. This is a "trust but verify" policy and commits of this nature are + reviewed after they are committed.
    12. + +
    13. Multiple violations of these policies or a single egregious violation may + cause commit access to be revoked.

    In any case, your changes are still subject to code -review (either before or after they are committed, depending on the nature -of the change). You are encouraged to review other peoples' patches as well, -but your aren't required to.

    - + review (either before or after they are committed, depending on the + nature of the change). You are encouraged to review other peoples' patches + as well, but you aren't required to.

    Making a Major Change
    -

    When a developer begins a major new project with the aim of contributing - it back to LLVM, s/he should inform the community with an email to - the llvmdev - email list, to the extent possible. The reason for this is to: -

      -
    1. keep the community informed about future changes to LLVM,
    2. -
    3. avoid duplication of effort by preventing multiple parties working on - the same thing and not knowing about it, and
    4. -
    5. ensure that any technical issues around the proposed work are - discussed and resolved before any significant work is done.
    6. -
    +

    When a developer begins a major new project with the aim of contributing it + back to LLVM, s/he should inform the community with an email to + the llvmdev + email list, to the extent possible. The reason for this is to: + +

      +
    1. keep the community informed about future changes to LLVM,
    2. + +
    3. avoid duplication of effort by preventing multiple parties working on the + same thing and not knowing about it, and
    4. + +
    5. ensure that any technical issues around the proposed work are discussed + and resolved before any significant work is done.
    6. +
    -

    The design of LLVM is carefully controlled to ensure that all the pieces - fit together well and are as consistent as possible. If you plan to make a - major change to the way LLVM works or want to add a major new extension, it - is a good idea to get consensus with the development - community before you start working on it.

    +

    The design of LLVM is carefully controlled to ensure that all the pieces fit + together well and are as consistent as possible. If you plan to make a major + change to the way LLVM works or want to add a major new extension, it is a + good idea to get consensus with the development community before you start + working on it.

    -

    Once the design of the new feature is finalized, the work itself should be - done as a series of incremental changes, not as - a long-term development branch.

    - +

    Once the design of the new feature is finalized, the work itself should be + done as a series of incremental changes, not as a + long-term development branch.

    Incremental Development
    -

    In the LLVM project, we do all significant changes as a series of - incremental patches. We have a strong dislike for huge changes or - long-term development branches. Long-term development branches have a - number of drawbacks:

    - -
      -
    1. Branches must have mainline merged into them periodically. If the branch - development and mainline development occur in the same pieces of code, - resolving merge conflicts can take a lot of time.
    2. -
    3. Other people in the community tend to ignore work on branches.
    4. -
    5. Huge changes (produced when a branch is merged back onto mainline) are - extremely difficult to code review.
    6. -
    7. Branches are not routinely tested by our nightly tester - infrastructure.
    8. -
    9. Changes developed as monolithic large changes often don't work until the - entire set of changes is done. Breaking it down into a set of smaller - changes increases the odds that any of the work will be committed to the - main repository.
    10. -
    - -

    - To address these problems, LLVM uses an incremental development style and we - require contributors to follow this practice when making a large/invasive - change. Some tips:

    +

    In the LLVM project, we do all significant changes as a series of incremental + patches. We have a strong dislike for huge changes or long-term development + branches. Long-term development branches have a number of drawbacks:

    + +
      +
    1. Branches must have mainline merged into them periodically. If the branch + development and mainline development occur in the same pieces of code, + resolving merge conflicts can take a lot of time.
    2. + +
    3. Other people in the community tend to ignore work on branches.
    4. + +
    5. Huge changes (produced when a branch is merged back onto mainline) are + extremely difficult to code review.
    6. + +
    7. Branches are not routinely tested by our nightly tester + infrastructure.
    8. + +
    9. Changes developed as monolithic large changes often don't work until the + entire set of changes is done. Breaking it down into a set of smaller + changes increases the odds that any of the work will be committed to the + main repository.
    10. +
    - -

    If you are interested in making a large change, and this scares you, please - make sure to first discuss the change/gather - consensus then ask about the best way to go about making - the change.

    +

    If you are interested in making a large change, and this scares you, please + make sure to first discuss the change/gather consensus + then ask about the best way to go about making the change.

    Attribution of Changes
    -

    We believe in correct attribution of contributions to - their contributors. However, we do not want the source code to be littered - with random attributions (this is noisy/distracting and revision control - keeps a perfect history of this anyway). As such, we follow these rules:

    -
      -
    1. Developers who originate new files in LLVM should place their name at - the top of the file per the - Coding Standards.
    2. -
    3. There should be only one name at the top of the file and it should be - the person who created the file.
    4. -
    5. Placing your name in the file does not imply copyright: it is only used to attribute the file to - its original author.
    6. -
    7. Developers should be aware that after some time has passed, the name at - the top of a file may become meaningless as maintenance/ownership of files - changes. Despite this, once set, the attribution of a file never changes. - Revision control keeps an accurate history of contributions.
    8. -
    9. Developers should maintain their entry in the - CREDITS.txt - file to summarize their contributions.
    10. -
    11. Commit comments should contain correct attribution of the person who - submitted the patch if that person is not the committer (i.e. when a - developer with commit privileges commits a patch for someone else).
    12. -
    -
    - +

    We believe in correct attribution of contributions to their contributors. + However, we do not want the source code to be littered with random + attributions "this code written by J. Random Hacker" (this is noisy and + distracting). In practice, the revision control system keeps a perfect + history of who changed what, and the CREDITS.txt file describes higher-level + contributions. If you commit a patch for someone else, please say "patch + contributed by J. Random Hacker!" in the commit message.

    +

    Overall, please do not add contributor names to the source code.

    +
    @@ -384,118 +493,122 @@ Changes
    -

    This section addresses the issues of copyright, license and patents for - the LLVM project. - Currently, the University of Illinois is the LLVM copyright holder and the - terms of its license to LLVM users and developers is the - University of - Illinois/NCSA Open Source License.

    +

    This section addresses the issues of copyright, license and patents for the + LLVM project. Currently, the University of Illinois is the LLVM copyright + holder and the terms of its license to LLVM users and developers is the + University of + Illinois/NCSA Open Source License.

    -

    NOTE: This section deals with legal matters but does not provide - legal advice. We are not lawyers, please seek legal counsel from an - attorney.

    +

    NOTE: This section deals with + legal matters but does not provide legal advice. We are not lawyers, please + seek legal counsel from an attorney.

    Copyright
    -

    -

    For consistency and ease of management, the project requires the - copyright for all LLVM software to be held by a single copyright holder: - the University of Illinois (UIUC).

    - -

    - Although UIUC may eventually reassign the copyright of the software to another - entity (e.g. a dedicated non-profit "LLVM Organization", or something) - the intent for the project is to always have a single entity hold the - copyrights to LLVM at any given time.

    - -

    We believe that having a single copyright - holder is in the best interests of all developers and users as it greatly - reduces the managerial burden for any kind of administrative or technical - decisions about LLVM. The goal of the LLVM project is to always keep the code - open and licensed under a very liberal license.

    + +

    The LLVM project does not require copyright assignments, which means that the + copyright for the code in the project is held by its respective contributors + who have each agreed to release their contributed code under the terms of the + LLVM License.

    + +

    An implication of this is that the LLVM license is unlikely to ever change: + changing it would require tracking down all the contributors to LLVM and + getting them to agree that a license change is acceptable for their + contribution. Since there are no plans to change the license, this is not a + cause for concern.

    + +

    As a contributor to the project, this means that you (or your company) retain + ownership of the code you contribute, that it cannot be used in a way that + contradicts the license (which is a liberal BSD-style license), and that the + license for your contributions won't change without your approval in the + future.

    +
    License
    -

    We intend to keep LLVM perpetually open source - and to use a liberal open source license. The current license is the - - University of Illinois/NCSA Open Source License, which boils - down to this:

    - - -

    We believe this fosters the widest adoption of LLVM because it allows - commercial products to be derived from LLVM with few restrictions and - without a requirement for making any derived works also open source (i.e. - LLVM's license is not a "copyleft" license like the GPL). We suggest that you - read the License - if further clarification is needed.

    - -

    Note that the LLVM Project does distribute llvm-gcc, which is GPL. - This means that anything "linked" into llvm-gcc must itself be compatible - with the GPL, and must be releasable under the terms of the GPL. This implies - that any code linked into llvm-gcc and distributed to others may be subject - to the viral aspects of the GPL (for example, a proprietary code generator - linked into llvm-gcc must be made available under - the GPL). This is not a problem for the main LLVM - distribution (which is already licensed under a more liberal license), but may - be a problem if you intend to base commercial development on llvm-gcc without - redistributing your source code.

    +

    We intend to keep LLVM perpetually open source and to use a liberal open + source license. All of the code in LLVM is available under the + University of + Illinois/NCSA Open Source License, which boils down to this:

    + + -

    We have no plans to change the license of LLVM. If you have questions - or comments about the license, please contact the LLVM Oversight Group.

    +

    We believe this fosters the widest adoption of LLVM because it allows + commercial products to be derived from LLVM with few restrictions and + without a requirement for making any derived works also open source (i.e. + LLVM's license is not a "copyleft" license like the GPL). We suggest that you + read the License + if further clarification is needed.

    + +

    In addition to the UIUC license, the runtime library components of LLVM + (compiler_rt and libc++) are also licensed under the MIT license, + which does not contain the binary redistribution clause. As a user of these + runtime libraries, it means that you can choose to use the code under either + license (and thus don't need the binary redistribution clause), and as a + contributor to the code that you agree that any contributions to these + libraries be licensed under both licenses. We feel that this is important + for runtime libraries, because they are implicitly linked into applications + and therefore should not subject those applications to the binary + redistribution clause. This also means that it is ok to move code from (e.g.) + libc++ to the LLVM core without concern, but that code cannot be moved from + the LLVM core to libc++ without the copyright owner's permission. +

    +

    Note that the LLVM Project does distribute llvm-gcc, which is GPL. + This means that anything "linked" into llvm-gcc must itself be compatible + with the GPL, and must be releasable under the terms of the GPL. This + implies that any code linked into llvm-gcc and distributed to others may + be subject to the viral aspects of the GPL (for example, a proprietary + code generator linked into llvm-gcc must be made available under the GPL). + This is not a problem for code already distributed under a more liberal + license (like the UIUC license), and does not affect code generated by + llvm-gcc. It may be a problem if you intend to base commercial development + on llvm-gcc without redistributing your source code.

    + +

    We have no plans to change the license of LLVM. If you have questions or + comments about the license, please contact the + LLVM Developer's Mailing List.

    Patents
    -

    To the best of our knowledge, LLVM does not infringe on any patents (we have actually removed code from LLVM in the past that was found to infringe). - Having code in LLVM that infringes on patents would violate an important - goal of the project by making it hard or impossible to reuse the code for + Having code in LLVM that infringes on patents would violate an important goal + of the project by making it hard or impossible to reuse the code for arbitrary purposes (including commercial use).

    When contributing code, we expect contributors to notify us of any potential - for patent-related trouble with their changes. If you own the rights to a - patent and would like to contribute code to LLVM that relies on it, we - require that you sign an agreement that allows any other user of LLVM to - freely use your patent. Please contact the oversight group for more + for patent-related trouble with their changes. If you or your employer own + the rights to a patent and would like to contribute code to LLVM that relies + on it, we require that the copyright owner sign an agreement that allows any + other user of LLVM to freely use your patent. Please contact + the oversight group for more details.

    - - -
    Developer Agreements
    -
    -

    With regards to the LLVM copyright and licensing, developers agree to - assign their copyrights to UIUC for any contribution made so that - the entire software base can be managed by a single copyright holder. This - implies that any contributions can be licensed under the license that the - project uses.

    -
    -
    Valid CSS! + src="http://jigsaw.w3.org/css-validator/images/vcss-blue" alt="Valid CSS"> Valid HTML 4.01! + src="http://www.w3.org/Icons/valid-html401-blue" alt="Valid HTML 4.01"> Written by the LLVM Oversight Group
    The LLVM Compiler Infrastructure