File: README

package info (click to toggle)
glbiff 0.2-3
  • links: PTS
  • area: main
  • in suites: slink
  • size: 112 kB
  • ctags: 49
  • sloc: cpp: 649; makefile: 39; sh: 31
file content (125 lines) | stat: -rw-r--r-- 3,993 bytes parent folder | download
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
glbiff v0.2
===========
This is a program similar to xbiff, except that it provides somewhat
nicer output. It requires the Mesa (OpenGL clone) libraries to render
the 3D mailbox. The idea comes from the "mailbox" program available on
SGI machines, and hence tries to mimic some of the features present in
it.

Note that this is an alpha version, and hence there are still some
outstanding bugs.

The program was written and tested on Linux. It may require some minor
changes for other flavours of UNIX.  Also, conversion from Mesa to
OpenGL should be trivial (the only major thing is the change from
auxMouseFunc to glutMouseFunc since they take fundamentally different
parameters).


Getting glbiff
==============
The latest version, as well as most updated documentation will be
available at 

	http://www.eecg.utoronto.ca/~mac/projects/glbiff.html


Requires 
========
* Linux, X (tested with kernel 2.0.33) 
* Mesa libraries (tested with 2.5) 


Installing
==========
First, you should create a .glbiffrc in your home directory (see next
section).

Next, run "xmkmf", followed by "make". Should you have problems with
this, you can also try compiling with an alternate Makefile: just
run "make -f Makefile.alt" and "make -f Makefile.alt install" 
(you might want to change DEST_DIR to where you want the binary to go).


sample .glbiffrc 
================

NOTE: without this file in your home directory, glbiff won't do
much!!!! (I'll fix this in next version to just check
/var/spool/mail/$USERID in this case)

This is essentially the configuration file for the program. Below is a
sample file. glbiff looks for this file in your home directory.

------ start .glbiffrc ----------
y /var/spool/mail/mac
n /home/mac/mail/daggerfall
n /home/mac/mail/linux
n /home/mac/mail/linux-kernel
n /home/mac/mail/mutt-dev
n /home/mac/mail/mutt-users
n /home/mac/mail/redhat-digest
n /home/mac/mail/announcements
n /home/mac/mail/newbie
n /home/mac/mail/security
------ end of file ---------------

Here, the first column is either 'y' or 'n', representing whether to
show these messages in the mailbox (and hence count them). If set to
'n', the messages are not shown in the mailbox, BUT if the mailbox
holds new mail, the flag will still go up.


Present capabilities/features 
=============================
* monitors multiple mailboxes (only mbox format[1 folder=1 file] for now) 
* right mouse button opens/closes mailbox door 
* left mouse button does same except that when door is open it starts
  up your mail reader 
* runs a user defined script/program when new mail arrives in any of
  the mailboxes 
* raised flag indicates unread mail in one of the mailboxes 
* will now parse most of X's defaults switches

[for most up-to-date idea of features check ChangeLog]


Future improvements 
===================
[see the TODO file]



Bugs
====
* intermitten bug: in transitions, sometimes the camera teleports for
  a single frame to some strange position
* not sure, but I think I've seen a rare core dump; will investigate
  the core file next time
* glbiff should be more intelligent when no .glbiffrc file exists 
* message counting algorithm needs more work 
* when nearly full, some envelopes stick out of the mailbox 


Legal stuff
===========
I place this package in the public domain. You may hack it, mutilate
it, and generally modify it to your heart's content. If you have some
improvements, send me a patch!

Also, note that I'm not responsibile for what this software does. Use
it at your own risk. The chances that it will actually do something
bad are probably about the same as Micro$oft become an ethical company 
producing quality applications, but in any case, you have been warned.


Thanks to...
============
* Wim Dumon <Wim.Dumon@kotnet.org> - spotted some ugly bugs
* Chuck Robey <chuckr@glue.umd.edu> - FreeBSD fixes and the Imakefile
 

Comments, queries... 
====================
Comments, queries, bugs, patches, ... send to 
Maciej Kalisiak <mac@dgp.utoronto.ca>