gworldclock.sgml

<!doctype refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [

  <!ENTITY dhfirstname "<firstname>Drew</firstname>">
  <!ENTITY dhsurname   "<surname>Parsons</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>04 May, 2024</date>">
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>dparsons@debian.org</email>">
  <!ENTITY dhusername  "Drew Parsons">
  <!ENTITY dhucpackage "<refentrytitle>GWORLDCLOCK</refentrytitle>">
  <!ENTITY dhpackage   "gworldclock">

  <!ENTITY debian      "<productname>Debian GNU/Linux</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY defaultList         "${XDG_CONFIG_HOME}/tzlist">
]>

<refentry>
  <docinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2001</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </docinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhpackage;</refname>

    <refpurpose>Displays time and date in specified time zones.</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhpackage;</command>
      <arg>-f <replaceable>FILE</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>DESCRIPTION</title>

    <para><command>&dhpackage;</command> displays the time and date of
     specified time zones using a GTK+ interface. It also allows the
     zones to be "rendezvoused" or "synchronised" to a time other than the current time.
    </para>

    <para>
    The time zones may be chosen from the list given in the GUI user
     interface.  The zones available are generated from the data in
     /usr/share/zoneinfo/zone.tab.  The chosen set of zones is stored
     in &defaultList; by default, but an alternate file may be specified
     at the command line via -f. Alternatively this file may be
     created by hand in TZ format. The zone list is kept in a format
     consistent with the shell script tzwatch, currently found in
     twclock.  The format consists of one TZ string per line,
     optionally followed by a human-friendly string enclosed in
     inverted commas ("), providing a name for the zone.
     </para>
</refsect1>

<refsect1>
    <title>OPTIONS</title>

<para>
   <variablelist>
     <varlistentry>
          <term>-f <replaceable>FILE</replaceable></term>
          <listitem>
	  <para>
	        Read zone list from <replaceable>FILE</replaceable> instead
		of &defaultList;.
	  </para>
	  </listitem>
     </varlistentry>
   </variablelist>
</para>
</refsect1>

  <refsect1>
    <title>SEE ALSO</title>

    <para>tzwatch (1)</para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>
	  <para><command>&dhpackage;</command> was written by &dhusername;
	 &dhemail;.
      </para>


    <!-- <para>Permission is granted to copy, distribute and/or modify
      this document under the terms of the <acronym>GNU</acronym> Free
      Documentation License, Version 1.1 or any later version
      published by the Free Software Foundation; with no Invariant
      Sections, no Front-Cover Texts and no Back-Cover Texts.  A copy
      of the license can be found under
      <filename>/usr/share/common-licenses/FDL</filename>.</para> -->

  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->