<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
  <!ENTITY gnu         "<acronym>GNU</acronym>">

  <!ENTITY program     "s3dosm">
]>
<refentry id="s3dosm">

	<refmeta>
		<refentrytitle>&program;</refentrytitle>
		<manvolnum>1</manvolnum>
	</refmeta>

	<refnamediv>
		<refname>&program;</refname>
		<refpurpose> gps card application for s3d </refpurpose>
	</refnamediv>

	<refsynopsisdiv>
		<cmdsynopsis>
			<command>&program;</command>
			<arg choice="opt">-o|--osm <replaceable>MINLAT</replaceable>,<replaceable>MINLON</replaceable>,<replaceable>MAXLAT</replaceable>,<replaceable>MAXLON</replaceable></arg>
			<arg choice="opt">-h|--help</arg>
			<arg choice="opt">--s3d-url <replaceable>url</replaceable></arg>
			<arg choice="opt"><replaceable>files</replaceable></arg>
		</cmdsynopsis>
	</refsynopsisdiv>

	<refsect1>
		<title>DESCRIPTION</title>
		<para>
			<command>&program;(1)</command> is a 3D gps card application for openstreetmap/kismet xml card data.
		</para>
		<para> </para>
	</refsect1>

	<refsect1>
		<title>OPTIONS</title>
		<para>
			This program follows the usual &gnu; command line syntax. A summary of
			the options supported by <command>&program;</command> is below.
		</para>
		<variablelist>
			<varlistentry>
				<term><option>-h</option>, <option>--help</option>
				</term>
				<listitem>
					<para> Show summary of options and exit. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><option>-o</option>, <option>--osm</option> <replaceable>MINLAT</replaceable>,<replaceable>MINLON</replaceable>,<replaceable>MAXLAT</replaceable>,<replaceable>MAXLON</replaceable>
				</term>
				<listitem>
					<para> Load a map with the given bounding box from the openstreetmap server. </para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term><option>--s3d-url <replaceable>url</replaceable></option></term>
				<listitem>
					<para> skip S3D environment and connect to this url </para>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsect1>

	<refsect1>
		<title>EXAMPLES</title>
		<para>
		<screen
><prompt>$ </prompt><userinput>s3osm --osm <replaceable>12.90142,50.82475,12.93352,50.84592</replaceable></userinput>

<prompt>$ </prompt><userinput>s3osm <replaceable>osmdata</replaceable>.xml</userinput>
</screen>

		</para>
	</refsect1>

	<refsect1>
		<title>SEE ALSO</title>
		<para> <command>s3d</command>(1).</para>

		<para> <ulink url="http://s3d.berlios.de/"> s3d project page on berlios </ulink> </para>
		<!--TODO: ADD REFERENCE TO APPS AND /usr/share/doc/s3d/ -->
	</refsect1>

</refentry>

