You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tde-guidance/README

156 lines
4.5 KiB

!!! Warning: Read this through to the end. These tools can be dangerous. !!!
Guidance 0.8.0
~~~~~~~~~~~~~~
by Simon Edwards <simon@simonzone.com>, Sebastian Kügler <sebas@vizzzion.org>
& Yuriy Kozlov <yuriy.kozlov@gmail.com>, Martin Böhm <martin.bohm@kubuntu.org>
Introduction
------------
Guidance is a collection of system administration tools for Linux/TDE systems
that is designed to be:
* Update to date
* High quality, designed with user friendliness as high priority. (That is
to say that the tools should get the job done quickly, accurately and with
as little effort as possible.)
* Use TDE and "fit in" with TDE.
* Maintainable.
* Free Software
Warning
-------
These tools often require root access and modify important system files in
order to do their job. There is a very real chance that these tools can
destroy your computer and your data. Backup your data! Also especially
backup up /etc/passwd, /etc/shadow and /etc/fstab. If you don't know what
I'm talking about now then you probably shouldn't try using Guidance yet.
You should have some idea how to fix
We accept no responsibility in the event that something goes terribly wrong.
You have been warned.
Status
------
The tools that make up Guidance are in different stages of development and
have only been tested on Mandrake.
* userconfig - User & Group configuration. Supports /etc/passwd and
/etc/shadow right now.
* serviceconfig - System services configuration utility. Feature complete.
Works on Mandrake, Debian, (K)ubuntu Gentoo and maybe Red Hat out of the box.
* mountconfig - Mount point configuration utility. Feature complete and
stable.
* wineconfig - Wine configuration utility.
* grubconfig - Grub boot loader configuration utility. beta quality now.
Requirements
------------
* Linux.
* Python. 2.4 recommended. You probably already have Python installed, and if
not then it will most definately be available for you distribution of choice.
* PyQt / PyKDE. Version 3.7 or higher. PyQt and PyKDE are distributed with
TDE as part of kde-bindings since version 3.3.
For versions of KDE before 3.3 it is possible to install PyQt/PyKDE
directly. The homepage for PyQt and PyKDE is:
http://www.riverbankcomputing.co.uk/pytde/index.php
Packages for most popular distributions are available here:
http://sourceforge.net/project/showfiles.php?group_id=61057
* KDE 3.
* "PyKDE Extensions" is needed for installation. It is available here:
http://www.simonzone.com/software/pytdeextensions/
This is also a runtime requirement!
* libpythonize. If you don't want the tools to appear on the TDE Control
Center of you just don't want to bother with libpythonize, then you can
build Guidance with this command:
python setup.py install build_kcm --no-kcontrol
libpythonize is only needed for the Trinity Control Center.
* You also need to have the development files from your X-server installed,
XFree86 or Xorg. Most distributions package these files up in a package
called XFree86-devel, or Xorg-devel, or libxorg-X11-devel or some similar.
* Specifically, the following packages are needed on Kubuntu:
build-essential
python-sip4-dev
libxxf86vm-dev
libxrender-dev
libxrandr-dev
libpythonize0-dev
pyqt-tools
libtool
kde-devel
Installation
------------
As root run:
./setup.py install
This will test for a working installation of PyQt/PyKDE and automatically
install the files using the same installation prefix as TDE. You will need
to have a working Python install before you can even run the setup.py script.
Running
-------
Installation should add a couple of entries to the Trinity Control Center in the
System section. It is also possible
to run the commands outside of the Trinity Control Center from the shell as root:
* serviceconfig
* userconfig
* mountconfig
* wineconfig
* grubconfig
Reporting Bugs
--------------
Bug reports and feedback can be sent to simon@simonzone.com . Do make sure
that say which version of Guidance you are using and also what Linux
distribution you are using, and also how you installed SIP, PyQt, PyKDE. Also
if any error messages are printing to the console, email those too. By
running these tools from the command line you can often get useful (to me)
debug information. That kind of information is valuable.
Deinstallation
--------------
As root run:
./setup.py uninstall
Thanks go to
------------
Jim Bublitz
David Boddie
Sebastian Kügler
Theo Houtman
Pete Andrews (gamma correction system)
--
Simon Edwards
<simon@simonzone.com>