/usr/share/doc/colobot/html/index.html is in colobot-dev-doc 0.1.11-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Colobot: Main Page</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Colobot
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
</div><!-- top -->
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="headertitle">
<div class="title">Colobot Documentation</div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Doxygen documentation of Colobot: Gold Edition project.</p>
<p><b>Colobot</b> <em>(COLOnize with BOTs)</em> is a game combining elements of real time strategy (RTS) and educational game, aiming to teach programming through entertainment. You are playing as an astronaut on a journey with robot helpers to find a planet for colonization. It features a C++ and Java-like, object-oriented language, CBOT, which can be used to program the robots available in the game.</p>
<p>The original version of the game was developed by <a href="http://www.epsitec.ch/">Epsitec</a> and released in 2001. Later, in 2005 another version named Ceebot was released. In March 2012, through attempts by Polish Colobot fans, Epsitec agreeed to release the source code of the game on GPLv3 license. The license was given specfifically to our community, <b>TerranovaTeam</b>, part of <b>International Colobot Community (ICC)</b> (previously known as <em>Polish Portal of Colobot (PPC)</em>; Polish: <em>Polski Portal Colobota</em>) with our website at <a href="http://colobot.info/">http://colobot.info/</a>.</p>
<h1><a class="anchor" id="Intro"></a>
Introduction</h1>
<p>The source code released by Epitec was sparsely documented. This documentation, written from scratch, will aim to describe the various components of the code.</p>
<p>Currently, the only documented classes are the ones written from scratch or the old ones rewritten to match the new code. In time, the documentation will be extended to cover every major part of the code.</p>
<h1><a class="anchor" id="Structure"></a>
Code structure</h1>
<p>The source code was split from the original all-in-one directory to subdirectories, each containing one major part of the project. The current layout is the following:</p><ul>
<li>src/CBot - separate library with <a class="el" href="namespace_c_bot.html" title="CBot engine. ">CBot</a> language</li>
<li>src/app - class <a class="el" href="class_c_application.html" title="Main application. ">CApplication</a> and everything concerned with SDL</li>
<li>src/common - shared structs, enums, defines, etc.; should not have any external dependencies</li>
<li>src/common/resources - filesystem management using PHYSFS library</li>
<li>src/common/system - system-dependent code such as displaying a message box, finding files, etc.</li>
<li>src/common/thread - wrapper classes for SDL threads</li>
<li>src/graphics/core - abstract interface of graphics device (abstract CDevice class)</li>
<li>src/graphics/engine - main graphics engine based on abstract graphics device; is composed of CEngine class and associated classes implementing the 3D engine</li>
<li>src/graphics/model - code related to loading/saving model files</li>
<li>src/graphics/opengl - concrete implementation of CDevice class in OpenGL: CGLDevice</li>
<li>src/graphics/d3d - in (far) future - perhaps a newer implementation in DirectX (9? 10?)</li>
<li>src/math - mathematical structures and functions</li>
<li>src/object - non-grphical game object logic, that is robots, buildings, etc.</li>
<li>src/level - main part of non-graphical game engine, that is loading levels etc.</li>
<li>src/level/parser - parser for loading/saving level files from format known as <em>scene files</em></li>
<li>src/ui - 2D user interface (menu, buttons, check boxes, etc.)</li>
<li>src/sound - sound and music engine written using fmod library</li>
<li>src/physics - physics engine</li>
<li>src/script - link with the <a class="el" href="namespace_c_bot.html" title="CBot engine. ">CBot</a> library </li>
</ul>
</div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>
|