User`s manual

12 DATA FILES
12.9 Profiles
Profile files (extension .prf) can be used to store configuration settings used by XCSoar. The
format is a simple text file containing <label>=<value> pairs. Certain values are text strings
delimited by double quotes, for example:
PilotName="Baron Richtoffen"
All other values are numeric, including ones that represent boolean values (true= 1, false= 0).
All values that have physical dimensions are expressed in SI units (meters, meters/second, sec-
onds etc).
When a profile file is saved, it contains all configuration settings. Profile files may be edited with
a text editor to produce a smaller set of configuration settings that can be given to other pilots to
load.
When a profile file is loaded, only the settings present in that file overwrite the configuration settings
in XCSoar; all other settings are unaffected.
The default profile file is generated automatically when configuration settings are changed or when
the program exits; this has the file name xcsoar-registry.prf.
The easiest way to create a new profile is to copy a previous one, such as the default profile. Copy
the file, give it a logical name, and then when XCSoar starts next time the new profile can be
selected and customised through the configuration settings dialogs.
12.10 Checklist
The checklist file (xcsoar-checklist.txt) uses a similar format to the airfield details file. Each
page in the checklist is preceded by the name of the list in square brackets. Multiple pages can be
defined (up to 20).
An example (extract):
[Preflight]
Controls
Harness, secure objects
Airbrakes and flaps
Outside
Trim and ballast
Instruments
Canopy
[Derigging]
Remove tape from wings and tail
...
12.11 Tasks
Task files (extension .tsk) are currently in a special binary format and cannot be easily edited
other than in XCSoar or XCSoarPC. However they are transferable between devices.
Work is under way to produce a text format that will make it easier for users to edit the files or to
export/import them for use with other programs.
XCSoar Manual (Altair version) • XCSoar-A-EN 118