README 3.62 KB
Newer Older
Philip Van Hoof's avatar
Philip Van Hoof committed
1
gnome-schedule
Philip Van Hoof's avatar
Philip Van Hoof committed
2 3
--------------

Philip Van Hoof's avatar
Philip Van Hoof committed
4 5 6 7 8 9 10 11
	o. See the file COPYING for the license.
	o. See the AUTHORS file for the authors of this tool
	o. See the INSTALL file for information about installing this tool
	o. Checkout the doc/ directory for user documentation

Dependencies
------------

Gaute Hope's avatar
Gaute Hope committed
12
 Gnome Schedule needs (at least)
Gaute Hope's avatar
Gaute Hope committed
13

Gaute Hope's avatar
Gaute Hope committed
14
	o. at
Philip Van Hoof's avatar
Philip Van Hoof committed
15 16 17 18
	o. crontab
	o. Python
	o. PyGTK >= 2.3
	o. Python GConf
Gaute Hope's avatar
Gaute Hope committed
19
  o. su
Philip Van Hoof's avatar
Philip Van Hoof committed
20

Philip Van Hoof's avatar
Philip Van Hoof committed
21 22 23
Support
-------

Philip Van Hoof's avatar
Hehe  
Philip Van Hoof committed
24 25
  o. Mailinglists: You can talk to the developers and some other users
     of gnome-schedule here:
Gaute Hope's avatar
Gaute Hope committed
26

Gaute Hope's avatar
Gaute Hope committed
27
  o. http://lists.sourceforge.net/mailman/listinfo/gnome-schedule-users
Gaute Hope's avatar
Gaute Hope committed
28

Gaute Hope's avatar
Gaute Hope committed
29 30
  There is also a development list here:
  o. http://lists.sourceforge.net/mailman/listinfo/gnome-schedule-devel
Philip Van Hoof's avatar
Philip Van Hoof committed
31

Gaute Hope's avatar
Gaute Hope committed
32
INSTALL from source:
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
33
-------------------------------------------------------------
Gaute Hope's avatar
Gaute Hope committed
34
o. Because some people dislike the fact that manually compiled
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
35
   applications tamper with their distribution which is managed by the
Gaute Hope's avatar
Gaute Hope committed
36
   packaging system in use. We understand this and therefore made it
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
37 38
   possible to install the application outside of any default prefix.

Gaute Hope's avatar
Gaute Hope committed
39
o. If you want to use the sources pulled from the subversion server you need automake-1.7 and gnome-common.
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
40

Gaute Hope's avatar
Gaute Hope committed
41
o. The following commands will install gnome-schedule on a system that has python and automake-1.7 and some tools like gmake installed.
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
42

Gaute Hope's avatar
Gaute Hope committed
43
     $ git clone git://git.gnome.org/git/gnome-schedule
Gaute Hope's avatar
Gaute Hope committed
44 45 46 47 48 49 50
     $ pushd gnome-schedule
     $ ./autogen.sh --prefix=/usr/local
     $ make
     $ make install
     # and to start gnome-schedule:

     $ /usr/local/bin/gnome-schedule
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
51 52 53 54 55

     # You can read the script to know how to start the Python-script
     # manually. If PyGTK is not installed in your default prefix,
     # you, in case you are planning not to use the script, would have
     # to set the PYTHONPATH environment variable first! The generated
Gaute Hope's avatar
Gaute Hope committed
56
     # script, however, will do all this for you (if you use the
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
57 58
     # script).

Gaute Hope's avatar
Gaute Hope committed
59 60
Important notes
---------------
Gaute Hope's avatar
Gaute Hope committed
61
If you have previous records in 'at', gnome-schedule may have problems reading them and they are marked with DANGEROUS PARSE in the list if a unsecure method was used. There are no risk that the record will be lost or damaged unless you open it for editing and press apply, but we have tested many different setups and it should work fine.
Gaute Hope's avatar
Gaute Hope committed
62

Gaute Hope's avatar
Gaute Hope committed
63
Some comments right after existing records in crontab may return weird results for title and icon, normally this doesn't damage anything.
Gaute Hope's avatar
Gaute Hope committed
64

Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
65

Philip Van Hoof's avatar
Philip Van Hoof committed
66 67
Compiling and HACKING
---------------------
Philip Van Hoof's avatar
Philip Van Hoof committed
68

Gaute Hope's avatar
Gaute Hope committed
69
  GNOME Schedule is written using the programming language Python
70
  and uses the PyGTK and Python-GConf bindings.
Gaute Hope's avatar
Gaute Hope committed
71

Philip Van Hoof's avatar
Philip Van Hoof committed
72 73
  You can talk to the developers of gnome-schedule about development
  related issues here:
Philip Van Hoof's avatar
Philip Van Hoof committed
74

Philip Van Hoof's avatar
Philip Van Hoof committed
75
	o. http://lists.sourceforge.net/mailman/listinfo/gnome-schedule-devel
Philip Van Hoof's avatar
Philip Van Hoof committed
76

Gaute Hope's avatar
Gaute Hope committed
77
  To compile GNOME Schedule from git you will also need
Philip Van Hoof's avatar
Philip Van Hoof committed
78

Gaute Hope's avatar
Gaute Hope committed
79
	o. A git client
Philip Van Hoof's avatar
Philip Van Hoof committed
80
	o. autoconf and the other auto* tools (version >= 1.7)
Gaute Hope's avatar
Gaute Hope committed
81
	o. gnome-common which you can pull from the git.gnome.org
Philip Van Hoof's avatar
Philip Van Hoof committed
82

Gaute Hope's avatar
Gaute Hope committed
83
  To run GNOME Schedule from the source directory
Gaute Hope's avatar
Gaute Hope committed
84

Gaute Hope's avatar
Gaute Hope committed
85
  o. Enter src/
Gaute Hope's avatar
Gaute Hope committed
86 87 88 89
	o. run 'python gnome-schedule.py --debug'

	This will use images and datafiles from the current directory. Remember this is only for debugging and might not always work as expected.

90

Philip Van Hoof's avatar
Philip Van Hoof committed
91 92 93 94 95 96 97 98 99 100 101 102
  To make contributions you should first read

	o. HACKING
	o. AUTHORS
	o. The source code itself :-)

  To help with translations

	o. Check out the po/ directory. You can use gTranslator and
	   the other intl tools for translations. You should contact
	   the GNOME Translation team as they are the responsible
	   organisation for the translation of the GNOME desktop
Gaute Hope's avatar
Gaute Hope committed
103
	o. Check out the help/ directory for translations of the documentation
Philip Van Hoof's avatar
Philip Van Hoof committed
104 105
	o. Other than only the generated po-files you should also
	   check out the file src/lang.py
Philip Van Hoof's avatar
bla  
Philip Van Hoof committed
106 107