/usr/share/doc/gpsbabel/htmldoc/inifile.html is in gpsbabel-doc 1.4.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<!-- InstanceBegin template="/Templates/primarypage.dwt" codeOutsideHTMLisLocked="false" -->
<title>Working with predefined options</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="GPSBabel Documentation" /><link rel="up" href="Usage.html" title="Chapter 2. Usage" /><link rel="prev" href="Route_And_Track_Modes.html" title="Route and Track Modes" /><link rel="next" href="tracking.html" title="Realtime tracking" /></head><body>
<!-- InstanceBeginEditable name="scontent" --><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Working with predefined options</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="Route_And_Track_Modes.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Usage</th><td width="20%" align="right"> <a accesskey="n" href="tracking.html">Next</a></td></tr></table><hr /></div><div class="sect1" title="Working with predefined options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="inifile"></a>Working with predefined options</h2></div></div></div><p>
GPSBabel can read a file on startup to set defaults for options. All
module and filter options may be set this way.
</p><p>
The format of the file is identical to the inifile-format often seen
on Windows. Here is an example:
</p><table border="0" summary="Simple list" class="simplelist"><tr><td>[Common format settings]</td></tr><tr><td>snupper=Y</td></tr><tr><td>snlen=10</td></tr><tr><td>[gpx]</td></tr><tr><td>gpxver=1.1</td></tr><tr><td>[magellan]</td></tr><tr><td>baud=115200</td></tr><tr><td>[tiger]</td></tr><tr><td>[Garmin categories]</td></tr><tr><td>; any # from 1 to 16</td></tr><tr><td>1=fixed waypoints</td></tr><tr><td>2=temporary waypoints</td></tr></table><p>
Each section of the file starts with a '[section]' header followed by any
number of lines formatted option=value. Leading and trailing whitespace
will be
automatically removed from header, option and value items.
Lines starting
with '#' or ';' will be treated as comments and ignored.
</p><p>
There are three optional sections.
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Common format settings.</p><p> Any option from any of the formats listed here will be used by
GPSBabel unless explictly provided on the command line.
</p></li><li class="listitem"><p>Common filter settings.</p><p>As above, but for filters.</p></li><li class="listitem"><p>Garmin categories</p><p>This allows you to give readable names to the numeric categories
used internally in some Garmin devices and the Mapsource formats
such as GDB and MPS. This is information is also used by our GPX
and garmin_txt formats as well.</p></li></ul></div><p>
</p><p>
By default, GPSBabel tries at startup to load the file named
<code class="filename">gpsbabel.ini</code> from the following locations:
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>current working directory</p></li><li class="listitem"><p>Windows: all paths "APPDATA", "WINDIR", "SYSTEMROOT" declared in environment.</p></li><li class="listitem"><p>Unix like OS'ses: <code class="filename">${HOME}/.gpsbabel/</code>, <code class="filename">/usr/local/etc/</code> and <code class="filename">/etc/</code></p></li></ul></div><p>
If the <code class="option">-p</code> option is specified, the above locations are not searched.
Only the filename specified by that option will be used.
</p><p>
There may be situations where predefined values are not useable
(i.e. wrapper applications using GPSBabel in the background).
The inifile mechanism can be disabled with an empty filename.
</p><p><strong class="userinput"><code>gpsbabel -p "" -i gpx -f something.gpx -o tiger -F -</code></strong></p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Route_And_Track_Modes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Usage.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="tracking.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Route and Track Modes </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Realtime tracking</td></tr></table></div>
<!-- InstanceEndEditable -->
<!-- InstanceEnd -->
</body></html>
|