[DOC] Notes about using the URL field in map configs

diff --git a/help/C/viking.xml b/help/C/viking.xml
index d4dcc649647d67a9b8957cd921d9f9bbd6f2036d..1136bd31a4683544946ac4c377e6fd231617474c 100644 (file)
--- a/help/C/viking.xml
+++ b/help/C/viking.xml
@@ -3087,7 +3087,13 @@ Accept: */*
             </varlistentry>
             <varlistentry>
               <term>url</term>
-              <listitem><para>the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z, X and Y (in that order) (eg. "/%d/%d/%d.png")</para></listitem>
+              <listitem>
+               <para>the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z, X and Y (in that order) (eg. "/%d/%d/%d.png")</para>
+               <note>
+                 <para>The full parametrized address can just be put in the URL field and the hostname field doesn't need specifying.</para>
+                 <para>e.g. "https://tile.openstreetmap.org/%d/%d/%d.png"</para>
+               </note>
+             </listitem>
             </varlistentry>
             <varlistentry>
               <term>zoom-min (optional)</term>

diff --git a/help/viking.xml.in b/help/viking.xml.in
index 3c9cb27652515a5a92b09bd4137fa80a478487c6..405b0cab03f54039290e06f39aa316cf110decd4 100644 (file)
--- a/help/viking.xml.in
+++ b/help/viking.xml.in
@@ -257,7 +257,13 @@ and docbook-xsl in your Build-Depends control field.
             </varlistentry>
             <varlistentry>
               <term>url</term>
-              <listitem><para>the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z, X and Y (in that order) (eg. "/%d/%d/%d.png")</para></listitem>
+              <listitem>
+               <para>the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z, X and Y (in that order) (eg. "/%d/%d/%d.png")</para>
+               <note>
+                 <para>The full parametrized address can just be put in the URL field and the hostname field doesn't need specifying.</para>
+                 <para>e.g. "https://tile.openstreetmap.org/%d/%d/%d.png"</para>
+               </note>
+             </listitem>
             </varlistentry>
             <varlistentry>
               <term>zoom-min (optional)</term>