faq.html

---
title: Frequently Asked Questions
layout: default
active: faq
permalink: /faq/
---

<div class="jumbotron">
  <div class="container">
    <h1>FAQ <small>&ndash; frequently asked questions</small></h1>
  </div>
</div>

<div class="container">
  <div class="row">
    <div class="col-lg-12">
      <h2>Where can I report a bug?</h2>
      <p>Please use our <a href="https://github.com/Cevelop/Issues" target="_blank">GitHub Issue Tracker</a> to report bugs and feature requests <i class="fa fa-bug"></i>.</p>
      <h2>Does Cevelop support 32-bit platforms?</h2>
      <p>No. As of version 1.11.1, Cevelop is a 64-bit-only application.
        This is because the underlying Eclipse Platform dropped 32-bit support.</p>
      <h2>Cevelop does not start</h2>
      <p>This is usually caused by an outdated Java version or because it is a 32-bit version of Java. Cevelop requires 64-bit Java 8 to run.<br/>Here are some links to get you started:</p>
      <ul>
        <li><a href="https://oliverdowling.com.au/2015/10/09/oracles-jre-8-on-mac-os-x-el-capitan/" target="_blank">Installing Java 8 on OS X El Capitan</a></li>
        <li><a href="https://askubuntu.com/a/464894" target="_blank">Installing Java 8 on Ubuntu</a></li>
      </ul>
      <h2>How is &laquo;Cevelop&raquo; pronounced?</h2>
      <p>We pronounce it as &laquo;see-vel-op&raquo;, just like &laquo;see-plus-plus&raquo;.</p>
      <h2>Under what license is Cevelop released?</h2>
      <p>See our <a href="/license">license</a> page.</p>
      <h2>I can't use Cevelop due to its license. Do you offer commercial support or licensing?</h2>
      <p>Please <a href="/contact">contact us</a> with your requirements. We might find an agreement. Financial support is always appreciated, but we can't yet accept micropayments.</p>
      <h2>Is Cevelop Open Source?</h2>
      <p>Major parts of Cevelop are Open Source as Eclipse CDT to which we actively contribute, especially in the area of the <span style="color:red;">C++</span> parser and refactoring infrastructure. </p>
      <p>However, many of the Cevelop-specific extensions have been created with Swiss tax payer's money and we are obliged to make revenue within our university to sustain our workforce.
          Funding can result in more and better features of Cevelop and other tools we develop.
          No funding might mean that we can not sustain it, and we do not want vendors selling Eclipse CDT-based IDEs to benefit from our work, without even recognizing it was done by us.
          However, with financial compensation we are happy to provide corresponding licenses and support, as long as we can continue to use Cevelop for our students.
          Please <a href="/contact">contact us</a>.</p>
      <h2>I have installed MinGW but Cevelop does not detect it</h2>
      <p>Cevelop is based on the Eclipse <span style="color:red;">C/C++</span> Development Tools, which handles the detection of the toolchain. If you've installed MinGW and Cevelop doesn't find it, please <a href="https://wiki.eclipse.org/CDT/User/FAQ#I_installed_MinGW_toolchain_on_my_PC_but_Eclipse_won.27t_find_it" target="_blank">see the Eclipse FAQ</a>.</p>
      <h2>Cevelop cannot resolve my included headers</h2>
      <p>One of the trickiest tasks to get right when setting up a project in Cevelop is the include paths. <a href="https://www.eclipse.org/community/eclipse_newsletter/2013/october/article4.php" target="_blank">This Eclipse newsletter discusses the several options and configuration dialogs.</a></p>
      <h2 id="suppression">How can I suppress false-positive code-analysis messages?</h2>
      <p>To suppress a message, you can add a line comment that specifies the message to suppress. For example:</p>
      <pre>char* name = "Cevelop"; // @suppress("Use std::string instead of C-Strings.")</pre>
      <p>In the future, we plan to have a quick-fix that adds the correct suppression message for you, but at the moment, you'll need to look it up in the preferences:</p>
      <img class="img-responsive" src="../img/code-analysis-suppression.png"/>
      <p>The name of the problem is used in the suppression comment. You can also deactive an analysis completely to silence it. <em>Customize Selected...</em> gives you further configuration options for the analysis. For example, you can change the suppression pattern.</p>
      <img class="img-responsive" src="../img/code-analysis-suppression-pattern.png"/>
      <h2>Can I go back to GTK2?</h2>
      <p>You can edit the <code>cevelop.sh</code> script to force Cevelop to use GTK2.</p>
      <h2>How can I include boost headers into my project?</h2>
      <p>To include boost headers you first have to download the newest header files from the official <a href="https://www.boost.org/users/download/" target="_blank">boost homepage</a> and unpack them to the location of your choice. In Cevelop, right-click on your project and choose <i>Properties</i>. In <i>C/C++ General</i> &rarr; <i>Paths and Symbols</i> you can include the boost directory as follows:</p>
      <img class="img-responsive" src="../img/boost_preferences_new.png"/>
      <p>Click <i>Apply</i> and close the dialogue. You are now able to include boost headers in your project files. Note that this does not only work for boost, but any header files you would like to include in your project.</p>
      <h2>How can I increase the heap size available to Cevelop?</h2>
      <p>If you are working on large projects using Cevelop, you may need to increase the maximum Java heap size in order to avoid Out-of-Memory exceptions.
        You can increase this size by changing the following line in the <code>cevelop.ini</code> file:</p>
        <pre>-Xmx2048m</pre>
        <p>For example, if you want to increase the maximum Java heap size from the default of 2048MB to twice that size, you can change this line to 
        <code>-Xmx4096m</code>. On Windows and Linux the <code>cevelop.ini</code> file is located at the root of the Cevelop folder and on macOS it can be found in the <code>Cevelop.app/Contents/Eclipse</code> folder.</p>
      <h2>How can I import my existing CMake project to Cevelop?</h2>
      <p>CMake is currently not natively supported by Cevelop. There are multiple ways to import your CMake projects into Cevelop. Please follow one of the following guides.</p>
      <p>Using <code>cmake</code> <i>inside</i> the source directory:</p>
      <ol>
        <li>Run <code>cmake</code> inside your projects root directory and pass <code>-G"Unix Makefiles"</code> as an additional option.</li>
	<li>Open Cevelop and <i>Import...</i> the project as an <i>C/C++ &rarr; Existing Code as Makefile Project</i>. Note that the <i>Toolchain for Indexer Settings</i> option has no influence over which compiler will be used, so select one of the available toolchains (Example: <i>Linux GCC</i> on Linux).</li>
      </ol>
      <p>Using <code>cmake</code> <i>outside</i> of the source directory:</p>
      <ol>
        <li>Run <code>cmake</code> in a folder outside of your projects source directory and pass <code>-G"Eclipse CDT4 - Unix Makefiles"</code> and <code>-DCMAKE_CXX_FLAGS "-std=c++XX"</code> to the command. Replace the <code>XX</code> with the standard you wish to use. This ensures that the indexer knows the correct C++ Standard version for your project.</li>
	<li>Open Cevelop and <i>Import...</i> the project as <i>General &rarr; Existing Projects into Workspace</i> and select the folder you've run <code>cmake</code> in as the root directory.</li>
      </ol>
      <p>After either of these steps the project can be run and built directly from inside Cevelop.</p>
      <h2>How can I link a static library?</h2>
      <p>There are two ways you can do this in Cevelop. If the library is a separate Cevelop project in the same workspace, you can do the following:</p>
      <ol>
        <li>Open the properties of the executable project.</li>
        <li>Go to C/C++ General &rarr; Paths and Symbols &rarr; References</li>
        <li>Add a reference to the library project. This will automatically set the library path, header path, etc.</li>
      </ol>
      <p>The end result should look like this:</p>
      <img class="img-responsive" src="../img/link_static_library1.png"/>
      <p>If you instead want to add the library and its header files directly to the executable project, you can do that as well. However, this means that you need to manually specify the library path, library name, etc:</p>
      <ol>
        <li>Open the properties of the executable project.</li>
        <li>Go to C/C++ General &rarr; Paths and Symbols &rarr; Library Paths and add the path to the library <b>as a workspace path.</b></li>
        <img class="img-responsive" src="../img/link_static_library2.png"/>
        <li>Go to C/C++ General &rarr; Paths and Symbols &rarr; Libraries and add the name of the library (without the <b>lib</b> prefix and the <b>.a</b> file extension).</li>
        <img class="img-responsive" src="../img/link_static_library3.png"/>
      </ol>
    </div>
  </div>
</div>