<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="clock-world">

  <info>
    <link type="guide" xref="clock" group="#last"/>
    <link type="seealso" href="help:gnome-clocks/index"/>

    <revision pkgversion="3.18" date="2015-09-28" status="review"/>
    <revision pkgversion="3.28" date="2018-07-30" status="review"/>
    <revision pkgversion="3.37" date="2020-08-06" status="review"/>

    <credit type="author copyright">
      <name>Michael Hill</name>
      <email>mdhill@gnome.org</email>
      <years>2015</years>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Display times in other cities under the calendar.</desc>
  </info>

  <title>Add a world clock</title>

  <p>Use <app>Clocks</app> to add times in other cities.</p>

  <note>
    <p>This requires the <app>Clocks</app> application to be installed.</p>
    <p>Most distributions come with <app>Clocks</app> installed by default.
    If yours does not, you may need to install it using your distribution’s
    package manager.</p>
  </note>

  <p>To add a world clock:</p>

  <steps>
    <item>
      <p>Click the clock on the top bar.</p>
    </item>
    <item>
      <p>Click the <gui>Add world clocks…</gui> button under the calendar to
      launch <app>Clocks</app>.</p>

    <note>
       <p>If you already have one or more world clocks, click on one and
       <app>Clocks</app> will launch.</p>
    </note>

    </item>
    <item>
      <p>In the <app>Clocks</app> window, click
      <gui style="button">+</gui> button or press
      <keyseq><key>Ctrl</key><key>N</key></keyseq> to add a new city.</p>
    </item>
    <item>
      <p>Start typing the name of the city into the search.</p>
    </item>
    <item>
      <p>Select the correct city or the closest location to you from the
      list.</p>
    </item>
    <item>
      <p>Press <gui style="button">Add</gui> to finish adding the city.</p>
    </item>
  </steps>

  <p>Refer to the <link href="help:gnome-clocks">Clocks Help</link> for more
  of the capabilities of <app>Clocks</app>.</p>

</page>
