File: README

package info (click to toggle)
slrnface 2.0-3
  • links: PTS
  • area: main
  • in suites: woody
  • size: 116 kB
  • ctags: 69
  • sloc: ansic: 559; makefile: 75; sh: 9
file content (75 lines) | stat: -rw-r--r-- 2,364 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
This is slrnface, a small helper utility which displays X-Faces on behalf
of programs like slrn and mutt when they are run in the X11 terminal
emulator.

Requirements:

a) X11.
b) Terminal emulator which sets WINDOWID environment variable. Most of the
   ones in common use will set it. If you're using some terminal emulator
   which doesn't have this capability, you'll have to set it yourself.

How to build:

a) Install libcompface. I recommend getting the source from the nearest
   Debian GNU/Linux mirror because there's a patch which adds the
   ability to output XBM image, as well as the historic brain dead
   format. Slrnface doesn't use that feature, but it might be handy for
   something else.

b) Edit Makefile.

c) Invoke make.

d) Put the resulting binary somewhere in your PATH.

Upgrading from version 1.x:

   If you have used one of the older versions of slrnface, you probably
   have .slrnface file in your home directory. You can delete it, because
   the new version doesn't use it any more. Instead, the pipes will be
   created in $HOME/.slrnfaces directory. There are no other user visible
   changes.

Using slrnface with slrn:

   You'll need slrn version 0.9.6.0 or higher. Slrnface will work with older
   versions, but slrn won't recognize the most important S-Lang macro, so you
   won't be able to see much. You'll also need S-Lang 1.4 or later.

   Take a look at slrnface.sl, edit if you want and then include it in
   your .slrnrc, like this:

   interpret slrnface.sl

   Run slrn.

Using slrnface with mutt:

   Mutt doesn't have a way to use some kind of embeded interpreter, like
   S-Lang. Since Mutt's current capabilities are not good enough for our
   purposes, a patch for the source is provided. It has only been tested
   with mutt 1.3.27.

   Uncompress mutt 1.3.27 source and apply mutt.patch from the slrnface
   distribution.

   Compile mutt as usual.

   Edit your ~/.muttrc and add:

   set xface=yes

   Run mutt.

If you think X-Faces are not placed at the appropriate location on your
terminal emulator window or you don't like the colors, set some X resources.
Read the man page for more information.

Licence: GPL. See file called COPYING.

Special thanks to Mark R. Bowyer for proofreading the man page.

Current download location: http://dave.willfork.com/slrnface/slrnface.tar.gz

dave@willfork.com