cling/www/contribute.html

<html>
<head>
  <title>Cling</title>
  <script data-main="scripts/cling" src="scripts/require.js"></script>
  <link rel="stylesheet" href="style/import.css">
</head>
<body onload="selectMenu('contribute')">
  <iframe seamless src="header.html" class="header" id="iheader"></iframe>
    <div id="breadcrumb"></div>
    <div id="content">
      <div id="main">
        <!-- insert the page content here -->
        <h3> Collaborate With Us </h3>
<p>
Every contribution is considered a donation and its copyright and any other
related rights become exclusive ownership of the person who merged the code or
in any other case the main developers of the "Cling Project".

We warmly welcome external contributions to the Cling! By providing code,
you agree to transfer your copyright on the code to the "Cling project".
Of course you will be duly credited and your name will appear on the
contributors page, the release notes, and in the
<a href= "https://raw.githubusercontent.com/root-project/cling/master/CREDITS.txt" target = "_blank">CREDITS</a>
shipped with every binary and source distribution. The copyright transfer is
necessary for us to be able to effectively defend the project in case of
litigation.
</p>
<p>
  You can send us a patch or a pull request with <a href="https://github.com/root-project/cling" target = "_blank">Github</a>, provided that you follow these two simple rules:</p>
<ul>
  <li>
    Make sure you follow the Cling coding conventions in your code.
  </li>
  <li>
    Make sure you provide a set of tests for your feature/bug fix.
   </li>
</ul>
<p>
Often it is useful to contact us first to discuss the code you want to develop or the bug you want to fix.

</p>

<h3> Picking up an Idea </h3>

We maintain a set of "ideas" for talented scientists and developers to pick up. An "idea" can be a sketch of a development project, a functionality, a missing feature we would like to see in our tool.
A list that we propose is the following:

Ideas

<ul>
  <li>
  Extending and improving the multiline input mode - The multiline mode has to figure out automatically whether the user's input is still incomplete. For example "if (a &lt; 0) {" is not fully completed input. Cling should'n try to process the line but to be smart enough to understand that it should wait for continuation. Currently cling switches multiline mode only when there is trailing "{". It has to be extended to detect trailing +, unbalanced '," and so on.
</li>
<li>
  Implementing error recovery verifier - One of the most important parts in cling is the error recovery. The error recovery takes care of reverting clang's internal structures on error in the user input. For instance, user types int i; error_here;. int i should be reverted and the entire input should be invalidated. This is very complex because many implicit template instantiations could be triggered and so on. The idea of the future verifier is to serialize the AST with all the lookup structures (probably in pch or pcm), trigger an error causing a lot of things to happen in clang internally and serialize the new AST. The comparison with the old one must return perfect match.
</li>
<li>
  Enabling clang's static analyzer - coming soon
</li>  
<li>
  Enabling ObjectiveC/ObjectiveC++ support - coming soon
</li>
</ul>

      </div>
    </div>
  <iframe seamless class="footer" src="footer.html"></iframe>
</body>
</html>
New website information for cling. 2016-02-23 20:16:10 +03:00			`<html>`
			`<head>`
Use import + iframe to simulate a CMS. 2016-07-20 16:35:07 +03:00			`<title>Cling</title>`
Use more traditional approach, not <import>. 2016-07-21 20:00:12 +03:00			`<script data-main="scripts/cling" src="scripts/require.js"></script>`
			`<link rel="stylesheet" href="style/import.css">`
New website information for cling. 2016-02-23 20:16:10 +03:00			`</head>`
Use import + iframe to simulate a CMS. 2016-07-20 16:35:07 +03:00			`<body onload="selectMenu('contribute')">`
			`<iframe seamless src="header.html" class="header" id="iheader"></iframe>`
New website information for cling. 2016-02-23 20:16:10 +03:00			`<div id="breadcrumb"></div>`
			`<div id="content">`
			`<div id="main">`
			`<!-- insert the page content here -->`
