speed-dreams-code/doc/website/index.html
pouillot 2a81a5c280 Torcs => Torcs-NG
git-svn-id: https://svn.code.sf.net/p/speed-dreams/code/trunk@88 30fe4595-0a0c-4342-8851-515496e4dcbd

Former-commit-id: cbe5bd35ede4be376d20ba1b14fba5289a065827
Former-commit-id: 4d6ea7dc617f0ef5ab96280273468122e078b671
2008-10-25 14:14:31 +00:00

204 lines
No EOL
8.6 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Torcs-NG : The Open Racing Car Simulator - Next Generation</title>
<meta http-equiv="CONTENT-TYPE" content="text/html; charset=utf-8"><meta name="GENERATOR" content="OpenOffice.org 2.2 (Linux)"><meta name="CREATED" content="20080922;22021200"><meta name="CHANGED" content="20081005;16540800"><style type="text/css">
<!--
@page { size: 21cm 29.7cm; margin: 2cm }
P { margin-bottom: 0.21cm }
--> </style></head>
<body>
<a href="http://sourceforge.net"></a><a href="http://sourceforge.net">
</a>
<p style="margin-bottom: 0cm; font-weight: bold; text-align: center;"><big><big><span style="font-style: italic; color: red;">Work in progress ... soon the complete version</span></big></big></p><p style="margin-bottom: 0cm; font-weight: bold;"><big><big></big></big></p><p style="margin-bottom: 0cm; font-weight: bold;"><big><big>Welcome
to Torcs-NG, the Torcs
laboratory !</big></big></p>
<p style="margin-bottom: 0cm;"></p>
<p style="margin-bottom: 0cm;">Torcs-NG is a fork of <a href="http://www.torcs.org">The famous Open
Racing Car Simulator "Torcs"</a>, but it does not any pretend
to replace it. It's main goal is simply to host <span style="font-weight: bold;">experimental</span>
developpements inside Torcs, while trying to follow as closely as
possible its release and evolution stream ...</p>
<p style="margin-bottom: 0cm;">In other words,
Torcs-NG is the place :</p>
<ul>
<li>
<p style="margin-bottom: 0cm;">where developpers can
try their ideas and have efery chance to get them released to the
end-users (<span style="font-weight: bold;">democracy</span>
is the main principle ruling the dev team),</p>
</li>
<li>
<p style="margin-bottom: 0cm;">where end-users can
enjoy the completion of these ideas and give their opinion about it,
and/or make new suggestions.</p>
<p style="margin-bottom: 0cm;"></p>
</li>
</ul>
<p style="margin-bottom: 0cm;">So, if you find your or
some people's
Torcs patch proposals don't integrate the official release as quickly
as you would have loved, you have reached the right place !</p>
<p style="margin-bottom: 0cm;"></p>
<hr style="width: 100%; height: 2px;">
<p style="margin-bottom: 0cm;"></p>
<p style="margin-bottom: 0cm;"><big><big style="font-weight: bold;">How to contribute</big></big><br>
</p>
<p style="margin-bottom: 0cm;">You can contribute to
Torcs-NG as an
"end-user" or/and as a "developper" :</p>
<ul>
<li>
<p style="margin-bottom: 0cm;">as an end-user (check <a href="http://sourceforge.net/project/showfiles.php?group_id=239111">the
Download page in SF.net</a> for how to get source / binary
releases) :</p>
<ul>
<li>
<p style="margin-bottom: 0cm;">help the dev team
to test pre-releases,</p>
</li>
<li>
<p style="margin-bottom: 0cm;">suggest
improvements, express your support or disgust about changes,</p>
</li>
<li>
<p style="margin-bottom: 0cm;">ask questions about
compilation / build from source problems,</p>
</li>
<li>
<p style="margin-bottom: 0cm;">...</p>
</li>
</ul>
</li>
</ul>
<p style="margin-bottom: 0cm;"> all through the user
mailing list
: <a href="mailto:torcs-ng-users@lists.sourceforge.net">torcs-ng-users@lists.sourceforge.net</a></p>
<ul>
<li value="1">
<p style="margin-bottom: 0cm;">as a developper (see <a href="http://sourceforge.net/svn/?group_id=239111">the Code
menu in SF.net</a> for how to get the source tree from the
Subversion repository) :</p>
<ul>
<li>
<p style="margin-bottom: 0cm;">as guest
contributor, you may propose your adds/improvements as <span style="font-weight: bold;">patches</span> (patch files
built via diff -Naur or equivalent) against the latest source tree, and
send them to us as attached files through the devel mailing list (<a href="mailto:torcs-ng-devel@lists.sourceforge.net">torcs-ng-devel@lists.sourceforge.net</a>)
or the <a href="http://sourceforge.net/tracker/?group_id=239111">tracker</a>
; you don't have write access yet to the SVN repository, but it's up to
you to prove us your skills and innovation ability as a programmer, a
software architect, an artist, ... as well as your self-discipline in
testing ;-) ... and that way, you may enter step by step in the dev.
team ...</p>
</li>
<li>
<p style="margin-bottom: 0cm;">as a registered
developper, you now have write access to the SVN repository ; but the
preferred way for submitting adds/improvements is still the patch, as
it can be easily tested and reviewed by anyone whatever the status of
its working copy of the source tree ; once the dev. team, through
discussions, peer reviews and tests, has democratically decided to
integrate the patch, you can at last commit your changes to the
repository !</p>
</li>
</ul>
</li>
</ul>
<p style="margin-bottom: 0cm;"><br>
</p>
<p style="margin-bottom: 0cm;">Your contribution to
Torcs-NG may take
place in many domains :</p>
<ul>
<li value="1">
<p style="margin-bottom: 0cm;">the core code itself,
and its numerous subjects : user interface, physics engine, 3D graphics
engine, race managment, input device related code, file formats, ... to
enhance, optimize, make more up-to-date, fix bugs, port to another
platform ... </p>
</li>
<li>
<p style="margin-bottom: 0cm;">the robot(s) code (AI
racing),</p>
</li>
<li>
<p style="margin-bottom: 0cm;">the cars design or
tuning,</p>
</li>
<li>
<p style="margin-bottom: 0cm;">the tracks design,</p>
</li>
<li>
<p style="margin-bottom: 0cm;">the documentation,</p>
</li>
<li>
<p style="margin-bottom: 0cm;">the web site (there's
still some work ;-),</p>
</li>
<li>
<p style="margin-bottom: 0cm;">... feel free to
suggest ...</p>
</li>
</ul>
<p style="margin-bottom: 0cm;"></p>
<hr style="width: 100%; height: 2px;">
<p style="margin-bottom: 0cm;"><br>
</p>
<p style="margin-bottom: 0cm; font-weight: bold;"><big><big>Torcs-NG
release process</big></big></p>
<p style="margin-bottom: 0cm;"><br>
</p>
<p style="margin-bottom: 0cm;">Torcs-NG will generally
follow Torcs
release stream : a new release, with the same identifier (ex: 1.3.1),
will normally be published in the weeks after each Torcs release. It
will contain the whole Torcs release, plus the whole bunch of adds we
maintain. But
other intermediate releases could also be published if improvements
commited to the trunk since last one would justify it, and of course
if Torcs wouldn't have issued a new release meanwhile.</p>
<p style="margin-bottom: 0cm;">As already said, the
content of each
release will be <span style="font-weight: bold;">democratically</span>
decided inside the dev. team.
Stability and bug freeness is not our first purpose, but it's just
the second one : modifications that are not really completed, well
tested or that may degrade the simulation realism, some other
essential feature or performance, or the end-user gaming experience
won't be released (unless they are of great interest and can be
completly switched off through some run-time user action).</p>
<p style="margin-bottom: 0cm;">For the moment, the
supported platforms are Linux (x86, x86_64) and 32 bit Windows XP, but
&nbsp;any volunteer is welcome for any other ... as Torcs is known
to work on&nbsp;Linux PPC, FreeBSD, MacOSX and Windows Vista.</p><p style="margin-bottom: 0cm;"></p>
<hr style="width: 100%; height: 2px;">
<p style="margin-bottom: 0cm; font-weight: bold;"><big><big>Links</big></big></p>
<br>
<a href="http://www.torcs.org">Torcs : The Open
Racing Car Simulator</a>&nbsp;and <a href="http://sourceforge.net/projects/torcs">its project
page at SF.net</a><br>
<br>
<a href="mailto:torcs-ng-devel@lists.sourceforge.net">Torcs-NG
developpers mailing list</a> and its <a href="http://sourceforge.net/mailarchive/forum.php?forum_name=torcs-ng-devel">archives</a><br>
<br>
<a href="mailto:torcs-ng-users@lists.sourceforge.net">Torcs-NG
users mailing list</a> and its <a href="http://sourceforge.net/mailarchive/forum.php?forum_name=torcs-ng-users">archives</a><br>
<br>
<a href="http://sourceforge.net/svn/?group_id=239111">Torcs-NG
SVN repository HOW-TO</a> and <a href="http://torcs-ng.svn.sourceforge.net">on-line browser</a><br>
<br>
<a href="http://torcs-ng.svn.sourceforge.net/viewvc/torcs-ng/trunk">Build
and install Torcs-NG</a> (look at README.* and INSTALL.* files)<br><br>
<hr style="width: 100%; height: 2px;"><br><table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"><tbody><tr><td style="text-align: right;"><a href="http://sourceforge.net/">
<img src="http://sflogo.sourceforge.net/sflogo.php?group_id=239111&amp;type=7" alt="SourceForge.net Logo" border="0" height="62" width="210"></a><a href="http://sourceforge.net/">
</a></td></tr></tbody></table>
<a href="http://sourceforge.net">
&nbsp;</a><br>
<p style="margin-bottom: 0cm;"></p>
</body></html>