annotate README.txt @ 322:b9c15c57dc8f

Clean up message functions, add new printMsgQ() helper function for messages that should not go into the log file. Add skeleton help function, accessible via F1 key. And other cleanups.
author Matti Hamalainen <ccr@tnsp.org>
date Sat, 11 Jun 2011 09:48:26 +0300
parents e97c764927ce
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
d83c544c8077 TRICKS -> README
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
1 NNChat - extremely simple NN chat applet compatible client
d83c544c8077 TRICKS -> README
Matti Hamalainen <ccr@tnsp.org>
parents: 0
diff changeset
2 ==========================================================
200
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
3 Written and designed by Anonymous Finnish Guy
260
e97c764927ce Update copyright.
Matti Hamalainen <ccr@tnsp.org>
parents: 255
diff changeset
4 (C) Copyright 2008-2011 Anonymous Finnish Guy
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
5
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
6
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
7 Distributed under DWETFYWTPL (Do What Ever The Fuck You Want
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
8 To Public License), see file COPYING for more information.
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
9
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
10
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
11 What is this?
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
12 -------------
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
13 A simple NCurses-based client compatible with NewbieNudes.com chatroom
60
fc8b5265a3d2 Improve grammar.
Matti Hamalainen <ccr@tnsp.org>
parents: 59
diff changeset
14 protocol. There is a basic line-editing interface with some bells and
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
15 whistles, such as a input history, logging to file, ignore lists,
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
16 persistent configuration, etc.
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
17
166
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
18 The original Flash-based chat client can be accessed through NN website:
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
19
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
20 http://www.newbienudes.com/chat/
8bb12c22fe05 Add note and link to the original Flash-based chat.
Matti Hamalainen <ccr@tnsp.org>
parents: 157
diff changeset
21
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
22
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
23 Usage
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
24 -----
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
25 See the help, 'nnchat --help' for available command line options. By
255
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
26 default the client connects to main room (TCP port 8005). By using
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
27 other ports (option -p) you can connect to "passion pit" (8003).
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
28
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
29 Connect as registered user to members only chat:
66
11b45ba0132f Cleanups.
Matti Hamalainen <ccr@tnsp.org>
parents: 60
diff changeset
30 > nnchat username password
7
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
31
dba89c48ce02 Updated readme.
Matti Hamalainen <ccr@tnsp.org>
parents: 5
diff changeset
32 Connect as guest to free for all main chat:
255
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
33 > nnchat -p 8003 AnonymousAndy ""
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
34
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
35 You can also leave out the username and password from the commandline,
00b0eb4ac656 Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 200
diff changeset
36 NNChat will prompt for those if necessary.
0
728243125263 Import.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
37
38
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
38
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
39 Keys
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
40 ----
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
41 arrow left/right - Move cursor in the current buffer.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
42 arrow up/down - Browse input history.
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
43 ctrl+left/right - Move cursor through words.
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
44
173
317df807da54 Update.
Matti Hamalainen <ccr@tnsp.org>
parents: 171
diff changeset
45 ins - Toggle between insert and overwrite modes.
317df807da54 Update.
Matti Hamalainen <ccr@tnsp.org>
parents: 171
diff changeset
46 del - Delete one character at cursor position.
317df807da54 Update.
Matti Hamalainen <ccr@tnsp.org>
parents: 171
diff changeset
47 backspace - Delete one character left to the cursor position.
52
8d9c065241b7 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 44
diff changeset
48
200
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
49 tab(ulator) - Try to complete a username. For example "an<tab>"
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
50 would check the userlist for usernames beginning with
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
51 "an" and replace this with the first match. Subsequent
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
52 tab-keypresses will "cycle" around other matches.
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
53
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
54 F2 - Clear current edit buffer.
171
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
55 F5 - Toggle ignore mode on/off.
192
a2e9bbd8ca18 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 178
diff changeset
56 F7 - Clear current PRV target, if any.
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
57 F8 - Toggle private chat mode on/off.
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
58 F9 - Quit.
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
59
171
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
60 ctrl+L - Refresh/redraw screen.
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
61
44
dfe6b835a745 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 38
diff changeset
62
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
63 Commands
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
64 --------
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
65 /to <user> - Set target for private chat. Example: "/to foobar"
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
66 will set target to user "foobar". After this, pressing
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
67 function key F8 will toggle between private mode and
171
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
68 public. Private chat mode is indicated by "username>"
35b1714eb3b2 Change F1 functionality to proper Insert key.
Matti Hamalainen <ccr@tnsp.org>
parents: 166
diff changeset
69 on the input line.
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
70
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
71 /ignore [user] - Toggle user to/from ignore. "/ignore" without specified
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
72 username will list users currently on the ignore list.
200
ec1ffa2043ec Updates.
ccr@tnsp.org
parents: 192
diff changeset
73 When ignore mode is ENABLED (via function key F5),
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
74 no messages or actions from users on the list will be
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
75 displayed. However, they will go into log file, if
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
76 logging is active.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
77
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
78 /color <color> - Changes your current user color visible to OTHER people
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
79 using the regular NN chat. Of course, this does not
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
80 affect this client in any way, as user colors are
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
81 ignored.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
82
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
83 /save - Save current configuration (username, password, etc.)
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
84 Notice that this may be a risk, if your computer
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
85 has several users as just starting the client will
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
86 automatically log into the chat with your username and
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
87 password!
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
88
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
89 /who - Lists all users on the chat currently.
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
90
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
91
38
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
92 Installation
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
93 ------------
157
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
94 NNChat requires a curses library, preferably ncurses. It is
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
95 also possible to compile NNChat for Windows via MinGW and use
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
96 PDCurses instead, but this includes certain complexities in
3287901f9b78 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 105
diff changeset
97 build process (see Makefile.w32)
38
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
98
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
99 1) Edit Makefile (optional)
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
100
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
101 2) make / gmake
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
102
Matti Hamalainen <ccr@tnsp.org>
parents: 18
diff changeset
103 3) ./nnchat --help