FlightGear configuration via XML: Difference between revisions

m
→‎preferences.xml and autosave.xml: outdated, this was changed by core devs without updating any of the docs accordingly ... we should probably introduce a template to manage such things in the future ?
No edit summary
m (→‎preferences.xml and autosave.xml: outdated, this was changed by core devs without updating any of the docs accordingly ... we should probably introduce a template to manage such things in the future ?)
Line 9: Line 9:
Next to using graphical launchers like [[FGRun]] or [[FGx]] or parsing console commands to FlightGear's binary, FlightGear's configuration can also be set by means of two .xml files.
Next to using graphical launchers like [[FGRun]] or [[FGx]] or parsing console commands to FlightGear's binary, FlightGear's configuration can also be set by means of two .xml files.


== preferences.xml and autosave.xml ==
== defaults.xml and autosave.xml ==
FlightGear installs with a configuration already set up in a XML file, <code>preferences.xml</code>.  Some of these settings are preserved between FlightGear sessions in another file, <code>autosave.xml</code>.  All settings contained in these two files get parsed by FlightGear while it starts up.
FlightGear installs with a configuration already set up in a XML file, <code>defaults.xml</code> (previously, preferences.xml).  Some of these settings are preserved between FlightGear sessions in another file, <code>autosave.xml</code>.  All settings contained in these two files get parsed by FlightGear while it starts up.


Some of the properties in <code>preferences.xml</code> have an XML attribute, <code>userarchive</code>, that automatically add any changes of those properties to <code>autosave.xml</code>.
Some of the properties in <code>defaults.xml</code> have an XML attribute, <code>userarchive</code>, that automatically add any changes of those properties to <code>autosave.xml</code>.


we should absolutely stop telling anyone to edit preferences.xml in FG_ROOT; any documentation or advice which says to should be changes ASAP. <ref>{{cite web
we should absolutely stop telling anyone to edit defaults.xml in FG_ROOT; any documentation or advice which says to should be changes ASAP. <ref>{{cite web
   |url    =  https://forum.flightgear.org/viewtopic.php?p=192632#p192632  
   |url    =  https://forum.flightgear.org/viewtopic.php?p=192632#p192632  
   |title  =  <nowiki> Re: NavCache:init failed:Sqlite error:Sqlite API abuse </nowiki>  
   |title  =  <nowiki> Re: NavCache:init failed:Sqlite error:Sqlite API abuse </nowiki>  
Line 24: Line 24:




=== preferences.xml ===
=== defaults.xml ===
{{Main article|defaults.xml}}
{{Main article|defaults.xml}}
<code>preferences.xml</code> is FlightGear's main configuration file and is located within [[$FG_ROOT]].  Using the [[PropertyList XML files|property-list]] format it sets up a large number of [[Property tree|properties]] and their values that determines various settings of FlightGear.  It more or less contain all settings that can be set.  All settings contained within this file get parsed by FlightGear while it starts up.
<code>preferences.xml</code> is FlightGear's main configuration file and is located within [[$FG_ROOT]].  Using the [[PropertyList XML files|property-list]] format it sets up a large number of [[Property tree|properties]] and their values that determines various settings of FlightGear.  It more or less contain all settings that can be set.  All settings contained within this file get parsed by FlightGear while it starts up.