Man Linux: Main Page and Category List

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).