summaryrefslogtreecommitdiff
path: root/vchat-howto
diff options
context:
space:
mode:
authorerdgeist <>2003-12-13 11:31:31 +0000
committererdgeist <>2003-12-13 11:31:31 +0000
commit56453afa766ac8bf74e04d630d06ca2119e7b538 (patch)
tree47416647686159d99ff6eda5e6b05da88c9260c8 /vchat-howto
parent68bed72f530d2cafb7c90cfd17d6c8b5d132af28 (diff)
Our howto
Diffstat (limited to 'vchat-howto')
-rwxr-xr-xvchat-howto240
1 files changed, 240 insertions, 0 deletions
diff --git a/vchat-howto b/vchat-howto
new file mode 100755
index 0000000..643b13d
--- /dev/null
+++ b/vchat-howto
@@ -0,0 +1,240 @@
1Newbies Guide to vchat via 'Buntclient'
2=======================================
3
41. Get the Source, Luke
5-----------------------
6
7Make sure, you got a shell and the tool called cvs.
8cd to a directory the source shall reside in.
9
10Type:
11
12$ cvs -d:pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot login
13$ cvs -z3 -d:pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot co vchat-client
14
15(press return at password prompt)
16
17
182. Do the verpile
19-----------------
20
21Enter the vchat-client/ directory.
22Type:
23
24$ make
25
26If that fails due to some readline fuckups, try again with:
27
28$ make OLDREADLINE=-DOLDREADLINE
29
30You may also try to enable the experimental ipv6 support
31
32$ make EXPERIMENTAL_IPV6=-DEXPERIMENTAL_IPV6
33
34If you are administrator of your computer and want to install
35vchat-client permanently, type:
36
37$ make install
38
39You may also run the binary from its compile location.
40
41
423. Get protected
43----------------
44
45Run the script vchat-keygen, located in the vchat-client/ directory.
46Follow its instructions.
47
48
494. Home sweet Home
50------------------
51
52Create a .vchat/ directory in your homedir.
53
54$ cd
55$ mkdir .vchat/
56
57Copy your key to the .vchat/ directory:
58
59$ cp ~/.vchat.key ~/.vchat/key
60
61Whenever your signed cert arrives from vchat at vchat.berlin.ccc dot de,
62copy it to the .vchat/ directory as well:
63
64$ cp ~/.vchat.cert ~/.vchat/cert
65
66In order to modify the look of your client, you may copy one of
67the sample-xxx.fmt files to the .vchat/ directory:
68
69$ cd vchat-client/
70$ cp sample-erdgeist.fmt ~/.vchat/formats
71
72If you want to set the chat server to vchat.berlin.ccc.de now,
73type:
74
75$ echo host=vchat.berlin.ccc.de >> ~/.vchat/config
76
77If you want a seperate private message window, type:
78
79$ echo messages=10 >> ~/.vchat/config
80
81If you want to have no topic line, like in the oldschool client,
82do not choose a private message window an type:
83
84$ echo usetopicbar=0 >> ~/.vchat/config
85
865. First bunt
87-------------
88
89Check, whether you REALLY got a signed cert.
90
91[....
92If you did not get a reply from vchat at vchat.berlin.ccc dot de within
933 days, this might either be due to you not being known to the
94certificate masters, or simply because of the verpeil. You may,
95after 3 days, contact me at erdgeist at erdgeist dot org. If I don't
96reply, too, reconsider your lifestyle.
97....]
98
99Start the client:
100
101$ vchat-client
102
103or
104
105$ vchat-client/vchat-client
106
107Enter the passphrase to your private key, if you added one.
108
109Look around.
110
111Try to feel comfortable with the new look of your vchat-
112environment. Close your mouth. Try playing around with the
113following commands:
114
115If you did not enable the seperate private message window,
116ignore this part:
117
118[ STARTIGNORE
119
120Press Ctrl-G and Ctrl-T several times.
121Press Ctrl-X, then send yourself a private message, watch, what
122happens
123Press Ctrl-C ONCE!!!
124Press Ctrl-R and watch the asteriks at the very right of your
125screen, this one indicates, which window to scroll back
126
127ENDIGNORE]
128
129Press Ctrl-B Ctrl-F, if you collected some text in your
130message window. This should scroll back and forth.
131A red console bar should indicate, that you scrolled up.
132
133Press Ctrl-L to redraw and reset scroll indices.
134
135Play around with the completion:
136
137Hitting <TAB> at start of line will complete to
138
139.m <lastpersonyouexchangedprivatemessageswith>
140
141if you hit <TAB> more often, you will cycle through this list,
142sorted by the last time you exchanges PMs with.
143
144Hitting <TAB> when you already typed some letters but no space
145yet will expand to all nicks in your current channel. You may
146cycle through this list, too.
147
148Hitting tab anywhere else expands to all nicks in all channels.
149
150Most other readline hotkeys (Ctrl-U, Ctrl-K, Ctrl-W, Ctrl-A...)
151will work as expected.
152
153
1546. Commandoe
155------------
156
157In addition to the server commands (.h, .m, .a, .s ...) the
158client brings its own set of commands, which will be triggered
159IRC-style by /COMMAND. These may be abbrevated to the lowest
160unambigous substring.
161
162Try /HELP for a first glimpse.
163The status window may be forced off by hitting Ctrl-X.
164
165/HELP KEYS should give you a short summary of available hot
166key commands.
167
168Some client commands are wrappers around server commands:
169
170/ME == .a
171/MSG == .m
172/M == .m
173/QUIT == .x
174
175The other commands are used to enable client side filtering
176and highlighting.
177
178Try:
179
180/HELP FILTERS
181/HELP FLT
182/HELP FILTERS
183
184Highlight yourself:
185
186/FLT 6 <nickname>
187
188if you don't see anything getting highlighted, you probably
189have a mac. If you got this far despite of that problem, you
190will surely find a way to enable colors in your terminal.
191
192Remove the filter rule:
193
194/rmflt 1
195
196Zoom in all channel leaves:
197
198/flt + left channel
199
200List your filter rules:
201
202/lsflt
203
204Remove all filters:
205
206/clflt
207
208Ignore all server leave and join messages
209
210/flt - ((left|joined|entered) (the )?(channel|chat))
211
212Reenable those lines
213
214/rmflt ((left|joined|entered) (the )?(channel|chat))
215
216Note: zoom overrides ignore.
217
218Be careful about setting your filters, as these are treated
219as regular expressions, which easily may lead to time
220consuming evaluations. Avoid brackets.
221
222
2237. Fiiiiiiiiieschas
224-------------------
225
226As I am still young *cough cough* I am _STILL_ willing to
227implement features of all stupidity grades. Contact me
228with /m erdgeist <feature request> at any time.
229
230
2318. You help
232-----------
233
234Since you will probably start fiddeling around with your
235.vchat/formats file, I'd appreciate getting YOUR format,
236too, as this may be helpful for others to make their own.
237Just send them to erdgeist at erdgeist dot org. Bug reports,
238feature request that are to long for the chat and diffs
239implementing some features are welcome at this address,
240too.