aboutsummaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
authorsfllaw <devnull@localhost>2003-04-21 14:53:05 (GMT)
committersfllaw <devnull@localhost>2003-04-21 14:53:05 (GMT)
commit2d8d11a0f0d1474ef2e64fe7b06a05cde0862d97 (patch)
treedda71df0678ca5e7fb54ad0803d789a25354a866 /INSTALL
parent5c28386fcb3c73a4008c50a6795f56a79fca943d (diff)
* tvtime/INSTALL: Document the --with-fifogroup option.
* tvtime/src/Makefile.am: Make Makefile warn whenever it cannot create the FIFO directory, instead of dying.
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL41
1 files changed, 41 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
index 54caf7c..e3dd299 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,3 +1,44 @@
+Copyright (C) 2003 Billy Biggs
+ This file is free documentation; Billy Biggs gives unlimited permission
+to copy, distribute and modify it.
+
+Quirks when Compiling tvtime
+============================
+
+To learn how to compile this program, please refer to the document on the
+next page. It explains terminology used in this section.
+
+ `make install' will create a directory to hold FIFOs, which will control
+running instances of tvtime. It needs to set the correct permissions on
+this directory so people can create FIFOs. However, due to the lack of
+standards, you will have to specify which group owns this directory.
+
+ On a Debian GNU/Linux, Gentoo, or SuSE system, you will want to use
+the `video' group, as it owns /dev/video0. Make sure you are in the
+`video' group [1] before you try to compile. Then, when invoking configure,
+you should specify:
+
+ ./configure --with-fifogroup=video ...other options...
+
+A `make install' should do the Right Thing, as should `make uninstall'.
+
+ On other distributions, the configure script default of
+`--with-fifogroup=users' which appears to be valid on most GNU/Linux
+distributions. However, you will need to be in the `users' group before
+attempting to compile. To be useful, your video device (e.g. /dev/video0)
+should also be set to the same group. You may wish to create a `video'
+group to limit video playing to a certain group of users. Consult
+your system documentation for how to do this.
+
+-----
+[1] You can confirm which groups you are in by using the `groups' command.
+ If you are not in the `video' group, you should get your system
+ administrator to add you. Then, log out and log back in.
+
+ If you are the system administrator, consult the `adduser' command,
+ or edit `/etc/group' with the `vigr` command.
+
+
Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002 Free Software
Foundation, Inc.

Privacy Policy