No description
This repository has been archived on 2025-02-01. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
mathias cb217d8034 * set copyright, license and svn:keyword Id to our files
* added the $Id$ tag

--HG--
extra : convert_revision : svn%3Aeebe1cee-a9af-4fe4-bd26-ad572b19c5ab/trunk%4031
2005-05-25 06:43:42 +00:00
bitmaps * added -cursor <themename> 2005-04-30 10:41:41 +00:00
contrib * added contrib/xcursor-pekwm 2005-05-18 20:28:35 +00:00
src * set copyright, license and svn:keyword Id to our files 2005-05-25 06:43:42 +00:00
alock.txt * updated documentation 2005-05-24 09:00:26 +00:00
CHANGELOG * solved problems install-problems: use at least scons 0.96.90 2005-05-25 06:31:52 +00:00
LICENSE * license is : MIT 2005-05-18 10:29:02 +00:00
README * updated documentation 2005-05-24 09:00:26 +00:00
scons_alock.py * solved problems install-problems: use at least scons 0.96.90 2005-05-25 06:31:52 +00:00
SConstruct * solved problems install-problems: use at least scons 0.96.90 2005-05-25 06:31:52 +00:00

alock - README
==============
Mathias Gumz <akira@fluxbox.org>
v1.0, 24 May 2005

About
-----
'alock' locks your current session in X. It's not a full featured
screensaver distribution like 'xlockmore' or 'xscreensaver', but just a
tiny locker: "uh, i need coffee .. so i need a lock" .. 
You can modify the way you have to authenitificate yourself, the way the
mousepointer looks when you locked the display and the way the content of
the display is handled. Eg: with -bg none you can see whats going on, 
even when you are not able to modify what you see, which might be pretty 
usefull for public terminals where a demo should run but noone should
press any buttons or keys (you know those little kids ... )

Installation
------------
To install / compile 'alock' you need 'scons':

* link:http://www.scons.org[scons]

It's a clever buildsystem which i prefer over make/autotools.
After installing 'scons' you just type:

    $> scons

and it should build your personal version of 'alock'.
You can influence the build-process by some variables, check

    $> scons -h

To install it finally to your system use:

    $> scons install

and thats it.
If you grabed a svn-version (not a release-tarball) you also need
'asciidoc' and 'xmlto' to create the documentation-files:

* link:http://www.methods.co.nz/asciidoc/[AsciiDoc]
* link:http://cyberelk.net/tim/xmlto/[xmlto]

Tested platforms (so far):

* gentoo-linux (pc and ppc with gcc3.4.3) 
* freebsd5.3 (pc gcc3.4.2)
* slackware (pc, gcc3.3.5, shadow)

Usage
-----
You find more info about how to use 'alock' in the alock-documentation:

    $> less alock.txt
    $> man alock
    $> firefox alock.html

History
-------
An irc-buddy of mine (izhirahider) was using 'xtrlock' and had some
problems with it .. no wonder, development stopped some years ago
and it doesnt support 'pam'. Since i liked the minimalism of 'xtrlock' 
but wanted to add some minor things to it i forked 'alock' from
'xtrlock' and modified it a bit :) At the moment there is almost no code
from 'xtrlock' left.

Author / Contributors
---------------------
* 2005        Mathias Gumz aka akira <akira@fluxbox.org> (code)
* 1993 - 1994 Ian Jackson (xtrlock)

* 2005        Tenner (alock-logo)
* 2001-2005   Fluxbox-Team (fluxbox-logo)
* 2005        Pekwm-Team (pekwm-logo)