Search on geo-position

[geeqie.git] / doc / docbook / GuideImageSearchSearch.xml

diff --git a/doc/docbook/GuideImageSearchSearch.xml b/doc/docbook/GuideImageSearchSearch.xml
index 1071fab..f1719ea 100644 (file)
--- a/doc/docbook/GuideImageSearchSearch.xml
+++ b/doc/docbook/GuideImageSearchSearch.xml
@@ -136,6 +136,31 @@
         </term>\r
         <listitem>The search will match if the file's associated keywords match all, match any, or exclude the entered keywords, depending on the method selected from the drop down menu. Keywords can be separated with a space, comma, or tab character.</listitem>\r
       </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <guilabel>Geocoded position</guilabel>\r
+        </term>\r
+        <listitem>\r
+          The search will match if the file's GPS position is less than or greater than the selected distance from the specified position, or is not geocoded, depending on the method selected from the drop down menu.\r
+          The search location can be specified by\r
+          <itemizedlist>\r
+            <listitem>\r
+              Type in a latitude/longitude in the format\r
+              <code>89.123 179.123</code>\r
+            </listitem>\r
+            <listitem>Drag-and-drop a geocoded image onto the search box</listitem>\r
+            <listitem>If Geeqie's map is displayed, a left-click on the map will store the latitude/longitude under the mouse cursor into the clipboard. It can then be pasted into the search box.</listitem>\r
+            <listitem>Copy-and-paste (in some circumstances drag-and-drop) the result of an Internet search.</listitem>\r
+          </itemizedlist>\r
+          <note>\r
+            In this last case, the result of a search may contain the latitude/longitude embedded in the URL. This may be automatically decoded with the help of an external file:-\r
+            <programlisting xml:space="preserve">~/.config/geeqie/geocode-parameters.awk</programlisting>\r
+            See\r
+            <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>\r
+            for details on how to create this file.\r
+          </note>\r
+        </listitem>\r
+      </varlistentry>\r
     </variablelist>\r
     <para />\r
     <para />\r