Difference between revisions of "FlightGear Git"

From FlightGear wiki
Jump to: navigation, search
(Spelling fix; remove Downloading fgdata using bittorrent (it belongs on the FlightGear Git: data developers page and it's outdated))
m (Repositories and branches: link to section instead of whole changelog)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{Git}}
 
{{Git}}
'''Git''' is a version control system, used by the [[FlightGear]] project to store all of the files required to build and run FlightGear. This includes all the programs, the data (e.g. textures, sounds), supporting tools, etc. Git tracks updates to every file, as developers from around the world work together concurrently to create new versions. The sole exception is the official [[FGAddon]] aircraft repository that is Subversion rather than git based.
+
'''Git''' is a {{wikipedia|version control system}} used by the [[FlightGear]] project to store all the files required to build and run the simulator. This includes all the programs, the data (e.g. textures, sounds), supporting tools, etc. Git tracks updates to every file as developers from around the world work together concurrently to create new versions. The sole exception is the official [[FGAddon]] aircraft repository that is Subversion rather than Git based.
  
 
While new FlightGear features and additions are in development, they are available from Git before they are available in the standard release version. Using Git allows users to use the newest possible version of FlightGear from the latest source files, to experiment with new aircraft or other features. However, it is not a beginner's tool. Using Git can expose the user to unstable features that show ugly error messages, or crash the computer.  
 
While new FlightGear features and additions are in development, they are available from Git before they are available in the standard release version. Using Git allows users to use the newest possible version of FlightGear from the latest source files, to experiment with new aircraft or other features. However, it is not a beginner's tool. Using Git can expose the user to unstable features that show ugly error messages, or crash the computer.  
  
As of March 2015, the Git repositories are located at [http://sourceforge.net/p/flightgear SourceForge] and a mirror is hosted at the [http://mapserver.flightgear.org/git/?p=fgdata;a=summary Mapserver].
+
As of May 2016, the repositories are located at {{Project infrastructure|name}}.
  
 
== Motivation ==
 
== Motivation ==
Line 10: Line 10:
  
 
Much has been written on the advantages of Git over CVS. For the FlightGear project, some advantages are:
 
Much has been written on the advantages of Git over CVS. For the FlightGear project, some advantages are:
* Much better support for branches and merging branches. This is especially important for creating bug-fix releases for major releases while still allowing work on the next major release to continue. It is also very nice for a developer's personal work-flow.
+
* Much better support for branches and merging branches. This is especially important for creating bug fix releases for major releases while still allowing work on the next major release to continue. It is also very nice for a developer's personal workflow.
 
* Easier path for contributors to submit changes and developers to integrate them.
 
* Easier path for contributors to submit changes and developers to integrate them.
 
* Much better support for everyday tasks like searching the project history for changes, viewing changes, bisecting the project history to find the original source of a bug.
 
* Much better support for everyday tasks like searching the project history for changes, viewing changes, bisecting the project history to find the original source of a bug.
  
 
== Repositories and branches ==
 
== Repositories and branches ==
The FlightGear project is split up in various repositories. The most important ones are listed below. Each repository contains various branches, of which one the most important ones are listed here.
+
The FlightGear project is split up in the repositories listed below.
 +
{| class="wikitable"
 +
! Name
 +
! Contents
 +
! Remarks
 +
|-
 +
| {{simgear source|text=simgear}}
 +
| [[SimGear]], the simulation engine that FlightGear uses.
 +
| rowspan="6" |
 +
Those repositories have the following branches:
 +
* ''next'': current tip of new development. This branch should always compile and run, but various things could be broken.
 +
* ''release/*'': containing former and (if a specific branch was made for them) upcoming releases.
  
* {{simgear source|text=simgear}}: the simulation engine that FlightGear uses.
+
As of [[Changelog 2016.1#Usability|May 2016]], FGRun is replaced by the [[Qt5 Launcher|Qt5 launcher]].
** ''next'': current tip of new development. This branch should always compile and run, but various things could be broken.
+
|-
** ''release/*'': containing former and ''(if there is already defined one)'' upcoming releases.
+
| {{flightgear source|text=flightgear}}
* {{flightgear source|text=flightgear}}: FlightGear itself.
+
| FlightGear itself.
** ''next'': current tip of new development. This branch should always compile and run, but various things could be broken.
+
|-
** ''release/*'': containing former and ''(if there is already defined one)'' upcoming releases.
+
| {{fgdata source|text=fgdata}}
* {{fgdata source|text=fgdata}}: all data (default aircraft, dialogs, sounds) used by FlightGear.
+
| All data (default aircraft, dialogs, sounds) used by FlightGear.
** ''next'': current branch that is used with the ''next'' branch of the code.
+
|-
** ''release/*'':  used with the ''release'' branch of the code.
+
| {{fgmeta source|text=fgmeta}}
 
+
| FlightGear "meta" repository containing build and setup scripts for the whole project.
Additionally there is a SVN repository called [[FGAddon]] that holds all additional aircraft, not present in the Git fgdata repository:
+
|-
* {{fgaddon source|text=fgaddon}}: all additional (official) aircraft.
+
| {{windows-3rd-party source|text=windows-3rd-party}}
 +
| Prebuilt libraries needed to make FlightGear run on Windows.
 +
|-
 +
| {{fgrun source|text=fgrun}}
 +
| The [[FGRun]] launcher for FlightGear.
 +
|-
 +
| {{fgaddon source|text=fgaddon}}
 +
| [[FGAddon]], an SVN repository that holds all official aircraft (except the [[Cessna 172P]] default plane and the [[UFO]]).
 +
|
 +
|-
 +
| {{fgcom source|text=fgcom}}
 +
| [[FGCom 3.0|FGCom]], a voice-over-IP application used by [[multiplayer]] controllers to provide [[Air traffic control|ATC services]].
 +
|
 +
|-
 +
| {{getstart source|text=getstart}}
 +
| Sources for the ''Getting Started'' manual included with the simulator.
 +
|
 +
|-
 +
| {{openradar source|text=openradar}}
 +
| The [[OpenRadar]] application used by multiplayer controllers.
 +
|
 +
|-
 +
| {{sceneryweb source|text=sceneryweb}}
 +
| Source code and configuration files for the [http://mapserver.flightgear.org/ Mapserver], the [https://scenery.flightgear.org/ scenery portal] and the [[TerraGear scenery build server]].
 +
|
 +
|-
 +
| {{terragear source|text=terragear}}
 +
| The [[TerraGear]] scenery building toolkit.
 +
|
 +
|-
 +
| {{terrafs source|text=terrafs}}
 +
| [[TerraFS]], a Linux tool to mount the TerraSync scenery as a remote file system.
 +
|
 +
|-
 +
| {{sourceforge source|proj=flightgear|repo=maclauncher|text=maclauncher}}
 +
| [[FlightGear_Mac_OS_X_Launcher|Old FlightGear launcher for Mac]].
 +
| Deprecated by the [[Qt5 Launcher]].
 +
|-
 +
| {{sourceforge source|proj=flightgear|repo=fgms|text=fgms}}
 +
| [[FlightGear Multiplayer Server|Multiplayer server system]]
 +
|
 +
|}
  
 
== Related content ==
 
== Related content ==
* [[FlightGear Git: splitting fgdata]], an initiative to split the aircraft out of the fgdata repository, in order to decrease its size and thus improve access to the average user/developer.
+
* [[FlightGear Git: splitting FGData]], an initiative to split the aircraft out of the FGData repository, in order to decrease its size and thus improve access to the average user/developer.
  
 
{{Building}}
 
{{Building}}

Latest revision as of 06:51, 15 May 2020

Git is a version control system This is a link to a Wikipedia article used by the FlightGear project to store all the files required to build and run the simulator. This includes all the programs, the data (e.g. textures, sounds), supporting tools, etc. Git tracks updates to every file as developers from around the world work together concurrently to create new versions. The sole exception is the official FGAddon aircraft repository that is Subversion rather than Git based.

While new FlightGear features and additions are in development, they are available from Git before they are available in the standard release version. Using Git allows users to use the newest possible version of FlightGear from the latest source files, to experiment with new aircraft or other features. However, it is not a beginner's tool. Using Git can expose the user to unstable features that show ugly error messages, or crash the computer.

As of May 2016, the repositories are located at SourceForge.

Motivation

In May 2010, after a hardware failure on the CVS servers, the FlightGear project changed its version control system from CVS to Git.

Much has been written on the advantages of Git over CVS. For the FlightGear project, some advantages are:

  • Much better support for branches and merging branches. This is especially important for creating bug fix releases for major releases while still allowing work on the next major release to continue. It is also very nice for a developer's personal workflow.
  • Easier path for contributors to submit changes and developers to integrate them.
  • Much better support for everyday tasks like searching the project history for changes, viewing changes, bisecting the project history to find the original source of a bug.

Repositories and branches

The FlightGear project is split up in the repositories listed below.

Name Contents Remarks
simgear SimGear, the simulation engine that FlightGear uses.

Those repositories have the following branches:

  • next: current tip of new development. This branch should always compile and run, but various things could be broken.
  • release/*: containing former and (if a specific branch was made for them) upcoming releases.

As of May 2016, FGRun is replaced by the Qt5 launcher.

flightgear FlightGear itself.
fgdata All data (default aircraft, dialogs, sounds) used by FlightGear.
fgmeta FlightGear "meta" repository containing build and setup scripts for the whole project.
windows-3rd-party Prebuilt libraries needed to make FlightGear run on Windows.
fgrun The FGRun launcher for FlightGear.
fgaddon FGAddon, an SVN repository that holds all official aircraft (except the Cessna 172P default plane and the UFO).
fgcom FGCom, a voice-over-IP application used by multiplayer controllers to provide ATC services.
getstart Sources for the Getting Started manual included with the simulator.
openradar The OpenRadar application used by multiplayer controllers.
sceneryweb Source code and configuration files for the Mapserver, the scenery portal and the TerraGear scenery build server.
terragear The TerraGear scenery building toolkit.
terrafs TerraFS, a Linux tool to mount the TerraSync scenery as a remote file system.
maclauncher Old FlightGear launcher for Mac. Deprecated by the Qt5 Launcher.
fgms Multiplayer server system

Related content

  • FlightGear Git: splitting FGData, an initiative to split the aircraft out of the FGData repository, in order to decrease its size and thus improve access to the average user/developer.