First iterations comments/suggestions. 2016-02-25 17:46:30 +03:00			`<h3> Collaborate With Us </h3>`
New website information for cling. 2016-02-23 20:16:10 +03:00			`<p>`
Clarify external contribution conditions. 2016-08-07 19:45:08 +03:00			`Every contribution is considered a donation and its copyright and any other`
			`related rights become exclusive ownership of the person who merged the code or`
			`in any other case the main developers of the "Cling Project".`

			`We warmly welcome external contributions to the Cling! By providing code,`
			`you agree to transfer your copyright on the code to the "Cling project".`
			`Of course you will be duly credited and your name will appear on the`
			`contributors page, the release notes, and in the`
Reflect changed Github repo name. 2017-04-05 12:31:39 +03:00			`<a href= "https://raw.githubusercontent.com/root-project/cling/master/CREDITS.txt" target = "_blank">CREDITS</a>`
Clarify external contribution conditions. 2016-08-07 19:45:08 +03:00			`shipped with every binary and source distribution. The copyright transfer is`
			`necessary for us to be able to effectively defend the project in case of`
			`litigation.`
New website information for cling. 2016-02-23 20:16:10 +03:00			`</p>`
			`<p>`
Reflect changed Github repo name. 2017-04-05 12:31:39 +03:00			`You can send us a patch or a pull request with <a href="https://github.com/root-project/cling" target = "_blank">Github</a>, provided that you follow these two simple rules:</p>`
First iterations comments/suggestions. 2016-02-25 17:46:30 +03:00			`<ul>`
			`<li>`
			`Make sure you follow the Cling coding conventions in your code.`
			`</li>`
			`<li>`
			`Make sure you provide a set of tests for your feature/bug fix.`
			`</li>`
			`</ul>`
Syntax. 2016-07-20 17:22:18 +03:00			`<p>`
New website information for cling. 2016-02-23 20:16:10 +03:00			`Often it is useful to contact us first to discuss the code you want to develop or the bug you want to fix.`

			`</p>`

			`<h3> Picking up an Idea </h3>`

			`We maintain a set of "ideas" for talented scientists and developers to pick up. An "idea" can be a sketch of a development project, a functionality, a missing feature we would like to see in our tool.`
			`A list that we propose is the following:`

			`Ideas`

			`<ul>`
			`<li>`
Syntax. 2016-07-20 17:22:18 +03:00			`Extending and improving the multiline input mode - The multiline mode has to figure out automatically whether the user's input is still incomplete. For example "if (a < 0) {" is not fully completed input. Cling should'n try to process the line but to be smart enough to understand that it should wait for continuation. Currently cling switches multiline mode only when there is trailing "{". It has to be extended to detect trailing +, unbalanced '," and so on.`
New website information for cling. 2016-02-23 20:16:10 +03:00			`</li>`
			`<li>`
			Implementing error recovery verifier - One of the most important parts in cling is the error recovery. The error recovery takes care of reverting clang's internal structures on error in the user input. For instance, user types int i; error_here;. int i should be reverted and the entire input should be invalidated. This is very complex because many implicit template instantiations could be triggered and so on. The idea of the future verifier is to serialize the AST with all the lookup structures (probably in pch or pcm), trigger an error causing a lot of things to happen in clang internally and serialize the new AST. The comparison with the old one must return perfect match.
			`</li>`
			`<li>`
			`Enabling clang's static analyzer - coming soon`
			`</li>`
			`<li>`
			`Enabling ObjectiveC/ObjectiveC++ support - coming soon`
			`</li>`
			`</ul>`

			`</div>`
			`</div>`
Add missing footer class. 2016-07-20 18:16:21 +03:00			`<iframe seamless class="footer" src="footer.html"></iframe>`
New website information for cling. 2016-02-23 20:16:10 +03:00			`</body>`
			`</html>`