NAME

       cairo-clock - an analog clock drawn with vector-graphics

SYNOPSIS

       cairo-clock  [--x  X]  [--y  Y]  [--width  WIDTH]  [--height  HEIGHT] [--seconds] [--date]
       [--theme  name]  [--ontop]  [--pager]  [--taskbar]  [--sticky]  [--twelve]  [--twentyfour]
       [--refresh]
       cairo-clock -h, --help
       cairo-clock -v, --version
       cairo-clock -l, --list

DESCRIPTION

       This manual page documents briefly the usage of the cairo-clock program.  You can move the
       clock around with your mouse by pressing and holding the left  mouse-button  and  dragging
       your  mouse  around. The clock will follow your movements. To resize the clock you have to
       press and hold the middle mouse-button down and drag your  mouse  around.  The  upper-left
       corner  of  the  clock will follow your movements. Just clicking the right mouse-button on
       the clock will bring up the popup-menu. You find three menu-items.  Properties,  Info  and
       Quit.  Selecting  the  Properties  item  will  bring  up a dialog where you can change all
       available features of the clock (e.g. size, theme, display of  optional  elements,  pager-
       and  taskbar-behaviour).  The  next menu-item, Info, will bring up an informational dialog
       stating the name of program, current version, author and license  information.  The  third
       and  last  menu-item, Quit, really exits the program if you select it. Surprised?! ;-) You
       can also hit the ESC-key if you want to exit the program.

       If you want to install additional themes for the clock you downloaded  from  the  internet
       you  can  best  place  them in you home-directory under ~/.cairo-clock/themes. You proably
       have to create that directory-structure the first time you install  new  themes.  A  theme
       there  goes  in a directory like e.g.  ~/.cairo-clock/theme/new_theme. Once you copied the
       new themes directory there you will be able to select it via the Properties dialog in  the
       theme-selection  widget  after  a  restart  of the program. The theme-directories are only
       scanned during program-start. The newly added 24h-mode for cairo-clock will  need  you  to
       select  any  of  the supplied 24h-themes. While the clock will run without any problems if
       you switch to 24h-mode and still use a 12h-based theme, you are going to want to select  a
       24h-based theme in order to make any sense of the displayed hand-positions in 24h-mode.

OPTIONS

       cairo-clock  now  uses common GNU-convention for commandline-options. Take note that using
       commandline-options overrules everything which maybe stored in your  local  settings-file.
       Using  the  commandline-options will completely ignore any settings you may have stored in
       your local settings-file. Every  option  will  default  to  program-internal  settings.  A
       summary of options is included below.  There is no Info file on this.

       -x, --xposition X
              The initial x-position of the top-left window-corner of the clock will be X.

       -y, --yposition Y
              The initial y-position of the top-left window-corner of the clock will be Y.

       -w, --width WIDTH
              Initially open the window of the clock with a width of WIDTH.

       -g, --height HEIGHT
              Initially open the window of the clock with a height of HEIGHT.

       -s, --seconds
              Passing  this  means  to render the seconds-hand. If you leave this out no seconds-
              hand will be drawn.

       -d, --date
              Passing this means to render the date-display. If you leave this out no  date  will
              be drawn.

       -l, --list
              List all themes installed system-wide and locally for the current user and exit.

       -t, --theme NAME
              Use  theme  NAME for rendering. Use the any of the names returned by the options -l
              or --list.

       -o, --ontop
              Passing this means the clock-window will stay above all other windows. If you leave
              this out other windows can overlap the clock-window.

       -p, --pager
              Passing this means the clock-window will appear in the pager. If you leave this out
              the pager will ignore the clock-window and not display it.

       -b, --taskbar
              Passing this means the clock-window will show up in the taskbar. If you leave  this
              out the clock-window will not show up in the taskbar.

       -i, --sticky
              Passing  this  means  to  have  the clock-window appear all your workspaces. If you
              leave this out the clock will only be visible on the current workspace  from  where
              you initially started cairo-clock.

       -e, --twelve
              Passing this will force the hour hand to use commonly known 12h per full circle.

       -f, --twentyfour
              Passing this will cause the hour hand to spread 24h across a full circle.

       -r, --refresh RATE
              Use an animation-refreshrate of RATE for rendering. Use this with caution! Possible
              values are 1..60 Hz.

       -h, --help
              Print a usage-description and exit.

       -v, --version
              Print the programs version-number and exit.

BUGS

       If redraws don't happen every second (the second-hand is drawn) the needed refresh after a
       window-size change via the preferences-dialog only happens on a minute-interval.

AUTHOR

       cairo-clock is written and maintained by Mirco Mueller <macslow@bangang.de>.

       This  manual page was written by Mirco Mueller <macslow@bangang.de>, for the Debian/Ubuntu
       project (but may be used by others).