FlightGear configuration via XML: Difference between revisions

m
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 10: Line 10:


== defaults.xml and autosave.xml ==
== defaults.xml and autosave.xml ==
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.
FlightGear installs with a configuration already set up in a XML file, {{Base Package Filename|filename=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>defaults.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 {{Base Package Filename|filename=preferences.xml}} 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 defaults.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 {{Base Package Filename|filename=preferences.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 26: Line 26:
=== defaults.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.
{{Base Package Filename|filename=preferences.xml}} 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.


=== autosave.xml ===
=== autosave.xml ===