

  {extends file="main.tpl"}
    <!DOCTYPE head PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><head xmlns="http://www.w3.org/1999/xhtml">
  {block name=title}GPSBabel development:List of Options{/block}
  {block name=body}{literal}
                       
  <div xmlns="http://www.w3.org/1999/xhtml" class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">List of Options</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="batchfile.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Usage</th><td width="20%" align="right"> <a accesskey="n" href="The_Formats.html">Next</a></td></tr></table><hr /></div><div xmlns="http://www.w3.org/1999/xhtml" class="sect1"><div class="titlepage"><div><div><h2 class="title" ><a id="all_options"></a>List of Options</h2></div></div></div><p>
   The complete list of available options to GPSBabel can be obtained by
   running <span class="command"><strong>gpsbabel -h</strong></span>.  While there are a number of
   options, most people will not use most of them, so don't be intimidated.
  </p><p><code class="option">-p</code> Read preferences file.   On startup, GPSBabel will look for a file named <code class="filename">gpsbabel.ini</code> containing preferences you have provided.  This option lets you pick a different files.  See <a class="xref" href="inifile.html" title="Working with predefined options">the section called “Working with predefined options”</a> for more info.</p><p><code class="option">-s</code> Write "smart" names.  This option influences some - but not all - of our writers to try to build "smart" waypoint names.   For example, in modules that know about geocaching, it may replace "GC1234" with the actual name of the geocache.</p><p><code class="option">-r</code> Work on routes.  This option has a subtly different meaning in different cases.  As the very first formats in GPSBabel were for serial GPSes and routes and tracks were large and thus time-consuming to transfer, the default was waypoints only with this option to turn on the extra data.   Some of our file formats use this option to mean "work only on routes, even if you have tracks/waypoints", but we're trying to discourage that behavior and in most cases, consider it a bug. </p><p><code class="option">-t</code> Work on tracks.  See <code class="option">-r</code> for excuses. </p><p><code class="option">-w</code> Work on waypoints.  This is the default. </p><p><code class="option">-T</code> Enable Realtime tracking. This option isn't supported by the majority of our file formats, but repeatedly reads location from a GPS and writes it to a file as described in <a class="xref" href="tracking.html" title="Realtime tracking">the section called “Realtime tracking”</a></p><p><code class="option">-b</code> Process batch file. In addition to reading arguments from the command line, we can read them from files containing lists of commands as described in <a class="xref" href="batchfile.html" title="Batch mode (command files)">the section called “Batch mode (command files)”</a> </p><p><code class="option">-c</code> Select character set. This option lets you chose the character set.  You can get a list of supported character sets via <code class="option">-l</code> </p><p><code class="option">-N</code> Control "smart" output.   The <code class="option">-N</code> actually has two subtoptions, <code class="option">-Ni</code> and <code class="option">-Ns</code>.   This lets you control whether a given writer will choose smart icons and names, respectively.   The option <code class="option">-N</code> by itself selects both.    </p><p><code class="option">-x filter</code> Run filter. This option lets use use one of of our many data filters. Position of this in the command line does matter - remember, we process left to right.</p><p><code class="option">-D</code> Enable debugging.   Not all formats support this.  It's typically better supported by the various protocol modules because they just plain need more debugging.   This option may be followed by a number.   Zero means no debugging.  Larger numbers mean more debugging. </p><p><code class="option">-l</code> Print character sets.   </p><p><code class="option">-h</code><code class="option">-?</code> Print help. </p><p><code class="option">-V</code> Print version number. </p></div><div xmlns="http://www.w3.org/1999/xhtml" class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="batchfile.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="The_Formats.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Batch mode (command files) </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. The Formats</td></tr></table></div>
  
      {/literal}{/block}
  