File: README

package info (click to toggle)
xdkcal 0.9c-4
  • links: PTS
  • area: main
  • in suites: woody
  • size: 268 kB
  • ctags: 144
  • sloc: ansic: 1,060; sh: 330; makefile: 39
file content (83 lines) | stat: -rw-r--r-- 3,512 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
                         X Desktop Calendar

                Copyright(c) 1999 Jiro Sekiba<jir@hello.to>

* What is X Desktop Calendar

 X Desktop Calendar(xdkcal) is a Calendar for X Window System.  It
draws calendar on your desktop.  You can customize, fontset, color
drawing style.  This application is completely internationalized so it
reads locale database and draw locale specific strings, such as name
of months or weeks.

* Install

$ tar zxvf xdkcal-<version>.tar.gz
$ cd xdkcal-<version>
$ ./configure
$ make
$ make install

 Further information is in INSTALL file.

* Run

 After install, just type xdkcal.  You can see help message with "-h"
argument.  First time you run it, maybe xdkcal says "can't open file
..."  But it's no problem.  You'll find file named ".xdkcalrc" in your
home directory.  Next time you run xdkcal, xdkcal read configuration
from "~/.xdkcalrc".  Such configurations can be specified from command
line arguments or you can edit "~/.xdkcalrc" directly.

* Arguments

short   long             argument       description
-----------------------------------------------------------------
  -h    --help                        display help message
  -x    --window_x        x           position x
  -y    --window_y        y           position y
  -f    --fontset        fontset      fontset to write calendar
  -C    --default_color  color        default color
  -H    --holiday_color  color        holiday color
  -S    --saturday_color color        saturday color
  -T    --today_color    color        today color
  -M    --month_color    color        month color
  -t    --shape          on/off       transparent(default off)
                                      If you often change your root window
                                      image, you may turn on this option or
                                      you can send HUP signal to xdkcal.
                                      Honestly I don't recommend you to use
                                      this option, coz needs lot of CPU power.
  -p    --padding        padding      padding for each column and row.
  -s    --style          style_num    drawing style(0:normal 1:line)
  -m    --draw_month     on/off       draw month(default on)
  -w    --draw_week      on/off       draw weeks(default on)
  -n    --num_week       num          number of chars for weeks(default 2)
  -N    --no_save                     don't save configuration
                                      If you specify this option, xdkcal
                                      do NOT save configuraion to .xdkcalrc.

* Known Bug

 - I don't know other country's holidays except Japan.  Please tell me
   or just implement holiday function for your locale:-).  If you don't
   know how to write holiday function, just feel free to email me.

 - When run xdkcal and calendar is drawn under any Window, the calendar
   is not drawn correctly.  Then You need to send HUP signal to the process.
   It might not be a problem if you run xdkcal when X starts up;-).

* Copyright

 This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See
the GNU General Public License for more details.

* Author

  Jiro Sekiba <jir@hello.to>